NanoMDM 设备注册迁移指南3 步用 nano2nano 换存储后端、搬 MDM 服务器不重新注册【免费下载链接】audacityAudio Editor项目地址: https://gitcode.com/GitHub_Trending/au/audacity先说结论在 NanoMDM 里做设备注册迁移靠的是官方的 nano2nano 命令行工具加目标端的/migration端点三步走完设备不用重新注册。MDM移动设备管理场景下设备注册是指设备向服务器声明身份并交换推送令牌的过程之后设备才能持续受管。问题出在换存储后端或搬 MDM 服务器的时候比如注册数据还留在 file 文件后端你想升级到 mysql或者服务器换了机器、重装了系统不想让几十上百台设备再走一遍注册流程。nano2nano 能做什么不能做什么nano2nano 从旧存储读出每台设备的注册报文按固定顺序逐条发给目标 NanoMDM 的/migration端点由目标端用常规的 MDM check-in即设备与服务器的报到交互处理逻辑重建注册记录。它做不到两件事不搬历史命令和库存数据也不能替你改设备侧的服务器指向。目标服务器上的迁移端点默认关闭必须显式开启并提供 API Key这一点决定了两边怎么配合。迁移前检查清单动手之前先逐项确认任何一条不满足都会让迁移白跑服务器 URL 完全一致源与目标的 MDM 服务器 URL 必须完全一致协议、域名、端口、路径都要相同。MDM 协议把服务器 URL 绑定在设备证书里URL 一变设备就不认新服务器这是硬限制没有变通办法。目标端开-migration且配了-api两个参数缺一不可否则/migration端点不存在。旧存储完整备份注册迁移是有损的出问题要能回滚。第 1 步目标服务器开启迁移端点先在新服务器上配好存储例如 mysql按schema.sql建表然后带两个参数启动nanomdm -api APIKey -migration -ca ca.pem \ -storage mysql -storage-dsn dsn启用后/migration路径上会注册一个 check-in 处理器。它走 API Basic 认证用户名固定nanomdm密码就是 API Key但不校验设备证书——因为请求是迁移工具发的不是真设备。第 2 步从 file 切到 mysql 的完整迁移命令工具以只读方式打开旧存储读出各设备的注册报文并发送。两类核心报文Authenticate是设备注册时声明身份与通道的报文TokenUpdate是更新 APNs 推送令牌的报文推送令牌决定服务器能否主动唤醒设备。顺序很敏感设备通道的TokenUpdate必须紧跟Authenticate用户通道又在设备通道之后所以工具故意用单线程串行发送不并发nano2nano -storage file -storage-dsn db \ -url http://127.0.0.1:9000/migration \ -key APIKey -debug跑完后核对日志每台设备应依次出现两条 infocheckinAuthenticate device_id99385AF6-... typeDevice checkinTokenUpdate device_id99385AF6-... typeDevice如果源是multi类型存储注意它只用第一个后端参与迁移。第 3 步确认无误后切换流量确认日志无报错、设备数量对得上再把设备的目标服务器切到新后端实例并用新存储重启。由于两边 URL 一致设备不重新注册就能继续受管。旧服务器可先留着做回滚兜底。nano2nano 参数速查参数说明-storage源存储后端file、mysql、pgsql等与主程序语法一致-storage-dsn源后端数据源名称目录路径或连接串-storage-options后端选项部分后端需要file 需enable_deprecated1-url目标迁移端点如http://127.0.0.1:9000/migration-key目标服务器 API Key用于 Basic 认证-debug输出调试日志排障时建议常开-version打印版本后退出参数与发送逻辑的完整实现在cmd/nano2nano/main.go各存储后端的读取实现在storage/kv/migrate.go、storage/mysql/migrate.go、storage/pgsql/migrate.go。结果验证日志怎么读✅ 成功每台设备依次出现AuthenticateTokenUpdate全程无 error 级别输出设备数与源存储一致。❌ 失败出现sending to migration endpoint加错误信息。按状态码定位——401 查-key404 查-url是否打到/migration连接超时就查网络与端口。迁移会丢什么注册迁移是有损的✅ 会搬设备身份Authenticate、推送令牌TokenUpdate含设备与用户两条通道、可选的SetBootstrapToken。❌ 不搬历史命令与响应记录、库存inventory数据。⚠️ 边缘风险iOS 的解锁令牌unlock token。如果设备最后一次TokenUpdate没带上注册时的 unlock token迁移后这份信息就找不回来了——这也是迁移前必须备份旧存储的原因。排障现象 → 原因 → 处理现象原因处理请求返回 401-key与目标-api不一致两边值对齐后再跑设备重新注册或连不上新服务器源与目标 URL 不一致硬性前提URL 必须完全一致迁到不同 URL 的服务器不支持multi 后端迁移结果不符预期multi 只用第一个后端迁移确认第一个后端就是你要迁的那份迁移期间担心影响在线设备担心工具写坏旧存储工具只读旧存储旧服务器可继续运行到切换完成总结与扩展资源整套 MDM 迁移的本质是把注册报文按序重放给新服务器。所以顺序永远是目标端先开迁移端点再跑 nano2nano 核对日志最后切流量设备侧零改动。三件事别忘URL 一致、端点开启、旧存储备份。想深入可以继续看docs/operations-guide.md各后端配置与 nano2nano 的完整参数说明test/e2e/migrate.go端到端迁移测试迁移流程的活文档Makefile交叉编译 nano2nano覆盖 darwin/linux/windows 的 amd64/arm64/arm如make nano2nano-linux-amd64。【免费下载链接】audacityAudio Editor项目地址: https://gitcode.com/GitHub_Trending/au/audacity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
NanoMDM 设备注册迁移指南3 步用 nano2nano 换存储后端、搬 MDM 服务器不重新注册【免费下载链接】audacityAudio Editor项目地址: https://gitcode.com/GitHub_Trending/au/audacity先说结论在 NanoMDM 里做设备注册迁移靠的是官方的 nano2nano 命令行工具加目标端的/migration端点三步走完设备不用重新注册。MDM移动设备管理场景下设备注册是指设备向服务器声明身份并交换推送令牌的过程之后设备才能持续受管。问题出在换存储后端或搬 MDM 服务器的时候比如注册数据还留在 file 文件后端你想升级到 mysql或者服务器换了机器、重装了系统不想让几十上百台设备再走一遍注册流程。nano2nano 能做什么不能做什么nano2nano 从旧存储读出每台设备的注册报文按固定顺序逐条发给目标 NanoMDM 的/migration端点由目标端用常规的 MDM check-in即设备与服务器的报到交互处理逻辑重建注册记录。它做不到两件事不搬历史命令和库存数据也不能替你改设备侧的服务器指向。目标服务器上的迁移端点默认关闭必须显式开启并提供 API Key这一点决定了两边怎么配合。迁移前检查清单动手之前先逐项确认任何一条不满足都会让迁移白跑服务器 URL 完全一致源与目标的 MDM 服务器 URL 必须完全一致协议、域名、端口、路径都要相同。MDM 协议把服务器 URL 绑定在设备证书里URL 一变设备就不认新服务器这是硬限制没有变通办法。目标端开-migration且配了-api两个参数缺一不可否则/migration端点不存在。旧存储完整备份注册迁移是有损的出问题要能回滚。第 1 步目标服务器开启迁移端点先在新服务器上配好存储例如 mysql按schema.sql建表然后带两个参数启动nanomdm -api APIKey -migration -ca ca.pem \ -storage mysql -storage-dsn dsn启用后/migration路径上会注册一个 check-in 处理器。它走 API Basic 认证用户名固定nanomdm密码就是 API Key但不校验设备证书——因为请求是迁移工具发的不是真设备。第 2 步从 file 切到 mysql 的完整迁移命令工具以只读方式打开旧存储读出各设备的注册报文并发送。两类核心报文Authenticate是设备注册时声明身份与通道的报文TokenUpdate是更新 APNs 推送令牌的报文推送令牌决定服务器能否主动唤醒设备。顺序很敏感设备通道的TokenUpdate必须紧跟Authenticate用户通道又在设备通道之后所以工具故意用单线程串行发送不并发nano2nano -storage file -storage-dsn db \ -url http://127.0.0.1:9000/migration \ -key APIKey -debug跑完后核对日志每台设备应依次出现两条 infocheckinAuthenticate device_id99385AF6-... typeDevice checkinTokenUpdate device_id99385AF6-... typeDevice如果源是multi类型存储注意它只用第一个后端参与迁移。第 3 步确认无误后切换流量确认日志无报错、设备数量对得上再把设备的目标服务器切到新后端实例并用新存储重启。由于两边 URL 一致设备不重新注册就能继续受管。旧服务器可先留着做回滚兜底。nano2nano 参数速查参数说明-storage源存储后端file、mysql、pgsql等与主程序语法一致-storage-dsn源后端数据源名称目录路径或连接串-storage-options后端选项部分后端需要file 需enable_deprecated1-url目标迁移端点如http://127.0.0.1:9000/migration-key目标服务器 API Key用于 Basic 认证-debug输出调试日志排障时建议常开-version打印版本后退出参数与发送逻辑的完整实现在cmd/nano2nano/main.go各存储后端的读取实现在storage/kv/migrate.go、storage/mysql/migrate.go、storage/pgsql/migrate.go。结果验证日志怎么读✅ 成功每台设备依次出现AuthenticateTokenUpdate全程无 error 级别输出设备数与源存储一致。❌ 失败出现sending to migration endpoint加错误信息。按状态码定位——401 查-key404 查-url是否打到/migration连接超时就查网络与端口。迁移会丢什么注册迁移是有损的✅ 会搬设备身份Authenticate、推送令牌TokenUpdate含设备与用户两条通道、可选的SetBootstrapToken。❌ 不搬历史命令与响应记录、库存inventory数据。⚠️ 边缘风险iOS 的解锁令牌unlock token。如果设备最后一次TokenUpdate没带上注册时的 unlock token迁移后这份信息就找不回来了——这也是迁移前必须备份旧存储的原因。排障现象 → 原因 → 处理现象原因处理请求返回 401-key与目标-api不一致两边值对齐后再跑设备重新注册或连不上新服务器源与目标 URL 不一致硬性前提URL 必须完全一致迁到不同 URL 的服务器不支持multi 后端迁移结果不符预期multi 只用第一个后端迁移确认第一个后端就是你要迁的那份迁移期间担心影响在线设备担心工具写坏旧存储工具只读旧存储旧服务器可继续运行到切换完成总结与扩展资源整套 MDM 迁移的本质是把注册报文按序重放给新服务器。所以顺序永远是目标端先开迁移端点再跑 nano2nano 核对日志最后切流量设备侧零改动。三件事别忘URL 一致、端点开启、旧存储备份。想深入可以继续看docs/operations-guide.md各后端配置与 nano2nano 的完整参数说明test/e2e/migrate.go端到端迁移测试迁移流程的活文档Makefile交叉编译 nano2nano覆盖 darwin/linux/windows 的 amd64/arm64/arm如make nano2nano-linux-amd64。【免费下载链接】audacityAudio Editor项目地址: https://gitcode.com/GitHub_Trending/au/audacity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
