Docker#

将数据挂载到 /ql/data，以下命令使用 Alpine 镜像：

docker run -dit \
  -v "$PWD/ql/data:/ql/data" \
  -p 5700:5700 \
  -e QlBaseUrl="/" \
  -e QlPort="5700" \
  --name qinglong \
  --hostname qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

访问 http://localhost:5700 完成初始化。QlBaseUrl 为可选的部署路径前缀，例如 /test；QlPort 为面板监听端口，默认为 5700。修改端口时，-p 冒号右侧必须与 QlPort 一致。

青龙 2.23.0 的默认镜像运行时如下；旧版本镜像的运行时可能不同：

青龙 2.23.0 是 Python 3.10 兼容镜像的最后一个版本。2.23.0-python3.10 和 2.23.0-debian-python3.10 发布后即停止维护，不再提供后续更新。请验证脚本和依赖后迁移至默认的 Python 3.11 镜像。

从旧容器升级时，先备份持久化数据，再验证用户脚本和依赖与新运行时的兼容性，步骤见维护指南。

首次将空的宿主机目录挂载到 /ql/data 时，该目录会遮蔽镜像在此路径下预装的 Python 依赖。运行需要 requests 的 Python 脚本或通知脚本前，请在面板的依赖管理中安装 Python 依赖 requests，并确认安装成功。升级时复用原有数据目录；运行时版本变化后的依赖检查见维护指南。

Debian 与非 root 运行#

需要 Alpine 不支持的依赖，或需要以非 root 用户运行时，使用 whyour/qinglong:debian。Alpine 的 crond 需要 root 权限。先确保宿主机挂载目录允许容器中的 qinglong 用户写入，再运行：

docker run -dit \
  -v "$PWD/ql/data:/ql/data" \
  -p 5700:5700 \
  --user qinglong \
  --name qinglong \
  --restart unless-stopped \
  whyour/qinglong:debian

这两条命令是替代方案，不要使用相同容器名同时创建。部署后可使用远程 CLI管理面板；容器内脚本执行见基础说明。