📒 ZeroTermux + 青龙面板 安装笔记
日期：2025-09-18 目标：在 非 Root 的安卓手机上，通过 恢复包 方式，十分钟内跑起 最新青龙面板 v2.15.7。
0️⃣ 资源准备（一次性搞定）
| 文件 | 作用 | 直链 & 备用 |
|---|---|---|
| ZeroTermux.apk | 主程序，下载最新版 | 官方下载 |
| 青龙恢复包（2.12.2和2.15两个版本） | 主要的镜像 | https://pan.quark.cn/s/85f1e60fef11 |
| MT管理器（可选） | 方便复制文件 | 我直接用USB连接电脑，方便传输文件，除非没电脑再考虑这个 |
1️⃣ 安装 ZeroTermux
- 安装 APK（任何版本号 0.118即可）。
- 首次打开 → 弹权限请求 → 全部允许（存储、通知）。
- 确认架构：在 ZeroTermux 里输入
uname -m
回显 aarch64 或 armv8 均可继续。
2️⃣ 获取存储权限（关键）
在 ZeroTermux 终端 逐行 执行：
termux-setup-storage
安卓会自动弹出 "允许访问文件" → 点 允许。接着 立刻验证：
ls -a
输出里出现 storage 目录即为成功 ✓（若未见，重新执行一次 termux-setup-storage，或重启 App）。
3️⃣ 导入恢复包
- 手机文件管理器 → 内部存储 → 新建两级目录： 或用电脑创建目录
/xinhao/data/
- 把下载好的恢复包
termux_alpine_ql_v2.15.7.tar.gz完整 拷进去，名字无所谓，后缀是 tar.gz就行。 - 回到 ZeroTermux → 左滑侧边栏 → 备份/恢复 → 恢复 → 选中刚拷进去的
.tar.gz→ 输入新容器名（如pl）→ 等待进度条跑完（2-3 分钟）。 - 跑完会提示「系统恢复完成」，请耐心等待。
4️⃣ 切换容器并首次启动
- 恢复完成后，侧边栏 → 容器切换 → 会看到一条新的
alpine_ql_2.15.7容器 → 点击切换 → 重启 ZeroTermux。 - 重启后终端前缀变成
localhost:~#（Alpine 格式）即成功。 - 2.12.2版本首次启动青龙：
./ql.sh
- 第一次会跑初始化脚本（拉镜像、装依赖），耐心等待 3-5 分钟，看到提示：
青龙面板已启动，请访问 http://127.0.0.1:5700即完成。
- 2.15版本首次启动青龙：
startalpine
qinglong
5️⃣ 浏览器访问
- 本机浏览器：
http://127.0.0.1:5700 - 局域网其他设备：手机 设置 → 关于手机 → 状态信息 → IP地址，如
192.168.1.123，则访问http://192.168.1.123:5700
6️⃣ 后续升级（可选，但不推荐升级，至少我没实验成功）
登录面板 → 右上角 系统设置 → 其他设置 → 检查更新 → 一键升级到 2.19。升级的时间很长，要耐心等。我就一直卡在安装 /ql 依赖中…… 完成后，在手机上，重新切换容器后，重新进入容器：
startalpine
ql check
ql update
🚨 常见坑速修
| 现象 | 解决 |
|---|---|
./ql.sh 报找不到 |
没切容器，侧边栏重新切换 |
| 依赖安装看似成功，实则失败 | 看后文 [[#]] |
| 升级后打不开 | 端口变成 5600，或防火墙拦截，换端口访问 |
2.15版本依赖安装问题
在面板中依赖安装看似成功，实则失败，到底安装成功没有？比如我的 pnpm install axios crypto-js jsdom date-fns qs dotenv tough-cookie --shamefully-hoist 都没安装成功，需要在容器中查看：
# 切换环境
startalpine
# 进入容器
cd /ql
# 查看pnpm 已安装模块
pnpm list --depth=0
# 如果没找到模块，比如axios，则先检查目前用什么网络安装
pnpm config get registry
# 下面的命令安装
pnpm install axios crypto-js jsdom date-fns qs dotenv tough-cookie
#
# 然后再用 list 检查
pnpm list --depth=0
- pnpm config get registry默认国外官方源会返回
https://registry.npmjs.org/ - 国内镜像常见返回
https://registry.npmmirror.com/（淘宝）https://registry.npmmirror.com/（阿里）https://mirrors.cloud.tencent.com/npm/（腾讯）
在 ZeroTermux + 青龙面板 2.15 容器里，把 npm / pnpm 国外源 换成 国内镜像 最稳妥的做法就 3 行命令：
- 进入容器
startalpine
cd /ql
- 一键切换 淘宝镜像（npmmirror）
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com
或者想用 清华大学镜像 也可以：
npm config set registry https://mirrors.tuna.tsinghua.edu.cn/npm/
pnpm config set registry https://mirrors.tuna.tsinghua.edu.cn/npm/
- 确认已生效
npm config get registry
pnpm config get registry
回显：https://registry.npmmirror.com/ 即成功。
🎯 最终状态
- 手机通知栏出现 "Termux 服务运行中"
- 浏览器能正常进入 青龙面板
- 可以开始 拉库、加任务、跑脚本。 至此，ZeroTermux + 青龙面板安装完毕 ✓
