青龙面板超详细搭建教程（小白篇）

青龙面板（QingLong Panel）是一款基于 Docker 运行的开源定时任务管理工具，可用于自动签到、定时脚本、爬虫任务、通知推送等，特别适合自动化管理任务。本文将手把手教你如何从零搭建青龙面板，并详细说明如何更改端口、安装依赖、管理任务脚本和备份恢复数据。

1. 服务器环境要求

1.1 连接服务器

使用 SSH 连接云服务器（腾讯云、阿里云等）：

ssh root@服务器IP

2. 安装 Docker

青龙面板依赖 Docker 运行，我们需要先安装 Docker。

2.1 一键安装 Docker

curl -fsSL https://get.docker.com | bash

2.2 验证 Docker 是否安装成功

docker -v

如果输出 Docker version 20.10.x，说明安装成功。

3. 安装 Docker Compose

3.1 一键安装 Docker Compose

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

3.2 验证安装

docker-compose -v

4. 一键安装青龙面板

docker run -dit \
  -v $PWD/ql:/ql \
  -p 5700:5700 \
  --name qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

4.1 检查是否运行成功

docker ps

5. 访问青龙面板

在浏览器输入：

https://服务器IP:5700

5.1 首次登录

• 账号： admin
• 密码： 首次访问时会让你设置密码

6. 修改青龙面板端口

6.1 停止并删除原容器

docker stop qinglong
docker rm qinglong

6.2 重新运行并修改端口

docker run -dit \
  -v $PWD/ql:/ql \
  -p 5800:5700 \
  --name qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

7. 添加环境变量

7.1 设置环境变量

• 进入 “环境变量”
• 点击 “新建”
• 填写：
  • 变量名： JD_COOKIE
  • 变量值： 你的京东 Cookie

8. 添加任务脚本

8.1 进入 “任务管理”

• 选择 “新建任务”
• 任务名称： 京东签到
• 定时规则： 30 8 * * *（每天 8:30 运行）
• 执行命令： task jd_sign.js
• 点击 “保存”

9. 更新任务脚本

9.1 手动更新

进入 “脚本管理” -> 点击 “更新”

9.2 自动更新

在 “定时任务” 添加：

ql update

10. 备份 & 迁移青龙面板

10.1 备份数据

tar -czvf ql_backup.tar.gz /ql

10.2 恢复备份

tar -xzvf ql_backup.tar.gz -C /

11. 青龙面板常用命令

12. 总结

🎉 恭喜你，青龙面板搭建完成！ 🚀