如何在本地或服务器端部署青龙面板？2026 最简单直接教程

这篇只讲最快落地的方法。

适用场景：

• 本地设备：OpenWrt / R2S / NAS / 小主机
• 服务器：Debian 12 / Ubuntu 22.04 / 24.04
• 前提：已经能正常运行 Docker

一、最快结论

直接记住这几条：

1. 本地和服务器都统一用 Docker 部署
2. 新装优先用 Docker Compose
3. 青龙数据统一挂载到 ./data:/ql/data
4. 镜像优先用 whyour/qinglong:latest
5. 如果依赖兼容有问题，改用 whyour/qinglong:debian
6. 公网不要长期裸开 5700 端口

二、本地设备部署青龙（最快方式）

只要你的本地设备已经装好了 Docker，直接执行下面几步。

1）创建目录

mkdir -p ~/qinglong
cd ~/qinglong

2）写入 compose.yaml

services:
  qinglong:
    image: whyour/qinglong:latest
    container_name: qinglong
    restart: unless-stopped
    ports:
      - "5700:5700"
    environment:
      QlBaseUrl: "/"
      TZ: Asia/Shanghai
    volumes:
      - ./data:/ql/data

如果你后面遇到依赖兼容问题，把这一行：

image: whyour/qinglong:latest

改成：

image: whyour/qinglong:debian

3）启动容器

docker compose up -d

4）检查是否启动成功

docker ps
docker logs -f qinglong

5）打开后台

浏览器访问：

http://本地设备IP:5700

例如：

http://192.168.50.2:5700

然后按页面提示初始化账号和密码即可。

三、服务器部署青龙（最快方式）

服务器推荐直接用 Debian 12 或 Ubuntu 22.04 / 24.04。

1）先安装 Docker

Debian

apt-get update
apt-get install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" > /etc/apt/sources.list.d/docker.list
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Ubuntu

apt-get update
apt-get install -y ca-certificates curl
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" > /etc/apt/sources.list.d/docker.list
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

安装完成后检查：

docker version
docker compose version

2）创建青龙目录

mkdir -p /opt/qinglong
cd /opt/qinglong

3）写入 compose.yaml

services:
  qinglong:
    image: whyour/qinglong:latest
    container_name: qinglong
    restart: unless-stopped
    ports:
      - "5700:5700"
    environment:
      QlBaseUrl: "/"
      TZ: Asia/Shanghai
    volumes:
      - ./data:/ql/data

如果你更想稳一点，直接把镜像改成：

image: whyour/qinglong:debian

4）启动青龙

docker compose up -d

5）检查状态

docker ps
docker logs -f qinglong

6）访问后台

http://服务器IP:5700

打开后初始化账号和密码即可。

四、镜像怎么选？

直接省事

whyour/qinglong:latest

适合大多数人先跑起来。

想减少依赖兼容问题

whyour/qinglong:debian

适合依赖更多、想少折腾的人。

五、最常用命令

启动

docker compose up -d

停止

docker compose down

重启

docker compose restart

查看日志

docker logs -f qinglong

查看容器

docker ps

更新青龙

docker compose pull
docker compose up -d

六、最小化排错

1）打不开 5700

先查：

docker ps
docker logs qinglong

再查：

• 本地防火墙
• 云服务器安全组
• IP 和端口有没有填错

2）镜像拉不下来

先查网络：

ping 1.1.1.1
ping github.com
docker pull hello-world

3）脚本报缺依赖

先别乱装一堆东西。
缺什么补什么，按实际报错处理。

七、最简单的最终建议

如果你是本地设备用户：

• 先把 Docker 跑通
• 直接用 Compose 部署
• 浏览器打开 IP:5700
• 初始化完成即可

如果你是服务器用户：

• 直接上 Debian 12 或 Ubuntu 22.04 / 24.04
• 先装 Docker
• 再用 Compose 起青龙
• 不要长期裸开 5700

八、一句话总结

2026 年部署青龙，最快最省事的方式就是：

Docker + Compose + ./data:/ql/data + whyour/qinglong:latest

如果遇到依赖兼容问题：

把镜像切到 whyour/qinglong:debian