零基础教程:安卓手机通过Termux+Alpine快速部署青龙面板
1. 为什么要在安卓手机上部署青龙面板青龙面板是一款基于Docker的定时任务管理工具最初是为服务器环境设计的。但很多用户发现其实安卓手机也能跑起来——只要你的手机性能不是太差。我实测过一台中端配置的安卓手机比如骁龙7系处理器6GB内存运行青龙面板完全没问题挂个京东脚本、签到任务绰绰有余。移动端部署的优势很明显不用额外花钱买服务器闲置手机变废为宝随时随地用浏览器管理任务比云服务器更隐私数据完全在本地不过传统方法需要root权限这对大多数用户来说门槛太高。现在通过TermuxAlpine的组合完全不需要root就能实现容器化部署这才是真正的零基础方案。2. 准备工作Termux与Alpine环境配置2.1 安装Termux高级终端推荐使用ZeroTermux这个增强版原版Termux也能用但操作更复杂。这个魔改版自带容器管理功能特别适合青龙面板部署。安装步骤从可信渠道下载APK建议去GitHub找官方发布安装后打开应用先执行这个关键命令termux-setup-storage这步会申请存储权限成功后会在home目录看到storage文件夹。如果没弹出权限申请去手机设置里手动给应用授予存储权限。遇到过的问题有些MIUI系统会默认禁止Termux的存储权限需要在「应用管理-权限」里手动开启。如果执行命令后没生成storage目录八成是权限没给对。2.2 Alpine Linux环境部署Alpine是个只有5MB大小的迷你Linux系统非常适合在手机端运行。在Termux里安装只需两行命令curl -LO https://raw.githubusercontent.com/Hax4us/TermuxAlpine/master/TermuxAlpine.sh bash TermuxAlpine.sh安装完成后用这个命令进入Alpine环境termux-alpine验证是否成功执行ls -a如果看不到.termux文件夹说明已经处在Alpine系统中。需要退回Termux原生环境时执行exit即可。3. 青龙面板的安装与配置3.1 一键安装脚本详解在Alpine环境下执行这个自动化脚本建议完整复制set -x \ echo -e \n\ export QL_DIR/ql\n\ export QL_BRANCHdevelop\n\ export LANGzh_CN.UTF-8\n\ export TERMUX_APK_RELEASEF-DROID\n\ export SHELL/bin/bash\n\ export PNPM_HOME~/.local/share/pnpm\n\ export PATH\$PATH:~/.local/share/pnpm:~/.local/share/pnpm/global/5/node_modules\n \ /etc/profile.d/ql_env.sh \ source /etc/profile \ echo -e nameserver 119.29.29.29\n\ nameserver 8.8.8.8 /etc/resolv.conf \ sed -i s/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g /etc/apk/repositories \ apk update -f \ apk upgrade \ apk --no-cache add -f bash make nodejs npm \ coreutils moreutils git curl wget tzdata perl \ openssl nginx jq openssh python3 py3-pip \ rm -rf /var/cache/apk/* \ apk update \ ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \ echo Asia/Shanghai /etc/timezone \ npm config set registry https://registry.npmmirror.com \ npm install -g pnpm \ pnpm add -g pm2 ts-node typescript tslib \ mkdir -p $QL_DIR \ git clone -b $QL_BRANCH https://github.com/whyour/qinglong.git $QL_DIR \ cd $QL_DIR \ cp -f .env.example .env \ chmod 777 $QL_DIR/shell/*.sh \ chmod 777 $QL_DIR/docker/*.sh \ pnpm install --prod \ mkdir -p $QL_DIR/static \ git clone -b $QL_BRANCH https://github.com/whyour/qinglong-static.git $QL_DIR/static \ ln -s /ql/docker/docker-entrypoint.sh /usr/bin/qinglong \ qinglong关键参数说明QL_BRANCHdevelop表示安装开发版最新功能改成v2.15.0这样的版本号可安装稳定版中科大镜像源加速软件包下载自动设置时区为上海使用淘宝npm镜像3.2 常见安装问题排查网络错误如果卡在git clone环节尝试修改/etc/resolv.conf增加nameserver 223.5.5.5依赖安装失败执行pnpm install --prod单独重装依赖端口冲突如果5700端口被占用修改/ql/config/env.sh中的PORT值存储权限问题确保Termux有存储权限Alpine中/ql目录可写入安装完成后浏览器访问http://127.0.0.1:5700就能看到青龙面板的初始化界面。4. 日常使用与维护技巧4.1 开机自启动方案由于手机系统会杀后台进程建议这样设置在Termux中安装Termux:Boot插件创建~/.termux/boot/目录新建startql.sh文件内容为#!/data/data/com.termux/files/usr/bin/sh termux-wake-lock termux-alpine -c qinglong给脚本执行权限chmod x ~/.termux/boot/startql.sh这样每次手机重启后Termux会自动恢复青龙服务。4.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 main获取Cookie使用Via浏览器访问m.jd.com登录后点击地址栏左侧「锁形图标」复制pt_key和pt_pin的值在青龙面板「环境变量」中添加名称JD_COOKIE值pt_keyxxx;pt_pinxxx;4.3 备份与恢复通过ZeroTermux的容器管理功能侧滑菜单选择「备份/恢复」备份时会生成.tar.gz压缩包恢复时选择备份文件命名容器为ql_backup需要时可通过「容器切换」快速回滚建议每周备份一次特别是添加了新脚本后。备份文件默认保存在/storage/emulated/0/termux/backups/。5. 性能优化与进阶玩法5.1 手机端专属调优内存限制 修改/ql/docker/docker-entrypoint.sh找到pm2 start那行在前面添加export NODE_OPTIONS--max-old-space-size512这会将Node.js内存限制在512MB避免OOM定时任务错峰 在青龙面板「系统设置」-「通知设置」里把「任务并发数」改为1减少瞬间负载日志清理 添加定时任务每周清理旧日志find /ql/log -name *.log -mtime 7 -exec rm -f {} \;5.2 外网访问方案虽然青龙默认只监听本地但可以通过Termux的端口转发实现外网访问termux-expose 5700这会生成一个随机域名如xxxxx.termux-wireguard.com有效期8小时。需要长期访问的话建议搭配内网穿透工具如frp。5.3 多容器管理技巧ZeroTermux支持同时运行多个容器可以这样玩容器1青龙v2.15稳定版跑重要任务容器2青龙develop测试新版功能容器3Alpine纯净环境跑其他Linux应用切换容器只需在侧滑菜单选择「容器切换」完全隔离的环境避免冲突。