部署与升级 APK Ref Injector

服务目录

安装器默认使用：

/etc/apk-ref-injector/config.yaml
/var/lib/apk-ref-injector/

服务以专用用户运行。只有安装和生命周期命令需要 root。

在前面配置 HTTPS

让服务监听本机端口，再通过反向代理对外提供 HTTPS。Nginx 示例：

server {
    listen 443 ssl http2;
    server_name apk.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-Host $http_host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

请转发原始 Host 和协议，确保代理后的 Console 登录正常。

HTTPS 环境请在配置中启用安全 Cookie：

console:
  secure_cookie: true

纯 HTTP 环境不要启用，否则浏览器不会发送会话 Cookie。

备份

备份配置和数据目录：

sudo tar czf apk-ref-injector-backup.tgz \
  /etc/apk-ref-injector \
  /var/lib/apk-ref-injector

请把备份保存在主机之外。数据目录包含数据库、上传的 APK 和图标。

升级

备份配置和数据。
用新版本替换可执行文件。
重启服务。
检查 Console 和一次测试下载。

安装后的可执行文件通常位于 /opt/apk-ref-injector/apk-ref-injector：

sudo install -m 0755 ./apk-ref-injector /opt/apk-ref-injector/apk-ref-injector
sudo apk-ref-injector restart
sudo apk-ref-injector status

升级不会覆盖已有配置和数据。如果启动失败，请查看服务日志并恢复旧的可执行文件。

卸载

sudo apk-ref-injector stop
sudo apk-ref-injector uninstall