需要什么帮助？

• 一部运行 iOS 17 或更高版本的 iPhone。离开 App 后要让同步在后台继续，需要 iOS 26。
• 你自己的 Immich 服务器，版本 3.3 或更高，能从 iPhone 访问，并在上面有一个 Immich 账户。
• 对照片图库的完全访问权限（下文说明为何有限访问不够）。

1. 输入你的 Immich 服务器地址（例如 https://immich.example.com）、Immich 邮箱和密码，然后轻点 登录。
2. 轻点 允许访问，并允许完全访问你的照片。
3. 轻点 开始试运行。试运行默认开启：它不会做任何更改，只显示有多少新照片、预计上传大小，以及已有多少照片在你的 Immich 服务器上。
4. 结果没问题后，在 设置 中关闭 试运行，然后轻点 立即同步。如果想先少量开始，可先将 每次运行的上传上限 设为 25 或 100 张照片。

iCloud 照片是唯一的标准。Photo Mirror Sync 会将新照片和视频作为未经改动的原件上传（HEIC、ProRAW、视频、带动态效果的实况照片），用当前版本替换编辑过的照片，保持个人收藏同步，并镜像你的普通 iCloud 相簿，包括文件夹中的相簿。

已逐字节相同地存在于 Immich 中的照片（例如来自官方 Immich App 的）会通过校验和识别，并直接关联，而不会上传两次。

你在 iCloud 中删除的照片，会在下次同步时移到 Immich 的废纸篓。Photo Mirror Sync 从不永久删除任何内容，也从不清倒废纸篓；Immich 默认在 30 天后清倒，在此之前你可以恢复照片。

如果一次运行中会有超过 5 % 的图库（至少 25 张照片）移到废纸篓，App 会停下来，请你 查看并确认…。后台同步绝不会自行确认。图库为空或照片访问受限时，绝不会删除任何内容。

只有 Photo Mirror Sync 自己上传或关联的照片和相簿才会被更改。通过官方 Immich App、网页界面或 CLI 上传的照片、外部图库、其他用户的照片，以及你自己在 Immich 中创建的相簿，都不会被触碰。

在 iOS 26 上，你在 App 中开始的同步在切换到其他 App 后仍会继续，进度显示在锁定屏幕上。你还可以开启在 iPhone 充电时运行的夜间同步；通知会告诉你有哪些变化。后台任务何时运行由 iOS 决定，因此夜间同步可能会延迟或被跳过。

停止、中断或被关闭了？每张照片一到达你的 Immich 服务器就会被记录，所以下次运行会从上次停下的地方准确继续，不会产生重复。

• 登录失败： 请确认在同一部 iPhone 的 Safari 浏览器中，该服务器地址（包括 https:// 和端口）能打开 Immich 网页界面，并确认服务器运行的是 Immich 3.3 或更高版本。
• 照片访问受限： 打开 iOS 的“设置” App，选择 Photo Mirror › 照片，并允许完全访问。在有限访问下，每张未选中的照片看起来都像被删除了，所以 App 不会同步。
• 照片在等待 iCloud： 开启“优化 iPhone 储存空间”时，原件需先从 iCloud 下载。请让 iPhone 保持连接 Wi-Fi；停滞一分钟的下载会被跳过，并在下次运行时重试。
• 后台同步停止了： 打开 App 并再次轻点 立即同步，它会从停下的地方继续。主屏幕上的日志会显示某次运行结束的原因。
• Immich 中缺少某张照片： 运行一次试运行，它会针对样本说明照片为何尚未上传到服务器；也可以查看 已镜像的照片 › 最近镜像，其中每张照片都直接链接到 Immich。

你的照片和 Immich 账户只会发送到你自己的 Immich 服务器。没有我们的账户，没有其他云，也没有跟踪。请参阅隐私政策。

有问题、遇到故障或有想法？请写信至 [email protected]，并注明你的 iOS 版本和 Immich 服务器版本。Immich 服务器本身的问题，请联系 Immich 项目。