隐盾 PackTool 使用说明
在线文档（图文版）：https://cangip.cn/guide/

本工具在 Windows 上对游戏客户端（Windows / 安卓 APK / iPhone IPA）做加密打包与 IP 隐藏，
并生成运营所需的部署与交付文件。


【开始使用】

双击 PackTool.exe 即可 —— 文件夹里只有这一个需要你手动打开，其余文件都是程序自动调用的。
首次启动自动赠送 3 天试用，不用注册、不用付款，顶栏显示「● 已授权（剩 3 天）」就能开始打包。


【环境要求】

本机需安装 Java 8+ 并配置到系统 PATH。安卓打包与自动检测所需的签名/探测工具（apksigner、
zipalign、LaunchTrace 等）已随工具自带，放在 tools/ 与程序同目录，无需另装 Android SDK。


一、激活与购买

1. 顶栏右侧状态：
   「● 已授权（剩 N 天）」= 可用；
   「● 未激活」= 本机已用过试用，需要购买授权码。
2. 购买：点右上角「授权管理」→ ① 选套餐　② 扫码付款　③ 点「已支付」登记订单。
   客服核对付款后自动发码并激活，不用你手动操作。
3. 已有授权码：在「已有授权码」处粘贴后点「激活」。
4. 试用版与正式版功能完全相同，只差天数。


二、选择平台

侧栏顶部切换「Windows / Android / iPhone」。后续步骤会按所选平台显示对应字段。


三、第 1 步：加密打包

【Windows 模式】
1. 游戏客户端目录：浏览选择游戏所在文件夹。
2. 游戏入口（启动文件）：填写主程序 exe 路径，可点「自动检测」识别启动类型并探测真实地址。
3. 游戏名称：填写你自己的游戏名字。
4. 排除规则（可选）：不打包的文件或文件夹，例如存档。
5. 输出目录：产物存放目录。
6. （可选）仅加密游戏登录器 / 客户端加壳·自校验：按需勾选。

【Android 模式】
1. 源 APK 文件：浏览选择要打包的 APK。
2. 输出目录：产物目录。

【iPhone / iPad 模式】
本工具只做注入、不签名：把隐藏 IP 的模块注入你给的 IPA，输出一个未签名 IPA。
签名由你自己完成 —— 我方不持有任何 Apple 账号，也完全不接触你的证书。

1. 源 IPA 文件：必须是已脱壳的包（App Store 下载的正版包是加密的，注入进去无效）。
2. 隐藏 dylib：留空即可，自动使用包内 tools/ 自带那份。
3. 输出目录：产物目录。
4. 游戏名必须填 —— 它决定这次出包扣几款游戏的配额；同一款游戏三平台填同名只算 1 款。

产物名为 原名_hide_unsigned.ipa（未签名，不能直接装）。输出目录还会多出一个 relay/ 子目录
（中继套件），只做 iOS 的客户靠它就能跑起来，照里面「中继部署说明.txt」做即可，
防火墙只放通 TCP（iOS 是纯 TCP，不用开 UDP）。

签名怎么做（三选一，都由你自己操作）：
- 第三方签名工具：轻松签 / ESign / 爱思助手 / Sideloadly，导入你的证书后对本包签名；
- 命令行：包内 tools/zsign.exe，需要你自己的 p12 + mobileprovision；
- 越狱设备可用 TrollStore 直接安装（不需要证书）。

⚠ 三点必须知道：
1) 签名工具必须把 Frameworks 里的 applock_hook_ios.dylib 一起重签，否则 iOS 会拒绝加载它，
   表现为「游戏能正常打开、但 IP 完全没有隐藏」——从现象上看不出来。签完装好后务必实测确认。
2) 免费 Apple ID 签的包 7 天到期；个人开发者账号 ad-hoc 分发每台设备都要登记 UDID，一年只有
   100 台额度；企业证书不限设备但会被 Apple 吊销。
3) 隐藏能力有有效期：到期时间 = 你的 PackTool 授权到期时间。到期后停止隐藏 IP，但游戏本身
   照常能玩（不会闪退、不会连不上），与 Windows / 安卓的做法一致。

完成后点「下一步：IP与端口 →」。


四、第 2 步：IP 与端口

- Windows：每行填写一个要隐藏的真实服务器地址，格式 ip:端口，多个用 ; 或换行分隔。
  ⚠ 必须写全 ip:端口，只填 IP 会打包报错。
- Android：格式与 Windows 相同。填写后游戏连到这些地址会被强制改写成壳内诱饵地址，连玩家
  本机装抓包工具也看不到真实 IP；留空 = 仅隧道模式（对外完全隐藏，物理网卡抓不到真实 IP 的
  包），但本机工具仍能看到「连了哪个地址」。

完成后点「下一步：服务与密钥 →」。


五、第 3 步：服务与密钥

1. 后台服务器（发放 CDK）（可选）：填写你自己的服务器地址（域名或IP:端口）。仅做先玩后买 /
   卖时长授权、不发 CDK 时可留空。
2. 启用远程中继（推荐开启）：勾选后填写中继地址（可 1~20 台，格式 地址:端口，多台用 ; 分隔）
   与中继接入令牌 token（与中继服务器一致，留空则不校验）。
3. 管理令牌 admin_token / 后台密码：部署后台时使用的管理员凭据，可点「随机」生成。

完成后点「下一步：部署到服务器 →」。


六、第 4 步：部署到服务器（仅当你自己部署后端 / 中继时）

1. 点「生成部署包（backend/ 目录）」，会在输出目录产出后端部署包。
2. 将部署包拷贝到你的服务器完成部署；部署后点「重新探活」，在左侧「远端服务」查看状态。
3. 说明：后端与中继都由你部署到自己的服务器，本工具只负责产出部署包与探活。

完成后点「下一步：试用与交付 →」。


七、第 5 步：试用与交付

1. 客户端试用时长（天）：这是你给「玩家」的试用天数，与本工具自身的 3 天试用无关。
   玩家启动即开始计时（无需兑换码、无需先买）；填 0 表示无试用，玩家必须激活才能进入。
2. 点右下角「开始打包」。日志显示在下方信息框，过程中可随时「终止」（自动清理半成品）。
3. 完成后点「打开输出目录」查看产物。


八、交付给玩家

- Windows：只发送 开始游戏.exe + payload.bin 两个文件，放在同一目录、不要改名。
- Android：只发送 APK 文件，不要改名。
- 若你部署了中继，输出目录里的 relay/ 文件夹是中继服务器所需文件，单独交给运维人员，
  不要发给玩家。
- 若你部署了后台并发 CDK，把生成的兑换码发给玩家，玩家在游戏内激活即可。


九、发放 CDK / 卡密管理（侧栏底部独立功能，可选）

1. 点侧栏底部「◇ 发放 CDK / 卡密管理」。
2. 填写管理员令牌 admin_token（与第 3 步一致）。
3. 生成兑换码（48 位，12 组 × 4），支持绑机、吊销、解绑。
4. 只有当你部署了后台并发 CDK 时才需要用到此功能。


十、中继服务器（打包完成后在输出目录的 relay/ 文件夹里）

第 3 步填了「中继地址」后，每次打包完成，输出目录里都会生成 relay/ 文件夹，内含：
中继主程序（Windows 免装 Python 的 exe 64/32 位 + Linux 用的 .py 源码版）、
一键架设脚本（setup_relay.bat / .ps1 / .sh）、已按你这次填写生成好的 relay_config.json，
以及「中继部署说明.txt」（含环境要求与安全提醒）。

部署照 relay/中继部署说明.txt 做，三步：
① 整个 relay/ 文件夹上传到中继服务器（配置与程序要在同一目录）
② Windows 双击 setup_relay.bat；Linux 执行 sudo bash setup_relay.sh
③ 在云服务器安全组/防火墙放通配置里的端口（默认从 7890 开始）

relay_config.json 每次打包都会按你填的内容重新生成；换了地址或端口后，用新生成的文件覆盖
服务器上的旧文件并重启中继。relay/ 里的文件是给你和运维用的，不要发给玩家。


---
在线文档（含界面截图与常见问题）：https://cangip.cn/guide/
技术支持：cangip.cn 官网右下角联系方式
本说明仅描述操作步骤，不含任何内部配置或密钥信息。
