jowelin/zjpb.net

Fork 0

Files

Jowe c1a06ad684 docs: 添加服务器部署文档和v2.5部署记录

2026-01-10 21:29:30 +08:00

4.7 KiB

Raw Blame History

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

🚀 部署流程

准备工作

SSH连接到服务器
切换到项目目录：cd /opt/1panel/apps/zjpb#
备份当前版本（可选但推荐）

标准部署步骤

1. 拉取最新代码

# 进入项目目录
cd /opt/1panel/apps/zjpb#

# 查看当前状态
git status

# 拉取最新代码
git pull origin master

# 查看最新提交
git log --oneline -3

2. 检查依赖更新

# 如果有新的Python依赖
pip install -r requirements.txt

# 或者如果使用虚拟环境
source venv/bin/activate
pip install -r requirements.txt

3. 数据库迁移（如果需要）

# v2.5 不需要数据库迁移
# 如果未来版本有数据库变更，在此执行迁移脚本

4. 重启应用

方式一：通过1Panel Web界面

登录1Panel管理面板
找到 "网站" 或 "应用" 菜单
找到 zjpb 项目
点击"重启"按钮

方式二：通过命令行（需要确认具体方式）

# 如果使用supervisorctl
sudo supervisorctl restart zjpb

# 或者如果使用systemd
sudo systemctl restart zjpb

# 或者如果1Panel使用Docker
docker restart zjpb

# 或者手动重启（需要先找到进程）
ps aux | grep app.py
kill -HUP <PID>

5. 验证部署

# 查看应用日志
tail -f logs/error.log
# 或
journalctl -u zjpb -f

# 检查应用是否运行
ps aux | grep app.py

# 测试网站访问
curl http://localhost:5000

快速部署命令（一键执行）

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 配置文件是否需要更新
确认数据库备份（如有数据库变更）
检查依赖包是否有更新

部署后验证

网站可以正常访问
新功能工作正常
检查错误日志无异常
测试关键功能（登录、搜索、详情页等）

回滚方案

如果部署出现问题，可以快速回滚到上一版本：

# 回滚到上一个提交
git reset --hard HEAD^
# 或者回滚到指定版本
git reset --hard 8011e5b

# 重启应用
# (使用上述重启命令)

🔧 故障排查

常见问题

1. 代码拉取失败

# 检查git状态
git status

# 如果有本地修改冲突
git stash
git pull origin master
git stash pop

2. 应用无法启动

# 查看错误日志
tail -100 logs/error.log

# 检查Python环境
python --version
which python

# 检查端口占用
netstat -tlnp | grep 5000

3. 数据库连接失败

# 检查 .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 (待部署)

4.7 KiB Raw Blame History Unescape Escape