VPS怎么安装青龙面板？_详细步骤与常见问题解决方案

大大的也

2025-11-08 13:39:29

阅读 12

如何在VPS上安装青龙面板？

步骤	操作说明	使用工具提示	命令示例
1	安装Docker	确保系统已更新	`curl -fsSL https://get.docker.com \| bash -s docker --mirror Aliyun`
2	拉取青龙镜像	使用官方镜像	`docker pull whyour/qinglong`
3	创建配置目录	建议使用独立目录	`mkdir -p /root/dockertest/qinglong`
4	编写docker-compose文件	配置端口和存储卷	见下文代码块
5	启动容器	需放行5700端口	`docker-compose up -d`

# docker-compose.yml示例
version: '2'
services:
  web:
    image: whyour/qinglong
    volumes:

"./data:/ql/data"

    ports:

"5700:5700"

    environment:
      QlBaseUrl: '/'
    restart: unless-stopped

一、安装前准备

系统要求：推荐CentOS 7.6或Ubuntu 20.04 LTS，确保VPS已配置中国时区^^1^^。
端口配置：需在安全组放行5700端口（面板）和5600端口（API服务）^^2^^3^^。
工具安装：

Docker：sudo apt install -y docker.io（Debian/Ubuntu）或yum install -y docker-ce（CentOS）^^4^^
Docker Compose：通过官方脚本安装^^5^^

二、详细安装步骤

拉取镜像：

   docker pull whyour/qinglong:latest

若拉取缓慢，可配置国内镜像加速源^^5^^。

创建容器：

   docker run -dit \
     -v $PWD/ql/config:/ql/config \
     -v $PWD/ql/log:/ql/log \
     -p 5700:5700 \
     --name qinglong \
     --restart unless-stopped \
     whyour/qinglong:latest

注意：$PWD/ql可替换为自定义路径^^6^^。

初始化配置：

访问http://服务器IP:5700完成首次设置
默认账号密码可通过docker exec -it qinglong cat /ql/config/auth.json查看^^7^^

三、常见问题解决

问题现象	可能原因	解决方案
面板无法访问	端口未放行/容器未启动	检查防火墙规则`sudo ufw allow 5700`，执行`docker start qinglong`^^8^^
依赖安装失败	网络问题/镜像源异常	更换国内源或手动安装依赖`docker exec -it qinglong bash`后执行`pip install -r requirements.txt`^^9^^
日志文件过大	清理周期设置过长	修改清理策略或手动清理`/ql/log`目录^^10^^