企业官网建设流程全解析

青龙面板升级后连不上、任务全停？2025 玩客云环境这样排查最快

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

玩客云上的青龙面板（一个跑 Python、JS、Shell 定时任务的管理平台）升级完打不开、定时任务集体不跑，多半不是坏了，而是启动时某个环节卡住了。下面按"先判断卡在哪 → 再看日志 → 最后一条命令修回来"的思路走一遍，基本能救回绝大多数情况。

白屏还是任务不跑，先分清是哪个环节卡了

🔍 青龙起来其实是两部分：前端页面（浏览器能打开）和后台服务（真正调度任务的）。你可以用这两条命令自己探一下，不用猜：

# 探前端：能返回带 root 的页面说明页面起来了 curl -s http://localhost:5700/ | grep -o 'id="root"' # 探后台：返回 "code":200 说明调度服务正常 curl -s http://localhost:5700/api/health

页面打不开是前端或端口的事；页面能进但任务不跑，多半是后台服务没起来。分清楚，后面就不用瞎试。

日志里这几个词最值钱

• 裸机部署：翻data/log/目录，升级过程日志在data/log/update/下按时间戳命名，重点找带Error、Failed、Cannot find module的行。
• Docker 部署：PM2 的日志不落盘，早期启动错误得看容器，直接跑docker-compose logs --tail 300，别去容器里找日志文件，那是空的。

看到Cannot find module这种，基本就是依赖没装全，往下看。

一条 check.sh 把配置和依赖一起修回来

✅ 不用手动一个个补文件，官方自带环境自检脚本 shell/check.sh。它会依次做四件事：检测并修复配置（data/config/config.sh、data/config/auth.json都在data/config/下）、重装项目依赖、补齐通知文件、重启服务并自检面板和后台，最后直接打印"启动正常"还是"启动异常"。

裸机部署进项目目录敲：

./shell/check.sh # 检测配置 + 重装依赖 + 重启 + 自检

Docker 部署就进容器跑同一条（服务名以 docker/docker-compose.yml 里volumes: ./data:/ql/data挂载的为准，数据都在data/里，容器删了也不怕）。它内部装依赖用的是pnpm install --production，所以不用自己去敲npm install，交给脚本即可。

改完之后确认真的好了

check.sh跑完自带结论：看到"面板服务启动正常"和"后台服务启动正常"两行，再回到浏览器打开5700端口、看一次任务是否正常触发，就算修好了。Docker 环境如果还是起不来，先docker-compose ps看容器是否running，再docker-compose restart重启，别急着重装系统。

升级前养成一个习惯：进面板记一下当前版本（见 version.yaml），升级前把data/config/拷一份到别处，出问题能原样放回去，比事后救火省心。

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