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

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

一、核心功能模块

1. UDID 获取（已上线）

通过一键安装描述文件的方式，获取iOS系统上面的UDID设备码。

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 硬件标识符数据，自动同步存入本地库。

DevicePick｜配置操作文档

API 配置

一、进入配置页面

1. 左侧菜单栏找到 系统配置，展开子菜单，点击 API 配置，进入接口配置界面。

当前页面包含两组独立接口：P12证书状态检测、P12签名描述文件

二、P12 证书状态检测配置（用于校验 P12 证书有效性）

1. 开启开关：启用接口 → 打开（开）
2. 请求 Token 填入：api-a1x5fpb2yq9wvj

三、P12 签名描述文件配置（获取.mobileconfig 签名描述文件）

1. 开启开关：启用接口 → 打开（开）
2. 请求 Token 填入：api-a1x5fpb2yq9wvj

四、保存生效

全部地址与 Token 填写完毕后，点击页面右上角蓝色按钮 保存配置，接口配置立即生效。

补充说明

1. Token 说明：可以使用提供的公共 Token api-a1x5fpb2yq9wvj；后续也可自行注册独立专属 Token。
2. 接口服务属性：接口长期免费使用，无额外扣费。
3. 后续规划：项目后续版本会支持本地离线化方案，不再依赖远程 API。（签名考虑到对服务器环境系统有要求，每个人使用系统不一样，所以会出现无法签名，先推出API方式对接）
4. 接口用途
   • P12 证书状态检测：工具列表 → UDID 获取 → 描述配置，用来检测上传 P12 证书是否有效
   • P12 签名描述文件：用户获取 UDID 时，在线实时下载 .mobileconfig 签名描述文件

验证方式

配置保存完成后，前往「UDID 获取」页面上传一份 P12 证书，测试证书校验、描述文件下载功能是否正常返回结果。

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 获取链接，用苹果手机打开安装配置文件，观察弹窗内「签名者」字段，核对是否和预期效果一致。