以下是2026 年最新使用宝塔面板（BT Panel）安装青龙面板（QingLong Panel）Docker 版的完整步骤。
目前（2026 年）宝塔面板 9.2.0+ 版本已内置青龙面板到Docker 应用商店，安装方式极大简化，通常30 秒 ~ 几分钟即可完成（首次拉镜像可能稍长）。
前置条件检查
- 服务器：CentOS 7/8、Ubuntu 20/22/24、Debian 10/11/12 等（宝塔支持的系统）
- 宝塔面板版本：建议 9.2.0 或更高（2024 年 9 月后版本最佳）
- 内存：建议 ≥ 1GB（青龙 + 任务运行比较吃内存）
- 端口：默认青龙面板使用5700端口（需放行）
步骤 1：登录宝塔面板 & 安装 Docker（如果未安装）
- 浏览器访问你的宝塔面板（通常是 http://服务器IP:8888）
- 左侧菜单 →软件商店
- 搜索Docker或Docker 管理器
- 点击安装（如果已安装则跳过）
- 安装完成后，左侧菜单会出现Docker选项
强烈建议：先配置镜像加速（国内拉取更快）
- Docker →设置→加速 URL
- 推荐填入（2026 年常用免费加速之一）：
或其他可用加速（如 registry.cn-hangzhou.aliyuncs.com 等）https://docker.xuanyuan.me - 保存设置
步骤 2：通过宝塔 Docker 应用商店一键安装青龙
宝塔 9.2.0+ 已内置青龙模板，操作最简单：
- 左侧菜单 →Docker
- 点击顶部应用商店（或模板/应用市场）
- 搜索青龙或青龙面板或QingLong
- 找到青龙面板（官方 whyour/qinglong 镜像），点击安装
安装参数填写建议（非常重要）：
| 参数 | 推荐填写内容 | 说明 |
|---|---|---|
| 名称 | qinglong（或自定义） | 容器名称，随意但建议好记 |
| 版本 | latest（或保持默认） | 建议用 latest 获取最新版 |
| 域名 | （可选）填写你的域名 如 ql.yourdomain.com | 如果有域名建议填，不填则用 IP:端口访问 |
| 允许外部访问 | 如果没填域名 →必须勾选 填了域名 →不要勾选 | 勾选后直接 IP:5700 访问，不勾选需用反向代理 |
| 端口映射 | 宿主机 5700 → 容器 5700（默认自动） | 青龙默认内部端口 5700 |
| CPU 限制 | 0（不限制） | 一般不限 |
| 内存限制 | 0 或 1024（1GB） | 建议至少 512MB～1GB |
| 挂载卷 | 自动生成（宝塔会帮你创建 /www/wwwroot/qinglong 等路径） | 映射 config、db、log、repo 等目录，数据持久化 |
- 点击确定/安装
- 首次拉取镜像（whyour/qinglong:latest）可能需要 1～5 分钟
- 安装完成后状态变为运行中
步骤 3：访问青龙面板 & 初始设置
- 无域名方式：http://你的服务器IP:5700
- 有域名方式：http://你填写的域名
首次访问会进入初始化界面：
- 用户名：admin（默认或自定义）
- 密码：随机生成或自定义（建议设置强密码）
- 登录后立即修改密码（右上角 → 修改密码）
查看初始账号密码（万一没看到初始化页面）：
# 在宝塔终端或 SSH 执行dockerlogs qinglong# 容器名根据你起的名字改# 或者dockerexec-it qinglongcat/ql/config/auth.json步骤 4：安全组 / 防火墙放行（最容易忘的步骤）
- 宝塔防火墙：宝塔 → 安全 → 放行端口 → 添加 5700
- 云厂商安全组（阿里云/腾讯云/华为云等）：
- 入方向规则 → TCP → 5700 → 0.0.0.0/0（或指定 IP）
常见问题快速解决
| 问题 | 可能原因 & 解决办法 |
|---|---|
| 拉镜像失败 / 超时 | 配置镜像加速（步骤1），或换加速地址如 registry.docker-cn.com |
| 无法访问 5700 端口 | 1. 没放行安全组/宝塔防火墙 2. 没勾选“允许外部访问”且没设反向代理 |
| 容器启动失败 | docker logs 容器名 查看日志，通常是端口冲突或挂载路径权限问题 |
| 想用域名访问 | 宝塔 → 网站 → 添加站点 → 反向代理 → 目标 http://127.0.0.1:5700 |
| 青龙版本太旧 | 容器 → 选择青龙 → 停止 → 删除 → 重新从应用商店安装（会拉 latest） |
推荐后续操作
- 更新青龙：容器列表 → 进入容器终端 → 输入
ql update - 拉取常用脚本仓库（Faker2 等）：定时任务 → 新建任务 → 命令填
ql repo https://github.com/shufflewzc/faker2.git ... - 设置通知（如微信/Telegram/Server酱）：设置 → 通知设置
- 安装 Node、Python 依赖：依赖管理 → 新建依赖
祝安装顺利！如果你的宝塔版本低于 9.2.0 或遇到具体报错，可以把错误截图/日志贴出来，我再帮你针对性解决。
