网址转 APK – 完整源码 + 部署教程
一、服务器准备
1.0 服务器规格
这是第一失败原因,先确认再动手。
| 项 | 最低 | 建议 |
|---|---|---|
| CPU | 2 核 | 4 核 |
| 内存 | 4 GB | 8 GB(2 GB 基本必 OOM) |
| Swap | 2 GB | 4 GB |
| 磁盘 | 40 GB | 60 GB 以上 |
free -h
df -h / /www
内存不足先加 Swap:
fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
Docker 数据盘与系统盘分离时,在 daemon.json 里配置 data-root,否则十几 GB 镜像会吃掉根分区。
1.1 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
systemctl start docker
systemctl enable docker
docker -v
1.2 配置镜像加速器
先花五秒判断能不能用腾讯云内网加速器,这个地址只有腾讯云内网可达,速度比公共加速器快几十倍且不占公网带宽。
curl -m 5 -so /dev/null -w '%{http_code}n' https://mirror.ccs.tencentyun.com/v2/
返回 200 或 401,走方案 A。超时或返回 000,走方案 B。
方案 A:腾讯云内网加速器(推荐)
cp -a /etc/docker/daemon.json /etc/docker/daemon.json.bak 2>/dev/null
cat > /etc/docker/daemon.json <<'EOF'
{
"registry-mirrors": ["https://mirror.ccs.tencentyun.com"],
"max-concurrent-downloads": 10
}
EOF
systemctl daemon-reload
systemctl restart docker
docker info | grep -A4 'Registry Mirrors'
方案 B:公共加速器
先逐个测连通,别直接抄列表,这些站时效性极强。
for m in docker.1ms.run docker.xuanyuan.me docker.1panel.live hub.rat.dev; do
printf '%-24s ' "$m"
curl -m 8 -so /dev/null -w '%{http_code}n' "https://$m/v2/" || echo fail
done
把返回正常的写进去:
cp -a /etc/docker/daemon.json /etc/docker/daemon.json.bak 2>/dev/null
cat > /etc/docker/daemon.json <<'EOF'
{
"registry-mirrors": [
"https://docker.1ms.run",
"https://docker.xuanyuan.me",
"https://docker.1panel.live",
"https://hub.rat.dev"
],
"max-concurrent-downloads": 10
}
EOF
systemctl daemon-reload
systemctl restart docker
docker info | grep -A6 'Registry Mirrors'
全部失效时改用阿里云容器镜像服务控制台分配的个人专属加速地址。
两个小提醒:CentOS 下 root 的 cp 默认别名成 cp -i,覆盖已存在的备份会反复问 overwrite?,命令前加反斜杠 cp 可绕过;cat > 是整体覆盖,原文件里若配过 data-root、日志等字段,要手动合并回来。
1.3 拉取 Android 编译镜像
docker pull mingc/android-build-box:latest
建议前台执行,能直接看到每层百分比和总速度。看到 Digest: sha256:... 和 Status: Downloaded newer image 即成功。
拉完记下版本,后续所有命令和源码都固定用这个 tag,不要用 latest,避免上游更新打断线上构建。
docker images --digests | grep android-build-box
1.4 查看下载进度
后台方式拉取时看不到百分比。 用 nohup docker pull > pull.log 这种写法,Docker 检测到输出不是终端就不打印进度条,日志里只在某一层状态变化时多写一行。满屏 Waiting 也不代表卡住——max-concurrent-downloads 限制同时只拉若干层,其余全部排队。
判断是否真在动,看这几个:
grep -c 'Download complete' /root/pull.log
grep -c 'Pull complete' /root/pull.log
du -sh /var/lib/docker; sleep 30; du -sh /var/lib/docker
cat /proc/net/dev | awk '/eth0|ens|em[0-9]|bond/ {print $2}'; sleep 5; cat /proc/net/dev | awk '/eth0|ens|em[0-9]|bond/ {print $2}'
docker system df
- 两个
du数值在涨、网卡字节数在涨,就是在正常下载。 - 网卡两次差值除以 5 再除以 1048576,就是当前 MB/s。20MB/s 以上属于正常,1~3MB/s 是源被限速,完全不动才需要处理。
grep -c的数字随时间增加,说明层在逐个完成。
真卡住的排查顺序:
df -h /var/lib/docker
ps -ef | grep [d]ocker pull
journalctl -u docker --since "10 min ago" --no-pager | tail -50
磁盘剩余不足 15GB 会直接写不进去,这是最隐蔽的一种停滞。日志里有大量 net/http: TLS handshake timeout 或 toomany requests 就是源的问题,回 1.2 换加速器。
已完成的层会保留,中断后重跑 docker pull 从剩下的层继续,不白下。
二、准备构建资源
2.1 创建目录
mkdir -p /www/wwwroot/apk-tools/wrapper
mkdir -p /www/wwwroot/apk-tools/builds
mkdir -p /www/wwwroot/apk-tools/gradle-cache
mkdir -p /www/wwwroot/apk-tools/data
mkdir -p /www/wwwroot/apk-tools/downloads
mkdir -p /www/wwwroot/apk-keys
data 存放构建锁、脱敏日志、限流计数;downloads 存放产物,均在站点目录之外,由 PHP 通过签名链接下发。
2.2 下载 Gradle Wrapper
cd /www/wwwroot/apk-tools/wrapper
wget https://raw.githubusercontent.com/gradle/gradle/v8.5.1/gradlew
wget https://raw.githubusercontent.com/gradle/gradle/v8.5.1/gradle/wrapper/gradle-wrapper.jar -O gradle-wrapper.jar
chmod +x gradlew
ls -l
gradle-wrapper.jar 应为 40KB 以上,只有几百字节说明下载到了 404 页面。
若 wget 拉不下来,手动下载这两个文件后通过宝塔上传:
- gradlew:https://raw.githubusercontent.com/gradle/gradle/v8.5.1/gradlew
- gradle-wrapper.jar:https://raw.githubusercontent.com/gradle/gradle/v8.5.1/gradle/wrapper/gradle-wrapper.jar
这里只需要两个文件。真正决定使用哪个 Gradle 版本的 gradle-wrapper.properties 由源码在每次构建时自动生成,版本号取自配置项 gradle_version。
2.3 生成签名证书
密码不写进源码,统一放在站点目录之外的 secrets 文件。
umask 077
KS_PASS=$(openssl rand -hex 16)
cat > /www/wwwroot/apk-tools/secrets.env <<EOF
KS_PASS=$KS_PASS
KEY_PASS=$KS_PASS
EOF
chmod 600 /www/wwwroot/apk-tools/secrets.env
docker run --rm -v /www/wwwroot/apk-keys:/out mingc/android-build-box
keytool -genkeypair -v
-keystore /out/release.jks
-alias release
-keyalg RSA -keysize 2048 -validity 10000
-storepass "$KS_PASS" -keypass "$KS_PASS"
-dname "CN=WebToApk, OU=Dev, O=MyOrg, L=City, ST=State, C=CN"
ls -l /www/wwwroot/apk-keys/release.jks
证书一旦对外发布并升级过版本就不能更换,换了签名老用户无法覆盖安装,务必异地备份。
2.4 权限
chmod 600 /www/wwwroot/apk-keys/release.jks
chmod -R 777 /www/wwwroot/apk-tools/builds
chmod 770 /www/wwwroot/apk-tools/downloads /www/wwwroot/apk-tools/data
usermod -aG docker www
systemctl restart php-fpm-74
证书属主是 root 且权限 600,PHP 以 www 身份读不到它,这是正常的:证书以文件方式只读挂载进容器,由容器内 root 完成签名,不需要 www 有读权限。
usermod -aG docker www 等于把 root 等价权限交给 web 进程。这台机器只跑这一个工具站时可以接受;与别的站点共用时不要加 docker 组,改用 sudo 白名单只放行固定的 docker run 命令。
三、宝塔配置
超时链必须单调递增,否则构建超时会由 Nginx 先切断,PHP 被杀但容器仍在后台运行,形成孤儿进程持续吃内存。
docker timeout 720 < PHP 840 < Nginx 900
3.1 PHP 7.4 启用禁用函数
宝塔 → 软件商店 → PHP 7.4 → 设置 → 禁用函数,删掉:
- exec
保存后重载配置。源码只用到 exec,shell_exec、putenv、proc_open 可以保留禁用状态。
3.2 PHP 7.4 超时与上传体积
宝塔 → PHP 7.4 → 性能调整:
- max_execution_time = 840
- request_terminate_timeout = 840
- memory_limit = 512M
- upload_max_filesize = 8M
- post_max_size = 16M
或命令行:
sed -i 's/^max_execution_time.*/max_execution_time = 840/' /www/server/php/74/etc/php.ini
sed -i 's/^memory_limit.*/memory_limit = 512M/' /www/server/php/74/etc/php.ini
sed -i 's/^upload_max_filesize.*/upload_max_filesize = 8M/' /www/server/php/74/etc/php.ini
sed -i 's/^post_max_size.*/post_max_size = 16M/' /www/server/php/74/etc/php.ini
request_terminate_timeout 在宝塔里通常位于 pool 配置文件,不在 php-fpm.conf 主文件。先确认实际位置,sed 匹配不到会静默无效:
grep -rn 'request_terminate_timeout' /www/server/php/74/etc/
systemctl restart php-fpm-74
宝塔 → 软件商店 → PHP 7.4 → 安装扩展,确认 gd 与 fileinfo 已安装。
3.3 Nginx 超时
宝塔 → 网站 → 你的站点 → 设置 → 配置文件,在 location ~ [^/].php(/|$) 里加:
fastcgi_read_timeout 900s;
client_max_body_size 16m;
保存 → 重载 Nginx。
3.4 站点目录
mkdir -p /www/wwwroot/你的域名/tool/web2app
产物目录不在站点内,无需为 downloads 开放任何 web 权限。若沿用旧版部署,删除站点下遗留的 downloads 目录,避免历史 APK 仍可被直接访问。
四、完整源码
路径:/www/wwwroot/你的域名/tool/web2app/index.php
配置区字段说明:
| 字段 | 作用 |
|---|---|
| wrapper_dir | 存放 gradlew 与 gradle-wrapper.jar 的目录 |
| builds_dir | 临时构建目录,请求结束即清理,异常残留由 GC 回收 |
| gradle_cache | 挂载为容器内 /root/.gradle,第二次构建提速的关键 |
| data_dir | 构建锁、脱敏日志、限流计数、GC 时间戳 |
| downloads_dir | APK 产物目录,必须在站点目录之外 |
| keystore | 签名证书路径 |
| env_file | 存放 KS_PASS、KEY_PASS、APP_SECRET,权限 600 |
| ks_pass / key_pass | 留空即从 env_file 读取,不要写死在源码里 |
| docker_img | 固定 tag,按 1.3 记录的结果填写 |
| gradle_version | 生成的 wrapper properties 使用的 Gradle 版本,见 6.1 |
| agp_version | Android Gradle Plugin 版本,需与 gradle_version 兼容 |
| java_home | 镜像默认 JDK 与 Gradle 不匹配时,填镜像内 JDK 17 路径 |
| gradle_xmx | Gradle JVM 堆上限,内存小的机器调低 |
| build_timeout | 容器构建硬超时,必须小于 PHP 与 Nginx 超时 |
| docker_mem / docker_cpus | 单次构建资源上限,防止拖死整机 |
| site_host | 建议填死自己的域名,留空则校验请求 Host |
| apk_ttl | 下载链接有效期,单位秒 |
| rate_per_day | 单 IP 每日打包次数上限 |
首次访问页面时顶部会列出缺失项,配置不完整不会进入构建流程。
五、启用 Gradle 缓存
为了让第二次之后编译只需 30 到 60 秒:
mkdir -p /www/wwwroot/apk-tools/gradle-cache
chmod -R 777 /www/wwwroot/apk-tools/gradle-cache
源码已把该目录挂载为容器内 /root/.gradle,目录建好即生效。缓存里同时保存 Gradle 分发包和全部依赖,是二次构建提速的唯一来源,不要清空。
六、测试
6.1 先确认版本匹配
这一步决定首次构建能否成功。Gradle 官方兼容性口径:Gradle 8.4 支持用 Java 21 编译,但运行 Gradle 本体需要 Java 21 时,必须 8.5 起才支持。而这个镜像的设计是持续跟随最新软件,JDK 版本不能凭记忆假设。
在服务器本机执行诊断面板,它只在来源地址为本机时输出:
curl -s 'http://127.0.0.1/tool/web2app/index.php?diag=1'
输出包含镜像 digest、镜像内 java 版本、build-tools 目录列表、可用 JVM 路径。按结果填写源码配置:
| java -version 结果 | gradle_version | 附加动作 |
|---|---|---|
| 17 | 8.4 或 8.5 | 保守填 8.5 |
| 21 | 必须 8.5 及以上 | 填 8.4 会报 Unsupported class file major version 65 |
| 22 或更高 | 8.8 及以上 | 同时把 agp_version 升到 8.5 以上,或把 java_home 指到镜像内 JDK 17 |
不确定时把 java_home 填成 diag 输出里的 JDK 17 目录,强制用 17 跑 Gradle,兼容性最稳。同时把 docker_img 从 latest 改为 diag 输出的固定 tag。
6.2 验证依赖下载速度
Docker 加速器只对 docker pull 生效,Gradle 分发包与 Maven 依赖是容器内另外走的网络,两者互不相干。源码已把 Maven 仓库指向阿里云、Gradle 分发包指向腾讯云,确认连通:
docker run --rm mingc/android-build-box bash -lc
'curl -m 10 -so /dev/null -w "gradle %{http_code} %{time_total}sn" https://mirrors.cloud.tencent.com/gradle/gradle-8.5-bin.zip;
curl -m 10 -so /dev/null -w "maven %{http_code} %{time_total}sn" https://maven.aliyun.com/repository/google/'
返回 404 说明该版本号在镜像站上不存在,换版本号或临时回退官方源。
6.3 首次构建
- 浏览器打开
https://你的域名/tool/web2app/ - 输入
https://www.baidu.com - 上传一张真 PNG 图标,512×512 最佳,不要用 .ico
- 点生成 APK
首次 3 到 8 分钟,之后 30 秒到 1 分钟。成功后页面显示打包成功、下载 APK 按钮、复制下载链接按钮、图标状态。下载链接带签名与过期时间,24 小时后失效,返回 403 属正常。
6.4 查看构建进度
构建是同步跑在容器里的,页面只有一个计时器,服务端这边可以用下面几条看实时状态。另开一个终端窗口执行:
watch -n 2 'docker ps --format "{{.Image}} {{.Status}} {{.RunningFor}}"'
有一行 mingc/android-build-box Up xx seconds 就说明正在编译,Up 后面的时间是已运行时长。
看资源占用,判断是不是卡在内存不够:
docker stats --no-stream
free -h
docker stats 里内存列接近你设的 docker_mem 上限、且 free -h 的 available 见底,就是内存吃紧,Gradle 会被拖慢甚至 OOM。
看构建目录有没有在长东西:
du -sh /www/wwwroot/apk-tools/builds/*/ 2>/dev/null
ls -lR /www/wwwroot/apk-tools/builds/*/app/build/outputs/apk/release/ 2>/dev/null
出现 app-release.apk 就说明编译已经完成,正在等 PHP 收尾。
看缓存是否正在建立,首次构建期间这个目录会明显变大,长到 1GB 以上说明依赖已下全:
du -sh /www/wwwroot/apk-tools/gradle-cache
日志只在失败时生成,成功不写盘。构建返回失败后按时间取最新一份:
ls -lt /www/wwwroot/apk-tools/data/ | head
tail -60 /www/wwwroot/apk-tools/data/build-最新那个文件名.log
日志里的 CMD 已经把密码替换成星形,可以放心查看和转发。
判断是否真卡死:build_timeout 设了 720 秒,到点 timeout 会强杀容器并让 PHP 返回”构建超时”。所以最长等 12 分钟必有结果,docker ps 里没有容器而页面还在转,就是 PHP 那边已经返回、前端没收到响应,刷新页面即可。
6.5 常见失败对照
| 现象 | 原因与处理 |
|---|---|
| 页面顶部黄框列出缺失项 | 按条目补齐,不会进入构建 |
| Unsupported class file major version | JDK 与 Gradle 不匹配,回 6.1 |
| 构建超时被强制终止 | 内存或 CPU 不足,或首次依赖下载过慢 |
| 504 Gateway Timeout | Nginx 超时小于 PHP 或 docker timeout,检查超时链顺序 |
| Permission denied 写产物 | builds 与 downloads 目录权限,见 2.4 |
| 打包成功但手机拒绝安装 | v2 签名为 false,见第七节 |
| 第二次构建仍然很慢 | gradle-cache 没挂上或目录为空,用 du -sh 确认 |
七、验证签名
build-tools 版本随镜像更新,不要照抄固定版本号,先取镜像内最新版本:
BT=$(docker run --rm mingc/android-build-box bash -lc 'ls /opt/android-sdk/build-tools/ | sort -V | tail -1')
echo "build-tools = $BT"
cd /www/wwwroot/apk-tools/downloads/
F=$(ls -t *.apk | head -1)
docker run --rm -v "$PWD":/apks mingc/android-build-box
bash -c "/opt/android-sdk/build-tools/$BT/apksigner verify --verbose "/apks/$F""
预期输出:
Verifies
Verified using v1 scheme (JAR signing): true
Verified using v2 scheme (APK Signature Scheme v2): true
两个 true 就是可以安装的。targetSdk 34 的包在 Android 11 及以上必须有 v2 签名,v2 为 false 时新系统会直接拒绝安装。取最新 APK 用 ls -t 而不是 ls,后者按字典序返回,多文件时会验错对象。
八、文件清单
| 路径 | 说明 |
|---|---|
| /www/wwwroot/apk-tools/wrapper/gradlew | Gradle Wrapper 脚本 |
| /www/wwwroot/apk-tools/wrapper/gradle-wrapper.jar | Gradle Wrapper JAR |
| /www/wwwroot/apk-tools/builds/ | 临时构建目录,自动清理 |
| /www/wwwroot/apk-tools/gradle-cache/ | Gradle 缓存,第二次之后提速 |
| /www/wwwroot/apk-tools/data/ | 构建锁、脱敏日志、限流计数 |
| /www/wwwroot/apk-tools/downloads/ | APK 产物,非 web 可访问 |
| /www/wwwroot/apk-tools/secrets.env | 签名密码与链接签名密钥,权限 600 |
| /www/wwwroot/apk-keys/release.jks | 签名证书,权限 600,需异地备份 |
| /www/wwwroot/你的域名/tool/web2app/index.php | 主页面与构建入口 |
九、日常维护
源码内置 GC,每次请求触发,节流 15 分钟,清理卡死超过 2 小时的构建目录与过期 APK。低峰期再补一层计划任务兜底。
宝塔 → 计划任务 → Shell 脚本,每天执行:
find /www/wwwroot/apk-tools/downloads -name "*.apk" -mtime +7 -delete
find /www/wwwroot/apk-tools/data -name "build-*.log" -mtime +30 -delete
find /www/wwwroot/apk-tools/builds -maxdepth 1 -name "app_*" -mmin +120 -exec rm -rf {} +
docker image prune -f
df -h /www
镜像更新不要自动进行。每次手动更新后重跑 6.1 诊断,确认 JDK 与 build-tools 版本没有变化,再改 docker_img 的固定 tag。
附:安全加固与合规
源码已内置的防护:URL 严格校验并拒绝回环、私网与保留地址;所有外部参数经 escapeshellarg;构建命令带硬超时与容器资源上限;flock 并发闸门保证同时只有一个构建;单 IP 日限流;失败日志脱敏、权限 600 且不落在 /tmp;产物移出站点目录并走签名时效链接;上传图标经 GD 解码后重编码;Host 头白名单校验;生成的 APK 关闭文件访问、按站点协议收紧混合内容、关闭备份、明文流量仅在 http 站点放开。
运维侧还需要补的:
- Nginx 给该路径加
limit_req zone=apk burst=3 nodelay; - 站点开启 HTTPS,APK 下载链接同样走 HTTPS
data目录日志保留 30 天,配合 access log 满足可追溯要求- 建议把 PHP 升到 8.1 或 8.2,7.4 已于 2022 年 11 月停止安全更新,源码在 7.4 与 8.x 均可运行
- 与其他站点共用一台机器时,撤掉 docker 组授权,改走 sudo 白名单
💬 评论区 (0条评论)