Immich 最新版部署指南 | 开源自托管照片视频管理系统 AI 智能分类 多设备自动备份 数据隐私保护

核心功能亮点

1. 数据自主与安全备份

• 自托管架构：所有照片 / 视频存储在用户自有服务器，无第三方数据泄露风险。
• 自动备份：移动端支持后台自动 / 选择性相册备份，支持 RAW 格式（HEIC、DNG、CR2 等）与 Live Photo，保留完整 EXIF 元数据。
• 重复检测：自动识别重复文件，避免冗余存储，节省空间。
• 双向同步：多设备间数据保持一致，修改一处，处处更新。

2. AI 智能管理与检索

• 人脸识别：基于 InsightFace 框架，自动检测、识别并分组人物，支持手动修正标签。
• 智能标签与搜索：通过 CLIP 模型实现自然语言搜索（如 “海边日落”“宠物猫”），支持按对象、场景、GPS 位置检索。
• 地图视图：按拍摄地点在地图上呈现照片，直观查看旅行足迹。
• 时间线与动态相册：按 “年 - 月 - 日” 分组浏览，支持按规则创建智能动态相册。

3. 多用户共享与权限管理

• 多用户支持：创建独立账号，家庭成员 / 团队成员各自管理相册，数据隔离。
• 共享相册：支持创建公共 / 私密共享相册，可设置访问权限，实现多人共创。
• 私密保护：锁定文件夹功能，保障隐私照片安全，防止误访问。
• 公开链接分享：生成临时链接，无需账号即可分享照片 / 视频给他人。

4. 高效部署与性能优化

• Docker Compose 一键部署：提供预配置 docker-compose.yml，几分钟完成环境搭建。
• 媒体处理优化：集成 FFmpeg，支持视频转码、缩略图生成，适配不同设备浏览需求。
• 批量管理：支持多选操作，一键添加标签、修改 GPS 信息、批量导出 4K 视频等。
• 命令面板：支持 Ctrl+K（macOS 为 Cmd+K）快速执行上传、创建相册等操作。

快速使用步骤

1. 部署准备与安装

• 环境要求：服务器需 2GB 以上内存，预留足够存储空间（建议≥100GB），安装 Docker 与 Docker Compose。
• 部署流程：
  1. 克隆 GitHub 仓库：git clone https://github.com/immich-app/immich.git
  2. 复制配置文件：cp example.env .env，修改 UPLOAD_LOCATION（存储路径）等参数。
  3. 启动服务：docker-compose up -d，等待容器拉取与启动。
  4. 访问 Web 界面：默认地址 http:// 服务器 IP:2283，注册管理员账号并登录。
        5.部署文档：https://docs.immich.app/install/requirements

2. 客户端配置

• 移动端：iOS/Android 应用商店搜索 “Immich”，输入服务器地址、账号密码，开启自动备份。
• Web 端：通过浏览器访问服务器地址，支持上传、下载、相册管理、共享设置等操作。

3. 高级设置

• AI 功能启用：默认开启人脸识别与智能搜索，可在 Web 端 “设置 - 机器学习” 调整模型与阈值。
• 存储扩展：支持挂载 NAS 存储，通过修改 UPLOAD_LOCATION 实现数据迁移。
• 远程访问：配置 DDNS + 端口转发或使用 WireGuard VPN，实现外网安全访问。

适用场景与优势

注意事项

1. 部署前确保服务器网络稳定，预留足够存储空间，避免因容量不足导致备份失败。
2. AI 功能（人脸识别、智能搜索）依赖较高性能 CPU/GPU，低配设备可能运行缓慢。
3. 首次备份大量照片时，建议在 Wi-Fi 环境下进行，避免消耗手机流量。
4. 定期备份 PostgreSQL 数据库与存储目录，防止数据丢失。