青龙面板（QingLong Panel）是一款基于 Docker 运行的开源定时任务管理工具，可用于自动签到、定时脚本、爬虫任务、通知推送等，特别适合自动化管理任务。本文将手把手教你如何从零搭建青龙面板，并详细说明如何更改端口、安装依赖、管理任务脚本和备份恢复数据。
1. 服务器环境要求
配置
推荐
系统
Debian 10+/Ubuntu 20+/CentOS 7+
CPU
1 核或以上
内存
1GB 以上（推荐 2GB+）
硬盘
至少 10GB
网络
服务器需开放 5700 端口（可修改）
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. 青龙面板常用命令
命令
作用
docker start qinglong
启动青龙面板
docker stop qinglong
停止青龙面板
docker restart qinglong
重启青龙面板
docker logs -f qinglong
查看日志
docker exec -it qinglong bash
进入青龙容器
docker rm -f qinglong
删除青龙容器
12. 总结
步骤
命令/操作
安装 Docker
curl -fsSL https://get.docker.com | bash
安装 Docker Compose
curl -L ... -o /usr/local/bin/docker-compose
拉取青龙面板
docker run -dit -v ... -p 5700:5700 --name qinglong whyour/qinglong:latest
访问面板
https://服务器IP:5700
修改端口
-p 5800:5700
添加定时任务
进入 “定时任务” -> “新建任务”
更新脚本
ql update
备份数据
tar -czvf ql_backup.tar.gz /ql
🎉 恭喜你，青龙面板搭建完成！ 🚀