immich数据迁移：从其他平台无缝转移
【免费下载链接】immich 自主托管的照片和视频备份解决方案，直接从手机端进行操作。 
项目地址: https://gitcode.com/GitHub_Trending/im/immich
迁移前准备
在开始数据迁移前，请确保已完成Immich的基础安装与配置。Immich作为自主托管的照片和视频备份解决方案，支持通过手机端直接操作数据迁移流程。官方推荐使用最新版本的移动应用以获得完整的迁移功能，可通过移动端应用文档了解详细安装步骤。
系统环境要求
- 服务器端：Immich v1.90.0+（推荐通过docker-compose.yml部署）
- 移动端：Android 8.0+/iOS 14.0+，已登录Immich账户并完成初始备份设置
移动端迁移流程
Immich移动应用提供两种主要数据导入方式：选择性上传和相册同步，适用于从手机本地存储或其他应用导出的媒体文件迁移。
选择性上传本地文件
- 在Immich移动端进入「相册」页面，点击「设备上的媒体」查看本地文件
- 启用存储指示器：进入「设置」→「照片网格」→开启「显示存储状态图标」
- <Icon path={mdiCloudOffOutline} size={1} /> 表示本地文件未同步
- <Icon path={mdiCloudCheckOutline} size={1} /> 表示文件已同步至服务器
- 长按选择需要迁移的照片/视频，点击底部「上传」按钮完成迁移
相册同步功能
相册同步功能可将手机特定相册自动同步至Immich服务器，适合批量迁移已分类的媒体文件：
- 进入「设置」→「备份」→「同步相册」
- 选择需要迁移的本地相册（如"相机胶卷"、"截图"等）
- 启用「自动同步」选项，系统将在WiFi环境下后台完成迁移
同步规则：
- 同名相册会自动合并，新文件将添加至现有相册
- 同步为单向操作（设备→服务器），删除本地文件不会影响服务器数据
- 支持共享相册同步，新添加文件会自动出现在共享相册中
高级迁移方案
对于从Google Photos、Apple Photos等第三方云服务迁移的用户，可通过以下进阶方案实现完整数据转移：
本地导出+服务器导入
- 从源平台导出数据（如Google Takeout），获取包含照片/视频的压缩包
- 通过SFTP工具将解压后的媒体文件上传至Immich服务器的
upload目录 - 执行CLI命令触发服务器端扫描：
cd /data/web/disk1/git_repo/GitHub_Trending/im/immich && docker compose exec server immich-cli scan
数据校验与冲突处理
迁移完成后，可通过Web界面的「相册」→「最近添加」确认文件数量是否匹配。若出现重复文件冲突，可在移动端「设置」→「高级」→「重复资产」→「清理」重新触发同步检测。
迁移后优化
存储管理建议
常见问题解决
- 迁移速度慢：检查服务器带宽，推荐使用有线网络连接
- 文件格式不支持：参考媒体格式支持列表转换不兼容文件
- 权限错误：确保Immich应用具有手机「文件访问」和「媒体库」权限
迁移工具开发指南
开发者可基于Immich开放API实现自定义迁移工具，核心接口参考：
社区贡献的迁移脚本可在社区项目页面找到，包括Google Photos、Synology Photos等平台的专用迁移工具。
【免费下载链接】immich 自主托管的照片和视频备份解决方案，直接从手机端进行操作。 项目地址: https://gitcode.com/GitHub_Trending/im/immich
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
