docs: 添加服务器部署文档和v2.5部署记录
This commit is contained in:
Jowe
226
DEPLOY_INFO.md
Normal file
226
DEPLOY_INFO.md
Normal file
@@ -0,0 +1,226 @@
|
||||
# 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 (待部署)
|
||||
Reference in New Issue
Block a user