本文最后更新于 2025-10-13，文章内容可能已经过时。

Docker环境部署青龙面板与云盘挂载指南

1. Docker安装与配置

安装步骤（CentOS/RedHat系统）

# 更新系统包索引
sudo yum check-update

# 执行Docker官方安装脚本
curl -fsSL https://get.docker.com/ | sh

# 启动Docker服务
sudo systemctl start docker

# 查看Docker服务状态
sudo systemctl status docker

# 设置Docker开机自启
sudo systemctl enable docker

Docker常用管理命令

# 关闭Docker服务
sudo service docker stop

# 重启Docker服务
sudo service docker start

# 查看Docker版本
docker --version

# 查看所有容器状态
docker ps -a

​温馨提示​：在安装Docker前，建议先更新操作系统以确保所有安全更新都已安装。对于不同的Linux发行版，安装命令可能略有差异，请根据实际系统选择合适的方法。

2. 青龙面板部署

创建并启动青龙容器

docker run -dit \
  --name QL \
  --hostname QL \
  --restart always \
  -p 5700:5700 \
  -v $PWD/QL/config:/ql/config \
  -v $PWD/QL/log:/ql/log \
  -v $PWD/QL/db:/ql/db \
  -v $PWD/QL/repo:/ql/repo \
  -v $PWD/QL/raw:/ql/raw \
  -v $PWD/QL/scripts:/ql/scripts \
  -v $PWD/QL/jbot:/ql/jbot \
  whyour/qinglong:latest

访问与初始化

  1. ​浏览器访问​：部署完成后，通过 http://服务器IP:5700访问青龙面板Web界面

  2. ​初始登录​：默认用户名和密码均为 admin，登录后请立即修改密码

  3. ​防火墙配置​：确保服务器安全组和防火墙已放行5700端口

容器管理命令

# 停止指定容器
docker stop 容器ID/名称

# 删除指定容器
docker rm 容器ID/名称

# 重启青龙容器（示例容器名为QL）
docker restart QL

3. 依赖环境配置

青龙面板正常运行需要安装以下依赖：

Node.js依赖

crypto-js, prettytable, dotenv, jsdom, date-fns, tough-cookie, tslib, 
ws@7.4.3, ts-md5, jieba, fs, form-data, json5, global-agent, png-js, 
@types/node, require, typescript, js-base64, axios, moment, gcc, ds, cheerio

Python3依赖

requests, canvas, ping3, jieba, PyExecJS, aiohttp

4. 常见问题解决方案

模块缺失错误

# Node.js模块缺失
docker exec -it ql(容器名称) pnpm install [模块名]

# Python模块缺失
docker exec -it ql(容器名称) pip3 install [模块名]

其他常见问题

  • ​拉库命令不完整​：检查并复制完整的拉库命令

  • ​脚本接口问题​：可能是脚本本身问题、黑号、IP限制或京东服务异常，可尝试重装或更换IP

  • ​青龙Cookie路径​：位于 config/env目录下

特定错误处理

  • ​ERROR: cannot find module '.function/common'​​：需要从GitHub下载缺失文件并放置到scripts/function目录下

5. 云服务器数据盘挂载（阿里云示例）

5.1 控制台挂载云盘

  1. 登录阿里云ECS管理控制台

  2. 进入存储 > 云盘，选择目标地域

  3. 找到状态为"待挂载"的云盘，操作列选择更多 > 挂载​

  4. 在弹出框中配置：

    • ​目标实例​：选择同一可用区的ECS实例

    • ​磁盘随实例释放​：按需选择

    • ​自动快照随磁盘释放​：建议不选以保留备份数据

  5. 单击执行挂载，等待状态变为"使用中"

5.2 磁盘分区与挂载操作

# 检查数据盘情况
fdisk -l

# 分区操作（以/dev/vdb为例）
fdisk /dev/vdb
# 依次输入：n → p → 1 → 回车 → 回车 → wq

# 格式化分区
mkfs.ext3 /dev/vdb1

# 创建挂载目录（示例挂载到/mnt）
mkdir /mnt

# 配置自动挂载
echo '/dev/vdb1 /mnt ext3 defaults 0 0' >> /etc/fstab

# 执行挂载
mount /dev/vdb1 /mnt/

# 查看分区情况
df -h

重要提示

  1. 数据盘挂载前需确保云服务器处于"运行中"状态

  2. 建议定期创建快照备份重要数据

  3. 青龙面板更新频繁，建议关注官方文档获取最新配置信息

此指南综合了最新的Docker部署和云盘管理实践，适用于当前主流环境。如遇到特定问题，建议查阅相关产品官方文档获取最新信息。