## 前言
青龙面板是一款开源的定时任务管理平台，可以自动执行各种定时脚本——签到、领券、推送消息，全自动运行！本教程用Docker一键部署，零基础也能搞定。
## 一、Docker环境准备
### 1.1 安装Docker
Linux一键安装：
curl -fsSL https://get.docker.com | sh
sudo systemctl start docker
sudo systemctl enable docker
Windows/Mac安装Docker Desktop：https://www.docker.com/products/docker-desktop/
### 1.2 配置国内镜像加速
Docker Desktop → Settings → Docker Engine：
{
“registry-mirrors”: [
“https://docker.1panel.live”,
“https://hub.rat.dev”,
“https://docker.m.daocloud.io”
]
}
## 二、部署青龙面板
### 方式1：Docker Run（最简）
docker run -dit -v $PWD/ql/data:/ql/data -p 5700:5700 -e QlBaseUrl=”/” –name qinglong –restart unless-stopped whyour/qinglong:latest
### 方式2：Docker Compose（推荐）
创建 docker-compose.yml：
version: ‘2’
services:
qinglong:
image: whyour/qinglong:latest
container_name: qinglong
volumes:
– ./data:/ql/data
ports:
– “5700:5700”
environment:
QlBaseUrl: ‘/’
restart: unless-stopped
启动：docker compose up -d
## 三、初始化青龙面板
1. 浏览器访问 http://IP:5700
2. 设置管理员账号密码
3. 选择通知方式（可跳过）
## 四、添加定时任务
1. 登录后台 → 定时任务 → 添加任务
2. 输入任务名称
3. 粘贴脚本命令
4. 设置cron表达式（如 0 8 * * * 表示每天8点执行）
5. 启用任务
## 五、安装依赖
部分脚本需要额外依赖，在面板中操作：
Python依赖：在依赖管理中搜索安装，或执行：
docker exec -it qinglong pip3 install 包名
Node.js依赖：
docker exec -it qinglong pnpm install 包名
## 六、常见报错解决
| 报错 | 原因 | 解决方案 |
|——|——|———|
| 5700端口无法访问 | 防火墙未放行 | 开放5700端口 |
| Cannot find module | Node依赖缺失 | docker exec -it qinglong pnpm install xxx |
| No module named | Python依赖缺失 | docker exec -it qinglong pip3 install xxx |
| 登录被锁定 | 多次输错密码 | docker exec -it qinglong ql resetlet |
| 白屏或502 | 容器未完全启动 | 等待1-2分钟或docker restart qinglong |
| 容器自动停止 | 内存不足 | 至少保证2GB可用内存 |
## 七、避坑总结
1. 数据目录一定要挂载，不然容器重建数据全丢
2. 先安装好依赖再跑脚本，不然全报错
3. 密码别太简单，容易被扫到
4. 定时任务不要设置太频繁，避免触发限制
5. 建议用Docker Compose部署，方便管理
本教程由技术保姆网原创，转载请注明出处。