【正式发布】果查 DevicePick v1.0.5 上线｜专业级 iOS 设备工具箱 支持免费私有化部署

经过完整开发与测试，专业级 iOS 设备工具平台「果查 DevicePick」正式发布 v1.0.0 初始版本。项目采用 Go 语言构建后端服务，Vue 框架搭建前端交互，整套工具支持免费私有化部署，面向 iOS 签名、设备管理场景提供一站式工具能力。

一、核心功能模块

1. 已上线功能：

1. UDID获取
2. iTunes商店搜索
3. UDID查询
4. 证书改密码
5. 签名描述文件
6. 企业证书共享
7. Apple共享ID
8. P12证书检测描述
9. 在线签名IPA
10. 签名工具安装

2. 全功能管理后台

v1.0.0 内置完整管理后台体系，包含安装向导、基础配置面板、系统监控、鉴权上传等管理能力，支持站点导航、标题、备案信息、页脚等自定义配置，适配不同部署场景的品牌化需求。

二、演示图片效果

演示站：https://iostools.ahfi.cn/#/

前台演示效果

后台演示效果

三、搭建部署

前期准备

1. 已安装 宝塔 Linux 面板 的服务器
2. 项目压缩包：GuoCha_release_1.0.0.zip
3. 已解析完成的域名，准备申请 SSL 证书

步骤 1：网站根目录创建项目文件夹

1. 登录宝塔面板，左侧菜单点击 文件
2. 进入路径：/www/wwwroot/
3. 点击【新建】，创建文件夹命名：GuochaDevicePick

步骤 2：上传程序压缩包并解压

1. 双击进入刚刚创建的 GuochaDevicePick 文件夹
2. 点击【上传 / 下载】，上传安装包 GuoCha_release_1.0.0.zip
3. 勾选上传完成的 zip 文件，右键选择 解压，释放程序源码

步骤 3：在宝塔创建 MySQL 数据库

1. 左侧菜单栏选择 数据库 → 点击【添加数据库】
2. 填写信息：
   • 数据库名：自定义内容
   • 用户名：自定义内容
   • 设置自定义数据库密码
   • 字符集选择：utf8mb4
   • 访问权限：本地服务器
3. 点击【确定】完成数据库创建，保存好数据库账号密码

步骤 4：宝塔面板添加 Go 项目服务

1. 左侧菜单点击 网站，切换标签页到 Go 项目
2. 点击【添加项目】，打开配置弹窗

Go 项目详细配置参数

1. 项目执行文件：选择路径 /www/wwwroot/GuochaDevicePick/server
2. 项目名称：自定义填写 server
3. 项目端口：填写 8080，勾选「放行端口」
4. 执行命令：填写执行文件完整路径 /www/wwwroot/GuochaDevicePick/server
5. 运行用户：www
6. ✅ 开机自动启动（勾选）
7. 绑定域名：填入你解析好的域名
8. 点击【确定】创建 Go 服务

步骤 5：部署 SSL 证书（HTTPS 强制）

⚠️ 重要要求：项目必须配置 SSL 证书

1. 在网站项目列表找到刚才创建的 GuochaDevicePick
2. 点击右侧 SSL 证书（未部署）
3. 申请 Let’s Encrypt 免费 SSL 证书并部署，开启 HTTPS 访问

步骤 6：访问域名，执行系统安装向导

1. 在浏览器输入绑定好域名（https 域名），打开系统安装页面
2. 填写数据库连接信息：
   • 数据库地址：127.0.0.1
   • 端口：3306
   • 数据库名：自己创建的
   • 用户名：自己创建的
   • 密码：填写刚刚创建数据库设置的密码
   • 字符集：utf8mb4
3. 点击【测试连接】，提示连接成功后，点击【下一步】
4. 设置后台管理员账号密码，完成最后一步安装，项目部署完毕

完整流程总结

创建站点目录 → 上传解压源码 → 创建 MySQL 库 → 新建 Go 项目配置端口与开机自启 → 配置 SSL 证书 HTTPS → 浏览器访问填写数据库完成初始化安装

四、下载源码

微信扫一扫，获取下载地址

首次使用必操作

设备管理‑Build 号 操作流程

一、进入页面

左侧菜单栏点击 设备管理 → Build 号，进入 Build 号维护页面。

作用：维护系统 Build 编号与 iOS 系统版本的映射关系；UDID 获取功能会优先读取本地这份数据库。

二、一键同步获取 Build 号

1. 点击页面右上角绿色按钮 一键获取
2. 系统自动拉取最新苹果 Build 版本数据，批量写入本地数据库完成同步。

设备管理‑设备标识符 操作流程

一、进入页面

左侧菜单栏点击 设备管理 → 设备标识符，进入设备型号映射页面。

作用：维护 iPhone /iPad 硬件标识符和设备中文显示名称，解析 UDID 后展示用户手机设备型号。页面上方支持切换 iPhone / iPad 两个分类标签。

二、一键获取设备标识符

1. 点击页面右上角绿色 一键获取 按钮
2. 程序远程拉取全部 iPhone、iPad 硬件标识符数据，自动同步存入本地库。

UDID 获取 – 描述配置操作流程

一、进入页面

左侧菜单依次打开：工具列表 → UDID 获取，切换到上方标签页 描述配置。 右侧可以实时预览手机端安装弹窗效果。

二、基础文案自定义（展示内容）

1. 组织名称：填写授权副标题，示例：Apple UDID 授权
2. 显示名称：填写配置文件主标题，示例：安装 UDID 获取描述
3. 描述说明：填写引导提示文字，告知用户安装操作方式，右侧预览框会实时同步效果。

三、签名描述开关（核心选项）

可自主选择是否开启签名

1. 开关【开启后生成的.mobileconfig 将使用 p12 签名】
   • 关闭状态（不签名）：无需上传证书，最终手机安装弹窗签名者显示为 未签名
   • 开启状态（需要签名）：必须填写证书信息，签名完成后手机端会显示 已验证

四、开启签名后的完整配置步骤

1. 打开「签名描述」开关
2. 点击 上传 p12，选择一份有效的 P12 证书文件上传
3. 在「证书密码」输入框，填写该 P12 证书对应的密码
4. 联调测试
   • 检测状态：调用前面配置好的 API 接口，校验当前 P12 证书是否可用有效
   • 签名描述测试：调用远程签名接口，测试能否正常生成已签名的描述文件（依赖「系统配置 – API 配置」中填写好的 Token）

五、保存配置

全部参数设置完成后，点击右上角蓝色按钮 保存配置，UDID 描述文件配置立即生效。

效果区分说明

配置模式	手机弹窗签名状态	前置要求
关闭签名描述	签名者：未签名	无需上传 P12 证书
开启签名描述	签名者：已验证	上传有效 P12 证书 + 证书密码 + 提前配置好 API Token

前置依赖提醒

签名功能正常使用的前提：提前在 系统配置 → API 配置 页面填好两组接口地址与 Token（api‑a1x5fpb2yq9wvj），否则签名测试无法正常执行。

测试验证方法

保存配置后，生成 UDID 获取链接，用苹果手机打开安装配置文件，观察弹窗内「签名者」字段，核对是否和预期效果一致。