1. 项目背景与核心价值青龙面板作为一款开源的定时任务管理工具在开发者社区中广受欢迎。它支持JavaScript、Python等脚本语言能够自动化执行各类定时任务比如数据抓取、自动化测试、服务器维护等。而宝塔面板则是国内开发者熟知的服务器运维管理工具提供可视化的Web界面来管理服务器。将青龙面板部署在Docker环境中再通过宝塔面板进行管理这种组合方案具有以下优势环境隔离Docker容器化部署避免污染主机环境便捷管理宝塔提供友好的Web操作界面资源可控可以限制容器资源使用量快速迁移Docker镜像便于在不同环境部署2. 环境准备与前置条件2.1 服务器基础环境要求建议使用CentOS 7.6或以上版本的操作系统配置要求内存至少2GB推荐4GB存储20GB以上可用空间网络稳定的互联网连接注意如果使用云服务器请确保安全组已开放以下端口宝塔面板默认端口8888青龙面板默认端口5700SSH端口222.2 宝塔面板安装与配置如果尚未安装宝塔面板可以通过以下命令快速安装yum install -y wget wget -O install.sh http://download.bt.cn/install/install_6.0.sh sh install.sh安装完成后记录面板的登录地址、用户名和密码。首次登录后建议修改默认端口和密码安装必要的软件Nginx、Docker配置防火墙规则3. Docker环境部署3.1 Docker安装与验证在宝塔面板的软件商店中搜索Docker点击安装。或者通过SSH执行curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun systemctl start docker systemctl enable docker验证安装是否成功docker --version docker run hello-world3.2 配置Docker镜像加速国内用户建议配置镜像加速以提升拉取速度mkdir -p /etc/docker tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://registry.docker-cn.com] } EOF systemctl daemon-reload systemctl restart docker4. 青龙面板安装与配置4.1 拉取青龙面板镜像使用官方镜像docker pull whyour/qinglong:latest4.2 创建数据卷为了保证数据持久化建议创建数据卷docker volume create qinglong_data4.3 运行青龙容器docker run -dit \ --name qinglong \ --hostname qinglong \ --restart unless-stopped \ -p 5700:5700 \ -v qinglong_data:/ql/data \ -v /etc/localtime:/etc/localtime:ro \ whyour/qinglong:latest参数说明-p 5700:5700将容器5700端口映射到主机-v qinglong_data:/ql/data挂载数据卷--restart unless-stopped设置自动重启4.4 通过宝塔管理容器在宝塔面板的Docker管理界面中点击容器列表找到qinglong容器可以查看日志、控制启停等5. 青龙面板初始化设置5.1 访问面板在浏览器访问http://服务器IP:5700首次访问会进入初始化向导设置管理员账号和密码配置通知方式可选完成基础设置5.2 配置依赖管理青龙面板支持多种脚本语言需要安装对应依赖进入依赖管理页面选择对应的依赖分类Python/Node.js等点击安装按钮常用依赖示例Python: requests, bs4, pytzNode.js: axios, cheerio6. 定时任务配置实战6.1 创建第一个定时任务点击定时任务 → 新建任务填写任务信息名称自定义任务名命令要执行的脚本或命令定时规则Cron表达式保存并启用6.2 使用Cron表达式青龙面板使用标准的Cron表达式格式分 时 日 月 周示例每天8点执行0 8 * * *每30分钟执行*/30 * * * *7. 常见问题排查7.1 容器启动失败可能原因及解决方案端口冲突检查5700端口是否被占用修改映射端口-p 5701:5700权限问题chmod -R 777 /var/lib/docker/volumes/qinglong_data7.2 网络连接问题如果脚本需要访问外部API检查容器网络模式docker inspect qinglong | grep NetworkMode可能需要使用--network host参数重新创建容器7.3 依赖安装失败解决方案更换镜像源docker exec -it qinglong bash npm config set registry https://registry.npm.taobao.org pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple手动安装依赖8. 高级配置与优化8.1 使用Nginx反向代理通过宝塔面板配置添加站点设置反向代理目标URL:http://127.0.0.1:5700发送域名:$host8.2 配置HTTPS访问申请SSL证书宝塔面板提供免费Lets Encrypt强制HTTPS跳转修改青龙面板配置中的登录地址8.3 资源监控与限制查看容器资源使用情况docker stats qinglong限制资源使用docker update --memory 1G --memory-swap -1 qinglong9. 备份与迁移9.1 数据备份备份容器数据docker stop qinglong tar -czvf qinglong_backup.tar.gz /var/lib/docker/volumes/qinglong_data docker start qinglong导出任务配置在青龙面板中使用导出功能9.2 迁移到新服务器在新服务器上安装相同环境恢复数据卷tar -xzvf qinglong_backup.tar.gz -C /重新创建容器使用相同参数10. 安全加固建议修改默认端口5700设置强密码并定期更换限制访问IP通过宝塔防火墙定期更新镜像docker pull whyour/qinglong:latest docker stop qinglong docker rm qinglong # 使用之前的参数重新运行我在实际使用中发现将青龙面板的日志目录挂载到主机便于查看-v /path/to/logs:/ql/logs对于需要持久化的配置文件也可以单独挂载-v /path/to/config:/ql/config