青龙面板版本控制实战指南：从环境隔离到无缝切换

青龙面板版本控制实战指南：从环境隔离到无缝切换

【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台（Timed task management platform supporting Python3, JavaScript, Shell, Typescript）项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong

版本选择决策指南

生产环境适用场景

• 核心业务运行：依赖定时任务执行关键操作（如数据同步、报表生成）
• 稳定性优先：每月更新周期，安全补丁自动合并
• 低维护成本：最小化版本变更带来的配置调整

测试环境适用场景

• 功能验证：提前体验新特性（如脚本依赖管理优化）
• 兼容性测试：验证自定义脚本在新版本中的运行情况
• 开发调试：参与功能改进反馈，协助官方定位问题

环境准备与配置

基础环境检查

# 检查当前版本信息 cat version.yaml # 验证Node.js环境 node -v && npm -v # 确认PM2进程状态 pm2 list | grep qinglong

环境变量配置

修改back/config/serverEnv.ts设置版本偏好：

// 版本分支配置（stable/beta/develop） process.env.QL_BRANCH = "stable"; // 镜像源配置（国内推荐使用gitee） process.env.MIRROR = "gitee";

稳定版管理流程

标准更新步骤

1. 执行内置更新脚本

bash shell/update.sh stable

2. 脚本执行流程解析

   • 网络连通性检测
   • 最新稳定版代码包下载
   • 依赖自动安装与冲突处理
   • 服务平滑重启

3. 验证更新结果

# 查看更新日志 tail -n 50 logs/update.log # 确认服务状态 pm2 status qinglong

紧急回滚操作

当更新后出现异常时：

# 执行备份恢复 bash shell/backup.sh restore # 清除运行时缓存 rm -rf data/cache/* # 强制重启服务 pm2 restart qinglong

测试版体验指南

命令行切换方式

# 切换至测试分支并更新 bash shell/update.sh beta

图形化操作流程

1. 登录青龙面板后台
2. 进入【系统设置】→【版本管理】
3. 启用"测试版更新通道"
4. 点击"检查更新"按钮
5. 确认变更日志后执行更新

测试版特性验证

// 前端检查更新API调用示例 request .put(`${config.apiPrefix}system/update-check`) .then(({ code, data }) => { if (data.hasNewVersion) { showUpdateDialog(data); // 展示更新详情对话框 } })

实操场景说明

场景一：生产环境安全更新

1. 执行预更新检查：bash shell/check.sh
2. 备份当前配置：bash shell/backup.sh
3. 执行稳定版更新：bash shell/update.sh stable
4. 观察15分钟任务执行情况
5. 确认无异常后完成更新

场景二：测试版功能验证

1. 在隔离环境克隆项目：

git clone https://gitcode.com/GitHub_Trending/qi/qinglong test-ql cd test-ql && bash shell/update.sh beta

2. 部署测试任务集
3. 执行功能测试用例
4. 记录兼容性问题并反馈
5. 测试完成后清理环境

常见问题处理

依赖冲突解决

# 清除npm缓存 npm cache clean --force # 重新安装依赖 rm -rf node_modules && npm install

版本切换后任务异常

1. 检查任务日志定位错误点：cat logs/task/*.log
2. 确认Node.js版本兼容性
3. 执行数据库迁移修复：node back/db/migrate.js
4. 重启服务使配置生效：pm2 restart qinglong

版本管理最佳实践清单

• 定期备份：每周执行bash shell/backup.sh
• 环境隔离：测试版与稳定版使用独立部署目录
• 变更记录：维护版本更新日志，记录关键变更点
• 灰度更新：重要环境先在小范围验证更新效果
• 依赖锁定：使用pnpm-lock.yaml固定依赖版本
• 监控告警：配置服务健康检查与异常通知
• 回滚预案：建立版本回滚操作手册与验证流程
• 定期清理：删除30天前的更新缓存与日志文件

【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台（Timed task management platform supporting Python3, JavaScript, Shell, Typescript）项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong