王少冬1. 为什么选择宝塔+Docker部署青龙面板？
青龙面板作为一款开源的定时任务管理工具，在脚本自动化领域广受欢迎。而宝塔面板的图形化操作界面极大降低了Linux服务器管理的门槛。将二者结合使用，既能享受Docker带来的环境隔离优势，又能通过宝塔简化部署流程。这种组合方案特别适合以下场景：
- 需要管理多个定时脚本但不想手动配置crontab
- 希望用可视化方式管理Docker容器
- 服务器资源有限需要轻量级解决方案
- 快速搭建测试环境进行脚本调试
注意：虽然本文以CentOS 7.6为例，但方法同样适用于其他Linux发行版，只需注意包管理命令的差异（如apt-get/yum）。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础环境准备
2.1 服务器基础配置建议
在开始安装前，建议服务器满足以下配置：
- 系统：CentOS 7.6/Ubuntu 18.04+（本文以CentOS 7.6演示）
- 内存：≥1GB（2GB以上更佳）
- 磁盘：≥20GB可用空间
- 网络：能正常访问GitHub和Docker Hub
通过以下命令更新系统并安装基础工具包：
bash复制yum update -y && yum install -y wget curl vim
2.2 安装最新版宝塔面板
执行官方一键安装命令（会自动适配CentOS/Ubuntu）：
bash复制curl -sSO http://download.bt.cn/install/install_panel.sh && bash install_panel.sh
安装完成后会显示面板地址和初始账号密码，务必妥善保存。首次登录后会提示选择安装套件，建议勾选：
- Nginx 1.20+
- Docker管理器（必须）
- 其他按需选择
实测经验：安装完成后建议立即在面板设置中修改默认端口（8888）和强化密码策略，这是很多新手容易忽略的安全措施。
3. Docker环境配置
3.1 解决常见Docker安装问题
如果在宝塔中安装Docker时遇到"virtualisation support not detected"错误，通常是因为：
- 未启用VT虚拟化（需进BIOS设置）
- 系统未加载kvm模块
检查虚拟化支持状态：
bash复制lsmod | grep kvm
# 若无输出则需加载模块
modprobe kvm_intel # Intel CPU
# 或 modprobe kvm_amd # AMD CPU
3.2 配置国内镜像加速
编辑或创建/etc/docker/daemon.json：
json复制{
"registry-mirrors": [
"https://hub-mirror.c.163.com",
"https://mirror.baidubce.com"
]
}
重启Docker服务：
bash复制systemctl restart docker
4. 青龙面板安装实战
4.1 通过宝塔部署容器
- 打开宝塔面板 → Docker → 容器 → 创建容器
- 填写以下参数：
- 镜像：whyour/qinglong:latest
- 端口映射：5700:5700
- 目录映射：
- /root/ql/data → /ql/data
- /root/ql/config → /ql/config
- 环境变量：
- ENABLE_HANGUP=true
- ENABLE_WEB_PANEL=true
避坑提示：目录映射建议使用绝对路径，避免权限问题。我曾在测试中使用相对路径导致容器无法写入数据。
4.2 初始化配置
容器启动后访问：
code复制http://服务器IP:5700
首次进入会要求：
- 设置管理员账号
- 选择语言（推荐中文）
- 配置通知方式（可选）
4.3 依赖管理技巧
青龙面板运行脚本常需要额外依赖，推荐通过Dockerfile定制镜像：
dockerfile复制FROM whyour/qinglong:latest
RUN apk add --no-cache python3 py3-pip \
&& pip3 install requests bs4
构建并运行新镜像：
bash复制docker build -t custom_ql .
docker run -d --name qinglong -p 5700:5700 -v /root/ql/data:/ql/data custom_ql
5. 进阶配置与优化
5.1 通过Nginx反代
在宝塔面板操作：
- 网站 → 添加站点（填写域名）
- 设置 → 反向代理 → 添加代理
- 目标URL：http://127.0.0.1:5700
- 高级配置中添加：
code复制proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
5.2 自动化备份方案
创建备份脚本/root/ql_backup.sh：
bash复制#!/bin/bash
DATE=$(date +%Y%m%d)
tar -czvf /backup/ql_${DATE}.tar.gz /root/ql/data
docker exec qinglong /bin/sh -c "cd /ql && tar -czvf /ql/backup_${DATE}.tar.gz scripts"
添加到crontab（每天3点执行）：
bash复制0 3 * * * /bin/bash /root/ql_backup.sh
6. 常见问题排查指南
6.1 容器启动失败排查
查看容器日志：
bash复制docker logs qinglong --tail 100
常见错误及解决方案：
- 端口冲突：修改映射端口（如5800:5700）
- 权限不足：给映射目录赋权（chmod 777 -R /root/ql）
- 镜像拉取失败：更换Docker镜像源
6.2 网络连接问题
如果脚本需要访问外部API：
- 检查容器网络模式（建议用host模式）
bash复制
docker run --network host ... - 在防火墙放行相关端口
bash复制
firewall-cmd --zone=public --add-port=5700/tcp --permanent firewall-cmd --reload
7. 安全加固建议
-
定期更新镜像：
bash复制docker pull whyour/qinglong:latest docker stop qinglong && docker rm qinglong # 重新创建容器（保留原有参数） -
访问控制：
- 在宝塔面板设置IP访问限制
- 修改青龙面板默认路径（通过Nginx location配置）
-
资源监控：
bash复制
docker stats qinglong建议设置容器资源限制（在宝塔创建容器时可配置CPU/内存限制）
我在实际使用中发现，将青龙面板的日志目录映射到外部后，可以用ELK等工具实现更专业的日志分析。另外对于需要执行Python脚本的场景，建议在容器内安装虚拟环境避免依赖冲突。