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