青龙Tools面板安装与使用教程

前言

​重要提示​：一定要理解每个命令的含义，学会查看报错信息，并善用AI工具解决问题。

1. 安装QLTools

快速安装命令

# 创建QLTools目录并进入
mkdir qltools && cd qltools

# 使用Docker启动QLTools容器
docker run -itd --name QLTools \
  -v $PWD/config:/QLTools/config \
  -v $PWD/plugin:/QLTools/plugin \
  -p 15000:15000 \
  nuanxinqing123/qltools:latest

​架构支持​：该Docker镜像提供amd64、arm64、arm-7三种架构版本，会自动匹配您的系统架构。

2. 访问与初始化

访问地址

• ​登录地址​：http://你的IP:15000/#/login

• ​注册地址​：http://你的IP:15000/#/register（首次使用需先注册）

• ​后台管理​：http://你的IP:15000/#/admin

端口检查

确保服务器安全组/防火墙已放行15000端口。

3. 核心配置教程

3.1 变量管理配置

在"变量管理"中添加环境变量：

1. ​变量名称​：与青龙面板中的变量名一致（如京东Cookie变量为JD_COOKIE）

2. ​变量限额​：设置该变量允许的最大数量（通常设为100）

3. ​正则表达式​：用于过滤有效格式，例如京东Cookie：

   • 普通模式：pt_key=.*?pt_pin=.*?;

   • 更新模式：pt_pin=.*?;

4. ​绑定插件​：选择相应的检测插件（如jd_check.js）

3.2 面板管理配置

在"面板管理"中对接青龙面板：

1. ​新增面板​：启用面板并选择新/旧版本（青龙2.11.x以上选新版本）

2. ​面板地址​：填写青龙面板的访问地址（IP:5700）

3. ​认证信息​：在青龙面板的"系统设置 > 应用设置"中创建应用，获取Client ID和Client Secret

4. ​绑定变量​：将面板与之前创建的变量关联

5. ​测试连接​：确保配置正确

3.3 插件管理

QLTools支持通过JavaScript插件增强功能，常用的插件包括：

• jd_check.js：京东Cookie有效性检测

• 插件可从官方仓库或社区获取后上传到插件管理页面

4. 更新与维护

更新步骤

v1.3版本热更新存在Bug，建议手动升级：

1. 后台点击更新，等待约5分钟

2. 手动重启容器：docker restart QLTools

3. 如果更新失败，执行完整重装：

docker stop QLTools
docker rm -f QLTools
docker rmi nuanxinqing123/qltools
docker run -itd --name QLTools -v $PWD/config:/QLTools/config -v $PWD/plugin:/QLTools/plugin -p 15000:15000 nuanxinqing123/qltools:latest

日常维护命令

# 重启容器
docker restart QLTools

# 停止容器
docker stop QLTools

# 查看容器状态
docker ps -a

5. 故障排除

常见问题解决

1. ​变量上传失败​：检查网络连接，查看QLTools日志，确认青龙面板版本兼容性

2. ​连接测试通过但提交报错​：可能是QLTools与青龙版本不兼容，尝试更新青龙面板

3. ​容器启动失败​：检查端口冲突或目录权限问题

重要提示

• 首次使用必须注册管理员账号

• 配置时注意变量名称和正则表达式的准确性

• 定期备份配置文件防止数据丢失

鸣谢

感谢项目开发者 ​暖心情​ 的贡献，项目地址：https://github.com/nuanxinqing123/QLTools

教程具有时效性，如遇到问题请查阅项目最新文档或寻求社区帮助。感谢阅读！