227 lines
4.7 KiB
Markdown
227 lines
4.7 KiB
Markdown
# ZJPB 服务器部署信息
|
||
|
||
**文档版本**: v1.0
|
||
**创建日期**: 2026-01-10
|
||
**最后更新**: 2026-01-10
|
||
|
||
---
|
||
|
||
## 📋 服务器信息
|
||
|
||
### 基本信息
|
||
- **服务器管理**: 1Panel
|
||
- **项目目录**: `/opt/1panel/apps/zjpb#`
|
||
- **Git仓库**: `http://server.zjpb.net:3000/jowelin/zjpb.git`
|
||
- **服务器地址**: `server.zjpb.net` (待确认)
|
||
- **SSH端口**: 22 (待确认)
|
||
- **SSH用户**: (待确认)
|
||
|
||
### 项目信息
|
||
- **项目类型**: Flask Python应用
|
||
- **Python版本**: (待确认)
|
||
- **虚拟环境**: (待确认，通常在 `venv/` 目录)
|
||
- **主程序**: `app.py`
|
||
- **配置文件**: `.env`
|
||
|
||
### 1Panel 相关
|
||
- **应用名称**: zjpb
|
||
- **网站管理**: 通过1Panel Web界面
|
||
- **服务控制**: 1Panel自动管理或通过supervisord/systemd
|
||
|
||
---
|
||
|
||
## 🚀 部署流程
|
||
|
||
### 准备工作
|
||
1. SSH连接到服务器
|
||
2. 切换到项目目录：`cd /opt/1panel/apps/zjpb#`
|
||
3. 备份当前版本（可选但推荐）
|
||
|
||
### 标准部署步骤
|
||
|
||
#### 1. 拉取最新代码
|
||
```bash
|
||
# 进入项目目录
|
||
cd /opt/1panel/apps/zjpb#
|
||
|
||
# 查看当前状态
|
||
git status
|
||
|
||
# 拉取最新代码
|
||
git pull origin master
|
||
|
||
# 查看最新提交
|
||
git log --oneline -3
|
||
```
|
||
|
||
#### 2. 检查依赖更新
|
||
```bash
|
||
# 如果有新的Python依赖
|
||
pip install -r requirements.txt
|
||
|
||
# 或者如果使用虚拟环境
|
||
source venv/bin/activate
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
#### 3. 数据库迁移（如果需要）
|
||
```bash
|
||
# v2.5 不需要数据库迁移
|
||
# 如果未来版本有数据库变更，在此执行迁移脚本
|
||
```
|
||
|
||
#### 4. 重启应用
|
||
|
||
**方式一：通过1Panel Web界面**
|
||
1. 登录1Panel管理面板
|
||
2. 找到 "网站" 或 "应用" 菜单
|
||
3. 找到 zjpb 项目
|
||
4. 点击"重启"按钮
|
||
|
||
**方式二：通过命令行（需要确认具体方式）**
|
||
```bash
|
||
# 如果使用supervisorctl
|
||
sudo supervisorctl restart zjpb
|
||
|
||
# 或者如果使用systemd
|
||
sudo systemctl restart zjpb
|
||
|
||
# 或者如果1Panel使用Docker
|
||
docker restart zjpb
|
||
|
||
# 或者手动重启（需要先找到进程）
|
||
ps aux | grep app.py
|
||
kill -HUP <PID>
|
||
```
|
||
|
||
#### 5. 验证部署
|
||
```bash
|
||
# 查看应用日志
|
||
tail -f logs/error.log
|
||
# 或
|
||
journalctl -u zjpb -f
|
||
|
||
# 检查应用是否运行
|
||
ps aux | grep app.py
|
||
|
||
# 测试网站访问
|
||
curl http://localhost:5000
|
||
```
|
||
|
||
### 快速部署命令（一键执行）
|
||
```bash
|
||
cd /opt/1panel/apps/zjpb# && \
|
||
git pull origin master && \
|
||
echo "代码拉取完成，请通过1Panel重启应用"
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 部署记录
|
||
|
||
### v2.5.1 (修复版) - 2026-01-10
|
||
- **Commit**: `22efd8b`
|
||
- **功能**: 修复标签页description为空时的TypeError
|
||
- **部署状态**: ✅ 已部署成功
|
||
- **操作人**: root
|
||
- **部署时间**: 2026-01-10 18:30
|
||
- **备注**: 修复首次部署v2.5时发现的502错误
|
||
|
||
### v2.5 - 2026-01-10
|
||
- **Commit**: `e71230c`
|
||
- **功能**: 社媒分享功能 + 面包屑优化
|
||
- **部署状态**: ⚠️ 已回滚（存在bug）
|
||
- **操作人**: root
|
||
- **部署时间**: 2026-01-10 18:22
|
||
- **备注**:
|
||
- 新增社媒分享功能（8个平台：通用、小红书、抖音、B站、微信、朋友圈、X、LinkedIn）
|
||
- 面包屑导航优化，修复折行问题
|
||
- 首次部署后发现index_new.html模板bug，已紧急回滚
|
||
- bug已修复并重新部署为v2.5.1
|
||
|
||
### v2.4.1 - 2026-01-04
|
||
- **Commit**: `8011e5b`
|
||
- **功能**: 最新/热门/推荐标签功能
|
||
- **部署状态**: 已部署
|
||
- **数据库变更**: 添加 `is_recommended` 字段
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
### 部署前检查
|
||
- [ ] 确认本地测试通过
|
||
- [ ] 检查 `.env` 配置文件是否需要更新
|
||
- [ ] 确认数据库备份（如有数据库变更）
|
||
- [ ] 检查依赖包是否有更新
|
||
|
||
### 部署后验证
|
||
- [ ] 网站可以正常访问
|
||
- [ ] 新功能工作正常
|
||
- [ ] 检查错误日志无异常
|
||
- [ ] 测试关键功能（登录、搜索、详情页等）
|
||
|
||
### 回滚方案
|
||
如果部署出现问题，可以快速回滚到上一版本：
|
||
```bash
|
||
# 回滚到上一个提交
|
||
git reset --hard HEAD^
|
||
# 或者回滚到指定版本
|
||
git reset --hard 8011e5b
|
||
|
||
# 重启应用
|
||
# (使用上述重启命令)
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 故障排查
|
||
|
||
### 常见问题
|
||
|
||
**1. 代码拉取失败**
|
||
```bash
|
||
# 检查git状态
|
||
git status
|
||
|
||
# 如果有本地修改冲突
|
||
git stash
|
||
git pull origin master
|
||
git stash pop
|
||
```
|
||
|
||
**2. 应用无法启动**
|
||
```bash
|
||
# 查看错误日志
|
||
tail -100 logs/error.log
|
||
|
||
# 检查Python环境
|
||
python --version
|
||
which python
|
||
|
||
# 检查端口占用
|
||
netstat -tlnp | grep 5000
|
||
```
|
||
|
||
**3. 数据库连接失败**
|
||
```bash
|
||
# 检查 .env 配置
|
||
cat .env | grep DATABASE
|
||
|
||
# 测试数据库连接
|
||
mysql -h localhost -u root -p
|
||
```
|
||
|
||
---
|
||
|
||
## 📞 联系信息
|
||
|
||
- **开发者**: Claude Code
|
||
- **项目仓库**: http://server.zjpb.net:3000/jowelin/zjpb
|
||
- **文档更新**: 每次部署后更新此文档
|
||
|
||
---
|
||
|
||
**最后更新**: 2026-01-10
|
||
**当前版本**: v2.5 (待部署)
|