VPS怎么安装青龙面板？_详细步骤与常见问题解决方案
如何在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 |
```yaml
# docker-compose.yml示例
version: '2'
services:
web:
image: whyour/qinglong
volumes:
- "./data:/ql/data"
ports:
- "5700:5700"
environment:
QlBaseUrl: '/'
restart: unless-stopped
```
### 一、安装前准备
1. **系统要求**：推荐CentOS 7.6或Ubuntu 20.04 LTS，确保VPS已配置中国时区^^1^^。
2. **端口配置**：需在安全组放行5700端口（面板）和5600端口（API服务）^^2^^3^^。
3. **工具安装**：
- Docker：`sudo apt install -y docker.io`（Debian/Ubuntu）或`yum install -y docker-ce`（CentOS）^^4^^
- Docker Compose：通过官方脚本安装^^5^^
### 二、详细安装步骤
1. **拉取镜像**：
```bash
docker pull whyour/qinglong:latest
```
若拉取缓慢，可配置国内镜像加速源^^5^^。
2. **创建容器**：
```bash
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^^。
3. **初始化配置**：
- 访问`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^^ |
### 四、进阶配置建议
1. **多容器管理**：通过`docker-compose`实现集群部署^^5^^
2. **定时任务**：利用面板的Cron功能实现自动化脚本执行^^11^^
3. **监控集成**：可搭配Prometheus+Grafana监控面板状态^^12^^
如需可视化指导，可参考以下视频教程：
发表评论