From c1a06ad684babbe9c5fd213b833673910e1b8693 Mon Sep 17 00:00:00 2001
From: Jowe <123822645+Selei1983@users.noreply.github.com>
Date: Sat, 10 Jan 2026 21:29:30 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E6=9C=8D=E5=8A=A1?=
 =?UTF-8?q?=E5=99=A8=E9=83=A8=E7=BD=B2=E6=96=87=E6=A1=A3=E5=92=8Cv2.5?=
 =?UTF-8?q?=E9=83=A8=E7=BD=B2=E8=AE=B0=E5=BD=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 DEPLOY_INFO.md | 226 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 226 insertions(+)
 create mode 100644 DEPLOY_INFO.md

diff --git a/DEPLOY_INFO.md b/DEPLOY_INFO.md
new file mode 100644
index 0000000..2860def
--- /dev/null
+++ b/DEPLOY_INFO.md
@@ -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 (待部署)