青龙面板拉库保姆级教程：从订阅管理到依赖一键安装

1
# 在服务器上测试GitHub连接
2
curl -I https://github.com
3

4
# 如果连接超时或失败,说明需要配置代理

1
服务器IP: 你的服务器公网IP
2
端口: 默认22(或你修改后的SSH端口)
3
用户名: root(或其他管理员账号)
4
密码: 你设置的SSH密码

1
# 进入青龙容器
2
docker exec -it qinglong bash
3

4
# 执行一键依赖安装脚本
5
curl -fsSL https://ghp.ci/https://raw.githubusercontent.com/FlechazoPh/QLDependency/main/Shell/QLOneKeyDependency.sh | bash

1
ql repo <仓库地址> <白名单> <黑名单> <依赖文件> <分支> <文件后缀>

1
ql repo https://github.com/shufflewzc/faker3.git "jd_|jx_|gua_|jddj_|jdCookie" "activity|backUp" "^jd[^_]|USER|function|utils|sendNotify" "main" "js|py"

1
登录后 → 左侧菜单栏 → 订阅管理 → 新建订阅

1
https://git.metauniverse-cn.com/https://github.com/shufflewzc/faker3.git

1
开始拉取仓库...
2
从 https://github.com/shufflewzc/faker3.git 克隆仓库...
3
正在过滤文件...
4
发现 45 个匹配的脚本文件
5
复制到 /ql/scripts 目录...
6
拉取完成!
7
共拉取 45 个脚本文件

1
# Faker3 内部互助版
2
ql repo https://github.com/shufflewzc/faker3.git "jd_|jx_|gua_|jddj_|jdCookie" "activity|backUp" "^jd[^_]|USER|function|utils|sendNotify|ZooFaker_Necklace.js|JDJRValidator_|sign_graphics_validate|ql|JDSignValidator|magic|depend|h5sts" "main"
3

4
# Faker4 纯净版(适合安静挂机)
5
ql repo https://github.com/shufflewzc/faker4.git "jd_|jx_|gua_|jddj_|jdCookie" "activity|backUp" "^jd[^_]|USER|function|utils|sendNotify|ZooFaker_Necklace.js|JDJRValidator_|sign_graphics_validate|ql|JDSignValidator|magic|depend|h5sts" "main"

1
ql repo https://github.com/6dylan6/jdpro.git "jd_|jx_|jddj_" "backUp" "^jd[^_]|USER|JD|function|sendNotify|utils"

1
ql repo https://github.com/KingRan/KR.git "jd_|jx_|jdCookie" "activity|backUp" "^jd[^_]|USER|utils|function|sign|sendNotify|ql|JDJR"

1
ql repo https://github.com/RayWangQvQ/BiliBiliToolPro.git "" "" "^README|^.git|^.github|test|docs" "main" "sh"

1
# 可用的代理地址(任选一个)
2
GithubProxyUrl="https://git.metauniverse-cn.com/"
3
GithubProxyUrl="https://pd.zwc365.com/"
4
GithubProxyUrl="https://gh.fakev.cn/"
5
GithubProxyUrl="https://ghproxy.com/"

1
# 原地址
2
https://github.com/shufflewzc/faker3.git
3

4
# 镜像地址
5
https://git.metauniverse-cn.com/https://github.com/shufflewzc/faker3.git
6
https://ghproxy.com/https://github.com/shufflewzc/faker3.git

1
# 测试网络连接
2
curl -I https://github.com
3

4
# 如果返回失败,检查DNS配置
5
ping github.com
6

7
# 尝试更换DNS为公共DNS
8
# 编辑 /etc/resolv.conf
9
nameserver 8.8.8.8
10
nameserver 114.114.114.114

1
# 查看容器状态
2
docker ps | grep qinglong
3

4
# 如果容器没有运行,重新启动
5
docker start qinglong
6

7
# 进入容器检查文件权限
8
docker exec -it qinglong bash
9
ls -la /ql/scripts

1
# 停止并删除旧容器
2
docker 终止 qinglong
3
docker rm qinglong
4

5
# 重新创建容器,注意挂载路径的权限
6
docker run -dit \
7
  -v $PWD/ql/data:/ql/data \
8
  -p 5700:5700 \
9
  --name qinglong \
10
  --hostname qinglong \
11
  --restart unless-stopped \
12
  whyour/qinglong:latest

1
# 进入容器
2
docker exec -it qinglong bash
3

4
# 修改目录权限
5
chmod -R 755 /ql/scripts
6
chown -R root:root /ql/scripts

1
# 查找活跃仓库的方法:
2
# 1. 访问GitHub,搜索相关关键词
3
# 2. 查看仓库的最近更新时间
4
# 3. 查看Issue和Star数量,判断活跃度
5
# 4. 参考技术社区的推荐列表

1
# Gitee镜像地址示例
2
https://gitee.com/shufflewzc/faker3.git

1
# 进入容器
2
docker exec -it qinglong bash
3

4
# 安装Node.js依赖
5
pnpm install axios crypto-js tough-cookie date-fns
6

7
# 安装Python依赖
8
pip3 install requests jieba beautifulsoup4 lxml
9

10
# 批量安装Node.js依赖
11
pnpm install -g axios crypto-js tough-cookie date-fns cheerio jsdom moment request
12

13
# 批量安装Python依赖
14
pip3 install requests jieba beautifulsoup4 lxml canvas ping3 PyExecJS aiohttp

1
# 推荐使用社区维护的一键安装脚本
2
docker exec -it qinglong bash -c "$(curl -fsSL https://ghp.ci/https://raw.githubusercontent.com/FlechazoPh/QLDependency/main/Shell/QLOneKeyDependency.sh | bash)"
3

4
# 安装完成后重启容器
5
docker restart qinglong

1
# 查看磁盘使用情况
2
df -h
3

4
# 查看内存使用情况
5
free -h
6

7
# 查看CPU使用情况
8
top

1
# 删除旧日志
2
docker exec -it qinglong bash
3
rm -rf /ql/log/*.log

1
# 进入容器
2
docker exec -it qinglong bash
3

4
# 删除已拉取的仓库
5
cd /ql/repo
6
rm -rf <仓库名称>
7

8
# 退出容器
9
exit
10

11
# 重新执行拉库任务

1
# 在 config.sh 中添加或修改
2
RepoCloneTimeout=300  # 单位为秒

1
分 时 日 月 周

1
# 每天凌晨0点拉取一次(推荐)
2
0 0 * * *
3

4
# 每12小时拉取一次
5
0 */12 * * *
6

7
# 每周一凌晨2点拉取
8
0 2 * * 1
9

10
# 每月1号凌晨3点拉取
11
0 3 1 * *
12

13
# 不自动拉取,仅在需要时手动运行(适合不常更新的仓库)
14
# 定时规则留空

1
京东类:
2
- Faker3库(京东签到、领豆)
3
- JDpro库(京东活动)
4
- KR库(京东脚本)
5

6
其他平台:
7
- Bilibili库(B站签到)
8
- 网易云库(音乐签到)
9
- 百度文库库(文档下载)
10

11
工具类:
12
- ql_scripts库(通用工具)
13
- hello-script库(示例脚本)

1
格式: [平台][类型][仓库名称]
2

3
示例:
4
- [京东][活动]Faker3内部互助版
5
- [京东][纯净]Faker4挂机版
6
- [B站][签到]BiliBiliToolPro
7
- [通用][工具]ql_scripts

1
# 为不同仓库使用不同的依赖目录
2
# 拉库命令中指定extensions参数
3
ql repo https://github.com/user/repo1.git "" "" "" "main" "js"
4
ql repo https://github.com/user/repo2.git "" "" "" "main" "py"

1
# 进入容器
2
docker exec -it qinglong bash
3

4
# 查看订阅日志
5
cat /ql/log/subscriptions.log
6

7
# 查看最近的日志
8
tail -f /ql/log/subscriptions.log
9

10
# 查看特定时间的日志
11
grep "2026-02-19" /ql/log/subscriptions.log

1
# 实时监控订阅日志
2
docker exec -it qinglong tail -f /ql/log/subscriptions.log

1
✓ 从 https://github.com/xxx.git 克隆仓库成功
2
✓ 正在过滤文件...
3
✓ 发现 45 个匹配的脚本文件
4
✓ 拉取完成!

1
✗ 连接超时
2
✗ 仓库不存在
3
✗ 权限不足
4
✗ 磁盘空间不足

1
⚠ 部分文件过滤失败
2
⚠ 依赖安装失败
3
⚠ 脚本文件已存在,跳过复制

1
# 删除7天前的日志
2
docker exec -it qinglong bash
3
find /ql/log -name "*.log" -mtime +7 -delete
4

5
# 或使用青龙自带的日志清理命令
6
docker exec -it qinglong ql rmlog 7

1
# 方法1: 删除仓库后重新拉取
2
docker exec -it qinglong bash
3
cd /ql/repo
4
rm -rf <仓库名称>
5
exit
6

7
# 方法2: 使用--force参数(部分版本支持)
8
ql repo <仓库地址> --force

1
# 进入仓库目录
2
docker exec -it qinglong bash
3
cd /ql/repo/<仓库名称>
4

5
# 查看提交历史
6
git log --oneline
7

8
# 回滚到指定版本
9
git checkout <commit_id>
10

11
# 退出容器
12
exit

1
# 编辑订阅,修改分支参数
2
# 从 "main" 改为 "dev" 或 "test"

1
# 克隆仓库到本地
2
git clone https://github.com/user/repo.git
3

4
# 使用grep搜索可疑关键词
5
grep -r "eval\|exec\|system\|spawn" repo/
6

7
# 检查网络请求
8
grep -r "http\|https\|axios\|request" repo/
9

10
# 检查文件操作
11
grep -r "fs\|readFile\|writeFile" repo/

1
# 推荐仓库列表(示例)
2
✓ shufflewzc/faker系列(京东)
3
✓ 6dylan6/jdpro(京东)
4
✓ KingRan/KR(京东)
5
✓ RayWangQvQ/BiliBiliToolPro(B站)
6
✓ whyour/ql_scripts(官方通用)

1
# 检查可疑进程
2
docker exec -it qinglong ps aux
3

4
# 检查网络连接
5
docker exec -it qinglong netstat -tulpn
6

7
# 检查文件变化
8
docker exec -it qinglong find /ql/scripts -type f -mtime -1

1
# 定期备份青龙数据
2
docker exec -it qinglong tar -czf /ql/data_backup_$(date +%Y%m%d).tar.gz /ql/data
3

4
# 备份到本地服务器
5
docker cp qinglong:/ql/data_backup_20260219.tar.gz ./backup/

1
# Cookie格式示例(京东)
2
JD_COOKIE=pt_key=xxx;pt_pin=xxx;
3

4
# 注意事项:
5
# - 不要分享你的Cookie
6
# - 定期更新Cookie(一般7-30天失效)
7
# - 重要账号建议单独使用,避免混用

1
axios, crypto-js, tough-cookie, date-fns, cheerio, jsdom, moment, request, ts-md5, png-js, dotenv, lodash, form-data, qs, uuid, ws

1
requests, jieba, beautifulsoup4, lxml, aiohttp, PyExecJS, canvas, ping3, redis, Pillow, qrcode, pytz