Immich-Go 中文版下载|Windows+macOS+Linux（自托管 Immich 的免 Node 批量迁移命令行工具）
30 秒速读：自托管了 Immich，想把 Google 相册 Takeout 或一硬盘老照片批量导进去？Immich-Go 是 Go 写的命令行迁移工具，不用装 Node.js 也不用 Docker，单个二进制开箱即用。它支持 Google Photos Takeout、iCloud、本地文件夹、ZIP 归档、其他 Immich 服务器，甚至老 Picasa 的 .picasa.ini 都能读；自带重复检测、连拍堆叠、RAW+JPEG 关联，还能从目录结构自动建相册。兼容 Immich V2/V3。本篇讲清六个命令怎么选、API 密钥的权限坑、正式迁移前必做的 4 件事。注意作者原话：这是早期版本、尚未广泛测试，迁移前务必保留备份。
软件信息表
| 软件名称 | Immich-Go（Immich 批量上传与迁移命令行工具） |
| 开发语言 | Go；单二进制，无运行时依赖 |
| 平台 | Windows、macOS、Linux、FreeBSD（Releases 页下预编译二进制） |
| 前置条件 | 一个正在运行、可通过 API 访问的 Immich 服务器 + 有适当权限的 API 密钥 |
| 支持来源 | Google Photos Takeout、iCloud、本地文件夹、ZIP 归档、其他 Immich 服务器、Picasa |
| 主要命令 | upload from-folder / from-google-photos / from-icloud / from-immich / from-picasa；archive from-immich（反向导出归档） |
| 智能能力 | 重复检测、连拍堆叠、RAW+JPEG 关联、按目录结构建相册、读 XMP 侧车文件、–ban-file 过滤垃圾文件、上传时可暂停 Immich 后台任务加速 |
| 规模 | 作者实测可处理 10 万+照片级别的集合 |
| 开源协议 | AGPL-3.0 |
| 社区热度 | GitHub 7k+ star，118 个 release，维护活跃 |
六个命令怎么选：结论先行
| 命令 | 适合谁 | 说明 |
|---|---|---|
| from-google-photos（最常用） | 从 Google 相册迁出 | 直接吃 takeout-*.zip，智能配对照片和 JSON 元数据，保留相册、描述和地理位置 |
| from-folder | 本地硬盘照片入库 | 最基础的命令；按目录结构建相册，读 XMP 侧车文件 |
| from-icloud | iCloud 照片迁出 | 专门处理 iCloud takeout，从 CSV 里正确解析拍摄日期和相册结构 |
| from-immich | 服务器之间搬迁 | 两个 Immich 实例之间复制资产，支持细粒度过滤 |
| archive from-immich | 反向导出 | 把服务器上的资产导出归档到本地文件夹 |
| from-picasa | 老 Picasa 遗产 | from-folder 的特化版，自动读 .picasa.ini 恢复当年的相册组织 |
明确取舍：Google Photos 迁出直接上 from-google-photos，这是它打磨最多的路径；换服务器/搬家用 from-immich；纯本地整理入库用 from-folder。无论哪个命令，先拿 50–100 张照片小批量验证相册结构、拍摄时间、定位和描述都对，再全量跑——这是作者反复强调的流程。
安装步骤（只写卡点）
- 去 Releases 页下对应系统的预编译二进制，不需要装 Node.js 或 Docker，下载即用。
- 先准备 Immich 服务器：必须是一个正在运行、API 可访问的实例（默认 2283 端口），并在 Immich 后台创建一个 API 密钥。权限坑：v0.32.0 起
ReplaceAsset接口被移除，asset.replace权限已废弃（key 里带了也会被服务器忽略），需要复制资产改用asset.copy权限——按新版文档的权限清单建 key，别沿用网上老教程的权限表。 - 源文件先备份：作者原话级别的要求——”Keep a backup copy of your files”，它是迁移工具不是备份系统，跑之前源文件留一份。
- Google Takeout 不用预处理：
from-google-photos直接吃takeout-*.zip，命令形如immich-go upload from-google-photos --server=你的Immich服务器地址 --api-key=你的密钥 /path/to/takeout-*.zip。 - 先小批量验证：拿一个子目录或几十张照片跑一遍，检查服务器端的相册结构、拍摄时间、地理位置、描述是否还原，再决定全量。
装完必改的 4 个设置
- API 密钥权限最小化：按当前版本文档的权限清单建 key，不要给多余权限；记住 v0.32.0 的口径变化（废弃
asset.replace、改用asset.copy），老 key 建议重建。 - –ban-file 补自己的垃圾规则：默认已跳过
@eaDir/、.DS_Store、.Spotlight-V100/、thumbnails/、Recently Deleted/等常见杂物；目录用结尾斜杠（如--ban-file .Spotlight-V100/），单个文件不用（如--ban-file .DS_Store）。按你自己的目录习惯追加，别把缩略图缓存也导进服务器。 - 大批量前暂停 Immich 后台任务：上传时可以暂停服务器的后台任务（如缩略图生成）来提速，导完记得恢复。这是 10 万+ 照片级迁移省时间的关键开关。
- 记录版本与流程：记下用的 immich-go 二进制版本和 API 权限配置；升级 Immich 或 immich-go 后重新走一遍小批量验证再全量，别假设升级后行为不变。
独家整理：Immich-Go vs 官方 immich CLI
| 维度 | Immich-Go | 官方 immich CLI |
|---|---|---|
| 依赖 | 单二进制，零依赖 | 需要 Node.js 环境 |
| 平台 | Win/Mac/Linux/FreeBSD 预编译包 | 跟 Node 生态走 |
| Takeout 迁移 | 专门优化，照片-JSON 元数据智能配对 | 基础支持 |
| 去重与堆叠 | 内置重复检测、连拍堆叠、RAW+JPEG 关联 | 部分能力 |
| 服务器间迁移 | from-immich / archive 双向 | 无对应命令 |
| 成熟度 | 早期版本，作者自述尚未广泛测试 | 官方配套，跟着 Immich 版本走 |
一句话：迁 Google Photos、跨平台、换服务器、要零依赖，选 Immich-Go；要官方配套、跟着 Immich 大版本稳稳升级，选官方 CLI。两个都建议先小批量验证，这是迁移类工具的铁律。
注意事项与常见问题
- 早期版本声明不是客套话：README 明确写着”not yet extensively tested”，大几万张照片的迁移，先小批量、留备份、核对结果，这三步一个不能少。
- 不能脱离服务器工作：它本质是 Immich API 的批量调用器，没有目标服务器就什么都干不了；先确保服务器可访问、API key 有效。
- 重复检测的边界：依据服务器已有资产判重，换服务器、重建库或换 key 时，判重基准会变，大迁移前先想清楚。
- Takeout 的 JSON 配对：Google Takeout 里照片和元数据是分开的 JSON，immich-go 会尽力配对，但极个别命名异常的文件可能配不上，导完抽查相册和描述。
- 耗时预期：作者实测 10 万+ 照片可处理，但真实耗时看你的网络和磁盘 IO；先用小批量测出单张平均耗时，再估全量时间，别在深夜开跑后干等。
适合谁，不适合谁
适合：自托管 Immich 的用户、要从 Google Photos / iCloud 迁出的家庭服务器维护者、需要服务器间搬迁的管理员、不想装 Node.js 只想要一个二进制的人、有 Picasa 老照片遗产要抢救的人。
不适合：没有 Immich 服务器的人（先搭服务器）；只想传几十张照片的人（官方 CLI 或网页上传更直接）；要求经过充分验证的生产级迁移链路的人（先看文档和实际测试结果再做决定）。
开源地址
GitHub 国内访问较慢，如打不开可多刷新几次
关注「软件教程管家」
回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。
本站资源仅供个人学习交流，请勿用于商业用途。软件与资料版权归原作者所有；如有侵权，请通过公众号「软件教程管家」联系我们，我们将在 24 小时内下架处理。查看免责声明 ›
