青龙面板版本管理稳定版与测试版怎么选更新回滚如何安全做【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong凌晨两点一次更新跑完面板自动重启打开浏览器定时任务列表一片红。事后查明前一天把QL_BRANCH设成了 develop 想尝新功能更新拉下来的测试版代码恰好带个接口 bug。青龙面板的版本管理就是这么回事稳定版和测试版差的不是功能是风险。选版本本质是选风险策略。按使用场景定版本别按哪个新定版本选哪个看你的场景不看版本号大小你的使用场景推荐版本一句话理由跑生产任务签到、领券、告警稳定版master 分支出问题能回滚不会半夜把你叫醒隔离机器上尝新 API、新功能测试版develop 分支周更节奏新东西先到生产不能动又想试新功能稳定版 单独开一个实例另一个端口跑测试版任务互不影响刚部署、还不熟面板稳定版容器镜像构建时默认就是 develop敢改回 master最后一行容易被忽略官方镜像默认构建的就是 develop不是默认稳定。三步完成更新先备份、再执行、后验证一条命令搞定更新前备份与状态检查tar -zcvf ~/ql-backup-$(date %F).tgz -C /ql data/db data/upload ql check⚠️ 第一条把数据库和上传目录打包任务、环境变量、日志配置全在data/db/ql.db里看到文件清单输出即备份成功第二条检测青龙环境并修复没有红色报错再往下走。备份这一步后面回退全靠它。更新命令两条路命令行与图形界面命令行最直接ql update # 更新并重启 ql update false # 只更新不重启shell/update.sh 依次做检测网络 → 选镜像源默认国内源能直连外网就切到 GitHub 源→ 按当前分支下载代码包和静态资源 → 有package.json变更才装依赖 → 重启 pm2。看到更新青龙源文件成功和依赖检测安装成功两行这次更新就算成了。想切测试版差异只在一行# 在 .env 里加 QL_BRANCHdevelop然后 ql update脚本发现QL_BRANCH是 develop或 debian 系列就拉对应分支的代码。切回稳定版同理改回 master 再跑一次。图形界面给不想碰终端的人登录后进【系统设置】点检查更新。src/pages/setting/checkUpdate.tsx 里的逻辑是拿本地版本号对比远端最新version.yaml有新版本就把更新日志摆给你看点下载更新后日志通过 WebSocket 实时刷在弹窗里下载完弹确认重启确认后页面 30 秒后自动刷新。和ql update false是同一条路只是包了层壳。更新后验证与回退预案ql log看最近 15 行系统日志没有红色报错、面板能登录、任务列表条数没少✅ 这单收工。真翻车了回退就三步.env里QL_BRANCH改回 master → 跑一次ql update重新拉稳定版代码覆盖 → 数据层面不对劲的话到【系统设置】导入更新前打的 tar 备份包。青龙没有一键回滚按钮但这套组合拳够用了。进阶配置生产环境跑稳了才需要看QL_BRANCH决定拉哪个分支master 稳定版、develop/debian 测试版写在.env重启生效。镜像源不用管更新脚本按网络状况自动在两个源之间切换公司内网受限就在config/config.sh里配ProxyUrl。依赖源【系统设置】里能单独切 pnpm、pip 和 Linux 软件包源国内环境装依赖慢时再动它。翻车急救看现象、找原因、跑命令更新失败提示请检查网络大概率镜像源没切对或者磁盘满了。df -h /ql ql update磁盘有富余就直接重跑脚本会重新选源还报ENOTFOUND就先查代理配置把ProxyUrl临时置空再试。更新后面板打不开5700 端口没响应pm2 进程没拉起来。pm2 restart qinglong pm2 list状态变成 online 就好不用重新部署。切完测试版任务集体挂掉新版接口变了、任务代码没跟上别慌直接回版本QL_BRANCH改回 master重跑ql update。数据层面还有异常的导入更新前的备份包。报EACCES、权限不足确认你是 root 在跑宿主机部署时看/ql是不是被别的用户建过目录容器部署则确认没有把宿主目录以错误权限挂进容器。生产锁稳定尝鲜走测试备份是保命绳。下次敲ql update之前先把那条 tar 备份命令跑了——翻车不可怕没备份才可怕。【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
