青龙面板一键搭建指南

青龙面板是一个强大的自动化平台，支持多种任务管理和自动化操作。以下内容将引导您通过一键安装或 Docker 安装的方式，快速搭建并使用青龙面板。

青龙平台搭建（两种安装方式）

1. 一键安装

通过以下步骤快速安装青龙面板：

yum update -y
wget -q https://raw.githubusercontents.com/yanyuwangluo/VIP/main/Scripts/sh/ql.sh -O ql.sh && bash ql.sh

更新系统并执行安装命令：
- 按照提示进行操作，推荐安装青龙面板版本 2.17.4。
- 如果您的系统未安装 Docker，脚本会自动安装。
选择安装目录并进行配置：
- 默认配置即可，无需额外设置。
解决安装过程中的错误提示：
- 如果遇到错误提示，按照提示解决。例如，如果出现服务器缺少 netstat 命令的提示，按照提示进行安装即可。
完成安装并访问面板：
- 完成所有操作后，使用浏览器访问 http://{ip}:5700 进入青龙面板。

2. Docker 安装

使用 Docker 安装青龙面板的方法如下：

确保系统已安装 Docker：
- 在常用 Docker 目录下创建 ql 文件夹。

mkdir -p /root/docker/ql

cd /root/docker

启动青龙容器（版本 2.17.4）：
- 建议使用稳定的 2.17.4 版本，以避免插件不兼容问题。
- 为了安全，建议将 Docker 映射的端口更改为非默认端口，如 -p 5777:5700。

docker run -dit \
  -v $PWD/ql:/ql/data \
  -p 5700:5700 \
  --name qinglong \
  --hostname qinglong \
  --restart always \
whyour/qinglong:2.17.4

登录青龙面板：
- 使用浏览器访问 http://{ip}:5700 进行登录。请确保端口映射和防火墙配置正确，否则可能无法访问。
安装依赖：
- 您可以在宿主机中执行命令安装依赖，或者手动在青龙面板中添加依赖。

docker exec -it qinglong bash
curl -fsSL https://ghproxy.com/https://raw.githubusercontent.com/shufflewzc/QLDependency/main/Shell/QLOneKeyDependency.sh | sh

如果您使用的是国内服务器，并且上述命令超时，可尝试以下加速版：

curl -fsSL https://api.dujin.org/js/qinglong/qinglong-yilaiku-dujin.org.sh | sh

海外服务器可以使用此命令：

curl -fsSL https://raw.githubusercontent.com/FlechazoPh/QLDependency/main/Shell/QLOneKeyDependency.sh | sh

NodeJs 依赖：

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

NodeJs 依赖

Python3 依赖：

requests
canvas
ping3
jieba
aiohttp

Python3 依赖

Linux 依赖：

bizCode
bizMsg
lxml

如果安装失败，尝试重启服务或点击重新安装按钮。
您还可以配置镜像源以加速安装过程：
- Node 软件包镜像源：https://registry.npmmirror.com
- Python 软件包镜像源：https://mirrors.aliyun.com/pypi/simple/
- Linux 软件包镜像源：https://mirrors.aliyun.com

镜像源配置

常见问题与解决方案

1. 缺少依赖模块 (Error: Cannot find module ‘xx’)

解决方法：按照提示安装所缺依赖。

docker exec -it qinglong(名称) pnpm install xx（安装依赖）

2. 缺少文件 (Error: Cannot find module ‘./xx’)

解决方法：检查并确保拉取库的命令正确无误。

3. 忘记青龙面板账号密码

解决方法：通过 SSH 执行以下命令查看账号和密码。

docker exec -it qinglong cat /ql/config/auth.json

结束

至此，青龙面板的搭建和基本配置已经完成。希望本指南能够帮助您顺利部署和使用青龙面板，如在操作过程中遇到任何问题，欢迎随时查阅相关文档或寻求社区支持。祝您使用愉快！