使用 Docker 部署青龙面板教程

青龙面板（QingLong）是一款非常实用的任务管理面板，特别适用于需要定时任务的用户。通过 Docker 部署青龙面板，不仅方便，而且可以轻松管理和更新。本文将为你详细介绍如何使用 Docker 部署青龙面板。

前提条件

安装 Docker：确保你的服务器或本地机器上已经安装了 Docker。如果没有安装，可以参考 Docker 官方文档进行安装。
安装 Docker Compose（可选）：如果你希望使用 Docker Compose 来管理容器，可以先安装 Docker Compose。请参考 Docker Compose 官方文档。

步骤一：拉取青龙面板镜像

首先，你需要从 Docker Hub 拉取青龙面板的最新镜像。打开终端并执行以下命令：

bash复制代码docker pull whyour/qinglong:latest

步骤二：创建数据卷

为了确保青龙面板的数据持久化，我们需要创建一个 Docker 数据卷。这样即使容器停止或删除，数据也不会丢失。

bash复制代码docker volume create qinglong_data

步骤三：运行青龙面板容器

现在我们可以运行青龙面板的 Docker 容器。以下是一个基本的运行命令：

bash复制代码docker run -d \
  --name qinglong \
  -e PUID=1000 \      # 替换为你的用户ID
  -e PGID=1000 \      # 替换为你的组ID
  -e QL_ENABLE=true \  # 启用青龙面板
  -v qinglong_data:/ql/data \  # 持久化数据
  -p 5700:5700 \       # 映射端口
  whyour/qinglong:latest

说明

-d：以后台模式运行容器。
--name qinglong：为容器指定名称。
-e PUID=1000 和 -e PGID=1000：指定容器内运行进程的用户 ID 和组 ID，通常可以通过命令 id 查询到。
-v qinglong_data:/ql/data：将创建的数据卷挂载到容器内的 /ql/data 目录。
-p 5700:5700：将容器的 5700 端口映射到主机的 5700 端口。

步骤四：访问青龙面板

成功运行容器后，可以通过浏览器访问青龙面板。打开浏览器，输入以下地址：

复制代码http://<你的服务器IP>:5700

替换 <你的服务器IP> 为你服务器的实际 IP 地址。

步骤五：配置青龙面板

首次访问青龙面板时，你需要进行一些基本配置。根据界面提示进行设置，包括用户名和密码等。完成配置后，你就可以开始使用青龙面板管理你的任务了。

常见问题

1. 如何查看容器日志？

你可以使用以下命令查看青龙容器的日志：

bash复制代码docker logs -f qinglong

2. 如何停止和启动容器？

停止容器：

bash复制代码docker stop qinglong

启动容器：

bash复制代码docker start qinglong

3. 如何更新青龙面板？

要更新青龙面板，可以先停止并删除现有容器，然后拉取最新镜像并重新运行容器。具体步骤如下：

bash复制代码docker stop qinglong
docker rm qinglong
docker pull whyour/qinglong:latest
docker run -d \
  --name qinglong \
  -e PUID=1000 \
  -e PGID=1000 \
  -e QL_ENABLE=true \
  -v qinglong_data:/ql/data \
  -p 5700:5700 \
  whyour/qinglong:latest