手机里的照片和视频越来越多，换机、清理空间或整理家庭相册时，往往需要一个简单可靠的备份方式。iPhoneBackup 是一个局域网相册同步工具：在电脑上运行服务器，手机连接同一个 Wi-Fi 后扫描服务器空间的二维码，就可以把 iPhone 或 Android 手机上的照片和视频同步到指定目录。

它不依赖第三方云盘，备份文件直接保存到自己管理的服务器空间中，适合个人备份、家庭相册整理和局域网内的设备迁移。

下载地址

当前客户端和服务器安装包的公开下载地址还在准备中，后续会补充正确链接：

• iOS 客户端下载
• Android 客户端下载
• 服务器安装包下载

工作方式

整个同步过程只需要三部分：

1. 在 Mac 等电脑上启动 iphonebackup 服务器，并创建一个相册空间。
2. 手机和服务器连接到同一个局域网，在服务器空间页面打开二维码。
3. 在 iOS 或 Android 客户端中扫描二维码，授权照片访问权限后开始同步。

二维码会携带当前空间的服务器地址、访问令牌和服务器公钥信息。客户端完成扫码后，会保存服务器身份并使用安全连接进行后续的状态查询、索引读取和文件上传。

服务器端安装与启动

下载服务器安装包后，将 iphonebackup 放到一个单独的目录，在终端中执行：

chmod +x iphonebackup
./iphonebackup setup -dir "$HOME/Pictures/iPhoneBackup"
./iphonebackup start

首次启动时，服务器会创建默认空间、配置文件和访问令牌，默认使用 HTTPS 并监听 8443 端口。启动成功后会打开管理页面；进入具体空间页面，把页面中的二维码展示在电脑屏幕上即可。

如果暂时只在可信任的家庭局域网中使用，也可以启用 HTTP 兼容模式：

./iphonebackup setup -http -addr :8080
./iphonebackup start

服务器会把照片和视频保存到指定目录，并维护一个索引文件。以后重新启动服务时，可以根据索引快速识别已经存在的文件。

iPhone 同步步骤

1. 安装并打开 iOS 客户端。
2. 点击“扫码设置”，扫描服务器具体空间页面上的二维码。
3. 允许 App 访问照片；如果要同步整个照片库，请选择“完整访问”。
4. 点击“开始同步”，等待照片和视频上传完成。

iOS 客户端会扫描照片库，将原始照片和视频导出到临时文件后上传。同步完成后，资源指纹和服务器返回的 SHA-256 会保存到本地 ledger，下一次同步时可以跳过没有变化的资源。

如果照片只保存在 iCloud 中，系统可能需要先下载原始文件，因此实际同步速度会受到网络和 iCloud 状态影响。

Android 同步步骤

1. 安装并打开 Android 客户端。
2. 在“服务器”区域点击扫码，扫描服务器空间页面上的二维码。
3. 授予读取照片和视频所需的权限。
4. 点击“开始同步”，查看当前上传、跳过和失败数量。

Android 客户端会读取手机媒体库，先加载服务器的文件索引，再对需要同步的媒体计算 SHA-256。已经备份过且内容没有变化的文件会直接跳过，减少重复上传和局域网流量。

增量同步与文件去重

相册同步不只是简单地把文件再次上传。客户端和服务器会共同完成去重：

• 客户端使用本地 ledger 记录资源指纹和上次同步结果。
• 同步开始时，客户端会读取服务器已有文件的 SHA-256 索引。
• 文件内容已经存在于服务器时，客户端会跳过上传。
• 即使客户端本地记录缺失，服务器也会按文件内容进行 SHA-256 去重。

因此，重复执行同步不会产生大量重复文件，也更适合日常定期备份。

安全与使用提醒

• 手机和服务器需要连接到同一个局域网，电脑防火墙也需要允许服务器接收连接。
• 只扫描自己启动的服务器空间页面上的二维码，不要扫描来源不明的二维码。
• HTTPS 模式下，客户端会固定扫码时获得的服务器公钥；服务器更换身份后，需要重新扫描二维码配对。
• 当前版本需要打开客户端并手动点击开始同步，后台常驻同步功能还在后续规划中。
• 如果使用 HTTP 模式，请确保局域网可信，避免在公共网络中传输照片。

适合哪些场景？

如果你想把手机照片定期备份到自己的 Mac 或家庭电脑，不希望先上传到第三方云盘，或者需要在多个家庭空间之间分别保存相册，iPhoneBackup 提供了一条比较直接的路径：服务器负责保存和去重，手机 App 负责扫描、配对和同步。

下载地址准备好后，就可以通过扫码完成配置，让相册备份变成一个简单的日常操作。