把定时脚本放到云端运行,青龙面板可以集中管理脚本和任务。下面以 Ubuntu 22.04 的阿里云 ECS 为例,说明如何用 Docker 部署青龙、完成首次初始化,并设置面板访问规则。不同 Linux 发行版和 CPU 架构的命令可能不同,开始前先确认实例的系统版本与架构。
一、安装前先检查服务器
准备一台 Linux 云服务器,建议至少有 1 核 CPU、1GB 内存。脚本数量增加后,内存和磁盘空间也要留有余量。登录阿里云控制台,确认 ECS 处于运行状态,记下公网 IP,并检查系统盘空间和网络配置。
青龙面板可能保存账号环境变量等敏感信息,端口开放范围需要提前考虑。不要为了方便把管理端口直接开放给所有公网地址;准备好复杂密码,也不要在公开场合贴出面板地址、令牌或环境变量内容。
二、安装 Docker
通过 SSH 登录 ECS 后,Ubuntu 用户可以用系统软件包安装 Docker:
- 更新软件包列表:
sudo apt update - 安装 Docker:
sudo apt install -y docker.io - 启动服务并设置开机启动:
sudo systemctl enable --now docker - 检查安装结果:
sudo docker version
如果系统仓库提供的 Docker 版本不适合当前需求,可以考虑 Docker 官方安装方式。执行网络上的安装脚本前,先确认脚本来源可信。使用 CentOS、Alibaba Cloud Linux 或 ARM 架构时,安装命令和镜像兼容性可能不同,不能直接把 Ubuntu 的步骤原样套用。
三、创建青龙容器并保存数据
先在服务器上建立数据目录,再启动容器。下面将青龙数据放在 /opt/ql/data,通过目录映射保存配置,避免容器重建后数据一并丢失:
sudo mkdir -p /opt/ql/datasudo docker run -d --name qinglong --restart unless-stopped -p 5700:5700 -v /opt/ql/data:/ql/data whyour/qinglong:latest
这里的 5700 是青龙面板常用端口;-v /opt/ql/data:/ql/data 把宿主机目录挂载到容器中;--restart unless-stopped 则让 Docker 在服务器重启后尝试恢复容器运行。
镜像标签 latest 会随上游更新变化。长期运行时,留意项目发布说明,评估后再升级;不要在脚本正在运行时随意更换镜像版本。启动后可以用 sudo docker ps 查看容器状态,再用 sudo docker logs --tail 100 qinglong 查看近期日志。容器启动需要一点时间,确认状态正常后再访问面板。
四、设置阿里云安全组并首次登录
在阿里云控制台找到 ECS 实例对应的安全组,检查入方向规则。浏览器要访问面板,需要允许 TCP 5700 端口。来源地址建议填写自己的固定公网 IP,不要设置为 0.0.0.0/0。规则生效后,在浏览器中输入 http://服务器公网IP:5700。
首次进入面板时,按页面提示完成初始化并设置强密码。页面流程可能随版本调整,以当前界面为准。若需要长期管理,可以考虑通过 SSH 隧道、VPN,或配置反向代理并使用 HTTPS。面板保存着敏感配置,长期直接暴露在公网并不稳妥。
五、部署检查:以小型定时任务为例
假设用户小周有一台 Ubuntu ECS,打算每天运行几个数据整理脚本。他先按上述步骤安装 Docker,将青龙数据放在 /opt/ql/data,并在安全组中只允许办公网络的固定 IP 访问。面板初始化后,他先创建一个不含个人凭据的测试任务,确认调度能够运行,再逐步添加所需环境变量。
部署完成不能只看网页是否能打开。还要确认数据目录确实挂载、容器重启后配置仍然保留,定时任务能够按预期执行,管理入口也没有对陌生网络开放。办公 IP 如果经常变化,不要为了省事把端口改成对所有地址开放,应调整为更合适的远程访问方式。
六、常见问题排查
- 网页无法访问:先用
sudo docker ps确认容器状态,再核对公网 IP 和端口。随后检查阿里云安全组及服务器内部防火墙;安全组放行不代表系统防火墙也已放行。 - 端口已被占用:检查服务器上的 5700 是否被其他程序使用。可以将宿主机端口改为 15700,例如使用
-p 15700:5700,并在安全组中放行实际使用的端口。访问地址也要改成对应端口。 - 容器启动失败:执行
sudo docker logs qinglong查看日志,再检查镜像是否拉取成功、磁盘空间是否充足、目录权限是否合适,以及镜像是否兼容当前 CPU 架构。 - 重建后配置不见:核对启动命令是否保留
-v /opt/ql/data:/ql/data,并确认宿主机上的/opt/ql/data没有被误删。没有目录映射时,容器内的数据可能无法按预期保留。 - 任务没有按时执行:检查定时表达式、脚本运行日志和服务器时间。面板显示任务已触发,不一定代表脚本业务结果正确,还需要查看脚本本身的运行记录。
部署后的日常维护
完成阿里云服务器安装青龙后,定期备份 /opt/ql/data,并在升级镜像前确认版本变化和兼容性。也要回头检查安全组来源是否仍然合适、面板密码是否足够强。若修改宿主机端口,安全组规则和浏览器访问地址都要同步调整,避免出现规则已改、访问方式却仍用旧端口的情况。
按顺序处理 Docker、数据目录、容器启动和访问限制,能减少部署后反复排错的情况。尤其要把持久化目录和公网访问范围核实清楚:前者关系到配置能否保留,后者关系到面板是否会被不必要的人访问。