Files

Jowe 2e9f634caa docs: 添加v2.2.0部署文档和脚本

- v2.2.0.patch: Git补丁文件（56KB）
- git_patch_deploy_v2.2.sh: 自动化部署脚本
- DEPLOY_v2.2.0.md: 完整部署指南
- DEPLOY_v2.2_CHECKLIST.md: 部署检查清单

2025-12-30 22:34:24 +08:00

5.5 KiB

Raw Blame History

v2.2.0 部署检查清单

部署前准备

1. 本地文件准备

v2.2.0.patch (56KB) - 已生成
git_patch_deploy_v2.2.sh - 已创建
DEPLOY_v2.2.0.md - 完整部署文档
migrate_news_fields.py - 数据库迁移脚本

2. 备份（重要！）

生产数据库已备份

# 在1Panel中备份或执行
mysqldump -h 112.124.42.38 -u ai_nav -p ai_nav > backup_v2.2_$(date +%Y%m%d).sql

代码已备份（Git会自动保存）

3. 环境检查

服务器可以访问 api.bocha.cn
Python 3.8+ 已安装
虚拟环境已创建
Git已配置

部署步骤

步骤1：上传文件

上传以下2个文件到 /opt/1panel/apps/zjpb/：

v2.2.0.patch
git_patch_deploy_v2.2.sh

使用1Panel文件管理器或SCP命令：

scp v2.2.0.patch root@your-server:/opt/1panel/apps/zjpb/
scp git_patch_deploy_v2.2.sh root@your-server:/opt/1panel/apps/zjpb/

步骤2：执行部署

cd /opt/1panel/apps/zjpb
chmod +x git_patch_deploy_v2.2.sh
./git_patch_deploy_v2.2.sh

步骤3：配置API Key

编辑.env文件，添加博查API配置：

nano /opt/1panel/apps/zjpb/.env

添加：

BOCHA_API_KEY=sk-76d0236a50d445ae92e75b634ed5313c
BOCHA_BASE_URL=https://api.bocha.cn

步骤4：重启应用

cd /opt/1panel/apps/zjpb
./manage.sh restart

部署验证

前台验证

访问首页正常
访问网站详情页正常
"相关新闻"模块显示（首次访问会触发获取）
新闻可以点击查看原文
"相似推荐"在右侧边栏显示

后台验证

登录后台成功 /admin/login
进入"新闻管理" /admin/newsadmin/
可以看到新闻列表（如果已有新闻）
新闻列表显示source_name和source_icon

数据库验证

-- 检查news表新字段
DESCRIBE news;
-- 应该看到：
-- source_name VARCHAR(100)
-- source_icon VARCHAR(500)

功能测试

访问一个网站详情页，检查是否自动获取新闻
刷新页面，新闻应该不会重复获取（使用缓存）
第二天首次访问，应该会更新新闻

部署后检查

日志检查

cd /opt/1panel/apps/zjpb
./manage.sh logs

检查是否有错误信息：

没有Python异常
没有数据库错误
没有API调用错误

Git状态

git log --oneline -3

应该看到v2.2.0的提交：

release: v2.2.0 相关的提交记录

应用状态

./manage.sh status

zjpb 正在运行
进程PID正常

问题排查

1. 新闻不显示

可能原因：

BOCHA_API_KEY未配置或配置错误
API余额不足
网站没有相关新闻

排查步骤：

# 测试API配置
cd /opt/1panel/apps/zjpb
source venv/bin/activate
python test_news_feature.py

# 检查环境变量
cat .env | grep BOCHA

# 查看日志
./manage.sh logs | grep -i "news\|bocha"

2. 数据库迁移失败

症状：字段不存在错误

解决方案：

cd /opt/1panel/apps/zjpb
source venv/bin/activate
python migrate_news_fields.py

3. 补丁应用失败

症状：git apply报错