ZXSign

贴牌授权系统

提供证书站或UDID签名站最好的贴牌APP

下载贴牌接口文档

Ps：本贴牌会上报 UDID 设备和签名日志到后台，仅供修复 BUG 使用，无其他隐私侵犯

提交域名授权

填写域名与联系邮箱，立即激活授权

⚡

极速签名

大文件 IPA 十多秒即可完成签名，大幅缩短等待时间，批量出包更高效。

🎯

新手模式

简化签名流程，降低上手门槛，进入就一个下载没其他功能

📢

软件源横幅广告

版本号中输入 ☆广告☆ 可自动转换为软件源横幅，灵活展示推广内容。

📜

自动导入证书

自动拉取并导入可用证书与描述文件，无需手动下载配置，签名更省心。

📱

自动识别 UDID

自动识别设备 UDID，快速匹配可用证书，减少手动填写与出错。通用识别ipa里面的描述文件获取，zsign签名会自动写入的无需配置

🔒

可扩展时间锁

贴牌时可按需开启时间锁，注入 zsign.dylib 并对接校验接口，灵活控管设备。

✨

高级功能

IPA 签名时可开启自适应 120Hz、iPad 全屏、iOS 26 系统玻璃等高级特性，体验更完整。

🧩

LoadControl 插件管理

可启用 LoadControl 插件管理功能，灵活管控注入插件；仅绿泡泡有效哦。

⌚

自带组件签名

支持 IPA 内置组件一并签名，如手表组件、灵动岛组件、Widget 等，签名后可正常安装使用。

API 对接文档

以下为示例模板，自己站点适配

1. IPA 贴牌打包

贴牌时在 /Payload/ZXSign.app/ 内一并处理：写入授权域名、修改应用名与 Bundle ID、替换贴牌图标、写入启动图，然后重签名打包。

操作时机	IPA 解压 → 贴牌修改 → 重签名 → 打包
config.plist	`/Payload/ZXSign.app/config.plist` · 写入 `cert_api_base_url`
Info.plist	`/Payload/ZXSign.app/Info.plist` · 修改应用名、Bundle ID
贴牌图标	替换 `AppIcon.png` / `icon.png`，并写入 `brand_icon*.png` 等
启动图	`/Payload/ZXSign.app/UpdateBg.png`
授权域名	`授权域名`（须带 `https://`你授权的域名哦别填我这个）

config.plist 示例

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>cert_api_base_url</key>
	<string>https://zsign.pkq7.cn</string>
</dict>
</plist>

授权域名记得带 https://，不要只写裸域名。

Info.plist 主要修改字段
CFBundleDisplayName — 应用显示名称（贴牌名）
CFBundleIdentifier  — Bundle ID（包名）
CFBundleIcons         — 替换图标后更新为 brand_icon 系列（可选）

说明
授权域名仅写入 config.plist
应用名、Bundle ID、图标、启动图为可选，按需传入
图标会替换现有 AppIcon/icon 文件，并强制写入 brand_icon 系列
启动图固定写入 /Payload/ZXSign.app/UpdateBg.png
修改完成后 zsign 重签打包即可

2. 贴牌时间锁（可选）

如需启用时间锁，在 /Payload/ZXSign.app/ 根目录写入 zsign.txt，并在使用 zsign 重签打包 IPA 时通过 -l 参数注入 zsign.dylib 插件。客户端运行时按 zsign.txt 中的地址请求时间锁接口校验设备状态。

是否必须	否，不需要时间锁可跳过
zsign.txt	写入 `/Payload/ZXSign.app/zsign.txt`
zsign.dylib	zsign 打包时用 `-l` 注入，非手动复制
zsign.txt 内容	时间锁校验 URL，如 `授权域名/api/sign/zxudid?udid=设备UDID`
校验接口	`GET 授权域名/api/sign/zxudid`

参数名	类型	必填	说明
udid	string	是	设备 UDID
appbundileid	string	否	App Bundle ID，如 `com.zx.sign`（注意字段拼写）
daixiao	string	否	代销站点标识，打包时写入 zsign.txt

zsign.txt 示例
'授权域名/api/sign/zxudid?udid=00008120-001E24C20138C01E'

PHP 写入 zsign.txt和注入dylib例子
function write_zsign_txt(string $appDir, string $hostDomain, string $udid = '', string $shortSite = ''): ?string
{
    $host = trim($hostDomain);
    if ($host !== '') {
        $host = explode(':', $host)[0];
    }
    if ($host === '') {
        return null;
    }

    $daixiaoParam = '';
    if (trim($shortSite) !== '') {
        $daixiaoParam = '&daixiao=' . rawurlencode(trim($shortSite));
    }

    $content = 'https://' . $host . '/api/sign/zxudid?udid=' . trim($udid) . $daixiaoParam;
    $targetPath = $appDir . '/zsign.txt';

    if (file_put_contents($targetPath, $content) === false) {
        throw new RuntimeException('写入 zsign.txt 失败: ' . $targetPath);
    }

    chmod($targetPath, 0644);
    return $targetPath;
}

// 调用示例：先写 zsign.txt，再用 zsign 注入 dylib 并重签
$appDir = '/tmp/Payload/ZXSign.app';
write_zsign_txt($appDir, 'zsign.pkq7.cn', '00008120-001E24C20138C01E');

// zsign 打包时注入 zsign.dylib（-l 参数）
// zsign -k cert.p12 -p 密码 -m profile.mobileprovision -l /path/to/zsign.dylib -o signed.ipa input.ipa

贴牌时间锁完整流程（可自行补充）
解压 IPA → /Payload/ZXSign.app/
写入 config.plist（授权域名）
写入 zsign.txt（时间锁校验 URL，可选）
zsign 重签打包，加 -l zsign.dylib 注入时间锁插件
安装测试，客户端会请求 /api/sign/zxudid 校验设备状态

时间锁接口 · 请求示例 如何控制接口那是你站点的事情哦 自己想办法开启和关闭这个接口的返回值
GET /api/sign/zxudid?udid=00008120-001E24C20138C01E&appbundileid=com.zx.sign HTTP/1.1
Host: zsign.pkq7.cn
Accept: */*
User-Agent: 知行签/9727 CFNetwork/1402.0.8 Darwin/22.2.0

正常响应（code=1）
{
  "code": 1,
  "msg": "请求成功",
  "data": null,
  "time": "1780133316"
}

设备禁用（code=0）
{
  "code": 0,
  "msg": "设备已被禁用，请联系",
  "data": null,
  "time": "1780133380"
}

设备到期/掉签（code=0）
{
  "code": 0,
  "msg": "设备已掉签，请续费",
  "data": null,
  "time": "1780133419"
}

接口参数说明（可自行补充）
udid          — 设备 UDID（必填）
appbundileid  — App Bundle ID（必填，注意字段名拼写）
daixiao       — 可选，代销站点标识（写入 zsign.txt 时通过 &daixiao= 附带）

code=1  — 校验通过，设备可用
code=0  — 校验失败，msg 说明原因（禁用 / 掉签续费等）

zsign.txt 写入见  · dylib 通过 zsign -l 注入

3. 获取配置

客户端启动时调用，根据 App Bundle ID 获取贴牌配置（图标、名称、源地址、公告等）。

接口地址	`授权域名/api/signtool/index`
请求方式	POST
Content-Type	`application/x-www-form-urlencoded; charset=utf-8`

参数名	类型	必填	说明
app_bundle_id	string	是	App Bundle ID，如 `com.zx.sign`

请求示例
POST /api/signtool/index HTTP/1.1
Host: 授权域名

Content-Type: application/x-www-form-urlencoded; charset=utf-8
User-Agent: ZXSign/9698 CFNetwork/1402.0.8 Darwin/22.2.0

app_bundle_id=com.zx.sign

成功响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "app_bundle_id": "com.zx.sign", //appBundleId
    "domain": "授权域名",
    "shaguamoshi": 1, //是否开启新手模式
    "time": 1, //是否开启时间锁注入
    "timeinhibit": "com.tencent.xin,com.tencent.xin4", //不注入时间锁的包名
    "config": {
      "app_icon_url": "授权域名/uploads/images/xxx.png", //app图标
      "app_name": "知行签", //app名称
      "app_source_urls_qx": true,
      "buy_url": "", //购买地址
      "contact_url": "", //联系方式
      "default_app_source_urls": "https://*****/appstore", //软件源地址
      "exchange": false,
      "group": "",
      "import_permissions": false,
      "notice": "这是公告", //公告
      "plist_url": "授权域名/sign_plist.php", //plist地址
      "tutorial_url": "", //教程地址
      "whitelist": false 
    }
  }
}

响应字段说明（可自行补充）
code          — 1 表示成功
msg           — 提示信息
data.domain   — 当前站点域名
data.config   — 贴牌配置（图标、名称、源地址、公告、plist 地址等）
data.shaguamoshi / time / timeinhibit 
-shaguamoshi 1=开启 0等于关闭  开启新手模式
-time 1=开启 0等于关闭 是否开启时间锁注入
-timeinhibit 时间锁注入排除的包名 ,分割号

4. 获取可用证书

根据设备 UDID 查询该设备可用的描述文件与证书信息。

接口地址	`授权域名/api/signtool/udid`
请求方式	POST
Content-Type	`application/x-www-form-urlencoded; charset=utf-8`

参数名	类型	必填	说明
udids[]	array	是	设备 UDID 数组，如 `00008120-0000000000000E`

请求示例（抓包原文）
POST /api/signtool/udid HTTP/1.1
Host: zsign.pkq7.cn
Content-Type: application/x-www-form-urlencoded; charset=utf-8
User-Agent: ZXSign/1.0.7.1 (com.zx.sign; build:9727; iOS 16.2.0) Alamofire/5.11.0

udids[]=00008120-0000000000000E

cURL 调用示例
curl -X POST "授权域名/api/signtool/udid" \
  -H "Content-Type: application/x-www-form-urlencoded; charset=utf-8" \
  -d "udids[]=00008120-0000000000000E"

成功响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code": 0,
  "msg": "成功",
  "time": 1780131647,
  "data": {
    "profiles": [
      {
        "uuid": "52753285-93dd-4de4-91dd-218d9e7803e7",
        "profile_id": "TW07TP",
        "name": "00008120-0000000000000E",
        "status": "正常",
        "using": true,
        "expiration_date": "2027-05-25T11:49:58Z",
        "devices": ["00008120-0000000000000E"],
        "certificate": [
          {
            "id": "TW07TP",
            "name": "QI Wu",
            "country": "US"
          }
        ]
      }
    ]
  }
}

响应字段说明
code              — 0 表示成功
msg               — 提示信息
time              — 服务器时间戳
data.profiles     — 可用描述文件列表
  .uuid           — 描述文件 UUID
  .profile_id     — 描述文件 ID
  .status         — 状态，如「正常」
  .using          — 是否正在使用
  .expiration_date — 过期时间（ISO 8601）
  .devices        — 绑定的 UDID 列表
  .certificate    — 关联证书信息（id / name / country）

5. 获取证书文件

根据描述文件 ID 下载 mobileprovision 与 p12 证书（Base64 编码）。

接口地址	`授权域名/api/signtool/getcertificate`
请求方式	POST
Content-Type	`application/x-www-form-urlencoded; charset=utf-8`

参数名	类型	必填	说明
profile_id	string	是	描述文件 ID，来自「获取可用证书」接口的 `profile_id`，如 `TW07TP`

请求示例（抓包原文）
POST /api/signtool/getcertificate HTTP/1.1
Host: zsign.pkq7.cn
Content-Type: application/x-www-form-urlencoded; charset=utf-8
User-Agent: ZXSign/1.0.7.1 (com.zx.sign; build:9727; iOS 16.2.0) Alamofire/5.11.0

profile_id=TW07TP

成功响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code": 0,
  "msg": "成功",
  "data": {
    "mobileprovision": "MIJIWAYJKoZIhvcNAQ··························D36c/38PiNh5PX/4DON3ekcTQA=",
    "p12": "MIIMkQIBAzCCDEEGCSqGSIb3DQEHAaC························7sqEbHoDAQQuvXPGlo/z7/1VFEEh0up9QICCAA=",
    "p12_password": "1"
  }
}

响应字段说明（可自行补充）
code              — 0 表示成功
msg               — 提示信息
data.mobileprovision — 描述文件内容（Base64），解码后为 .mobileprovision
data.p12          — P12 证书内容（Base64），解码后为 .p12
data.p12_password — P12 证书密码

6. 获取企业证书

获取企业证书列表，返回 p12 / 描述文件下载地址及密码等信息。

接口地址	`授权域名/api/cert/index`
请求方式	GET

成功响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "code": 1,
  "message": "ok",
  "data": [
    {
      "id": 2,
      "name": "XL AXIATA.p12",
      "password": "lewan",
      "note": "已失效",
      "p12_url": "授权域名/api/cert/download/2/p12",
      "mobileprovision_url": "授权域名/api/cert/download/2/mobileprovision",
      "update_time": 1779813147
    }
  ]
}

响应字段说明（可自行补充）
code                 — 1 表示成功
message              — 提示信息
data[]               — 企业证书列表
  .id                — 证书 ID
  .name              — 证书名称
  .password          — P12 密码
  .note              — 备注/状态，如「已失效」
  .p12_url           — P12 下载地址
  .mobileprovision_url — 描述文件下载地址
  .update_time       — 更新时间戳