青龙面板升级后服务无法启动玩客云环境排查【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong执行ql update之后青龙面板 5700 端口不再响应docker ps里容器状态是Exited(1)页面打不开。本文按 Docker 与裸机直接部署两条线从日志、依赖、环境三个方向排查。先确认故障属于哪一类故障表象判断依据跳转锚点容器直接退出docker ps状态为Exited(1)反复拉起反复退出容器状态与日志端口无监听ss -tlnp查不到 5700页面连接超时进程与端口检查页面 502前端能加载API 请求返回 502/504后台未起进程与端口检查任务全部 Failed面板可访问定时任务状态集体失败依赖与运行环境下面按部署方式Docker / 裸机直接部署分两条线展开。 青龙面板 Docker 部署场景容器状态与日志容器退出后面板数据仍保留在宿主机的data/目录里多数情况只需看日志就能判断是启动报错还是配置报错。这条命令看的是容器最近 200 行日志中的错误行以及容器的退出码错误指向EADDRINUSE走端口冲突排查指向配置校验失败查data/config/指向原生模块加载失败则是 Node 版本或镜像架构问题。# 过滤容器最近日志中的错误行 docker logs --tail 200 qinglong 21 | grep -iE error|fail # 查看容器退出码与重启状态 docker ps -a --filter nameqinglong卷挂载与网络配置docker/docker-compose.yml端口映射与卷定义都在这里默认只挂载一处数据卷。如果本机跑了两个青龙容器、两处都指向同一个data目录两个实例会互相覆盖配置和数据库升级后容易出现格式不兼容而启动失败。改端口时只改宿主机侧的 5700容器内实际监听端口要与访问方式一致。volumes: - ./data:/ql/data # 面板数据目录配置与数据库都在这里 ports: - 5700:5700镜像架构匹配玩客云是 ARM 架构官方镜像分whyour/qinglong与whyour/qinglong:debian两个分支package.json中锁定的whyour/sqlite3依赖架构匹配的预编译产物。玩客云 ARM 架构兼容性问题的典型表现就是启动时原生模块加载失败。这条命令看的是当前镜像实际拉到的架构与机器架构不一致时删掉镜像重新拉取。# 查看镜像架构应为 arm 系列 docker image inspect whyour/qinglong:latest --format {{.Architecture}} # 查看本机架构用于对照 uname -m 裸机 / 直接部署场景进程与端口检查直接部署用 pm2 托管进程升级后即使面板显示 online也可能还在跑旧进程或启动中途失败。这条命令看的是 pm2 进程列表和 5700 端口监听情况进程 online 但端口未监听时错误日志在~/.pm2/logs/qinglong-error.log多为依赖加载失败或端口被占用。# 查看 pm2 进程状态qinglong 应为 online pm2 status # 确认 5700 是否被监听 ss -tlnp | grep 5700依赖与运行环境面板固定依赖 pnpm8.3.1Node 主版本过高或过低时sqlite3、grpc/grpc-js这类原生模块会报Cannot find module或NODE_MODULE_VERSION错误。重装依赖后这条命令看的是 sqlite3 原生模块能否被 Node 正常加载能输出 ok 说明依赖层没问题可继续往下查。项目自带的shell/check.sh环境自检与修复脚本会自动做配置检测并重装依赖。# 在面板安装目录重装依赖 npm install -g pnpm8.3.1 pnpm install # 验证 sqlite3 原生模块可加载 node -e require(sqlite3) echo ok权限与目录完整性data/config/config.sh主配置和data/config/auth.json认证配置在升级时会被保留属主或权限不对时启动会静默失败、配置不生效。这条命令看的是数据目录与两个配置文件的属主应与运行面板的用户一致config.sh里的端口值要与实际访问端口一致。# 检查数据目录与配置文件的属主和权限 ls -ld data data/config data/config/config.sh data/config/auth.json升级前后的环境自检这三条命令可定期执行分别检查环境健康度、升级是否真正生效、以及数据是否有备份# 面板自检配置检测、依赖重装、后台健康检查/api/health ./shell/check.sh # 对照 version.yaml 确认当前版本 head -n 3 version.yaml # 升级前备份数据目录配置与任务数据都在这里 cp -r data /path/to/backup/data-$(date %F)数据持久化路径是升级后唯一的恢复来源。Docker 部署时把默认卷从./data指到可备份的存储位置compose 文件里改的就是volumes那一行volumes: - /mnt/sda1/ql/data:/ql/data # 数据放外接存储便于备份仍无法收敛时到青龙面板官方仓库提交 issue附上check.sh与容器日志的完整输出。【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考