一、环境准备与依赖安装
安装前需确保云服务器满足以下条件：操作系统推荐使用Debian或Ubuntu（CentOS存在Docker版本兼容性问题），内存建议2GB以上，并完成系统更新：
yum update -y # CentOS
apt update && apt upgrade -y # Debian/Ubuntu关键依赖包括Docker及Node.js环境：
- 安装Docker：使用官方脚本
curl -fsSL https://get.docker.com | bash - 配置镜像加速：修改
/etc/docker/daemon.json添加国内镜像源 - 安装Node.js：通过宝塔面板或命令行安装v14+版本
二、青龙面板安装步骤
推荐通过Docker容器化部署，执行以下命令完成安装：
docker run -dit \
-v $PWD/ql/data:/ql/data \
-p 5700:5700 \
--name qinglong \
--hostname qinglong \
--restart unless-stopped \
whyour/qinglong:latest安装完成后通过http://服务器IP:5700访问面板。若使用宝塔面板，需在安全组放行5700端口并配置反向代理。
三、常见问题与解决方案
- 依赖安装失败：进入容器执行
npm install crypto-js等命令手动安装 - 端口冲突：修改
-p 新端口:5700参数重新创建容器 - 镜像拉取超时：更换为
ghcr.io/whyour/qinglong:latest镜像源 - 定时任务不执行：检查系统时区设置与cron服务状态
四、后续配置优化建议
建议完成以下配置提升使用体验：
- 配置域名HTTPS访问，通过宝塔面板申请SSL证书
- 设置定期自动备份
/ql/data目录 - 添加多仓库同步功能，使用
ql repo命令管理脚本源
| 功能 | 命令 |
|---|---|
| 更新面板 | docker exec -it qinglong ql update |
| 查看日志 | docker logs -f qinglong |
通过Docker容器化部署可快速搭建青龙面板环境，配合宝塔面板可简化运维管理。安装过程中需特别注意系统兼容性、端口配置及依赖完整性，定期维护可保障脚本任务稳定运行。
