Immich手机客户端是一款用于连接自建Immich服务器的移动应用，支持Android和iOS系统。它主要面向注重隐私、希望将照片和视频存储在自己服务器或NAS上的用户。通过该客户端，用户可以自动备份媒体文件，并利用AI功能进行智能整理，实现类似Google Photos的体验，但数据完全由用户掌控。
1. 自动备份：连接Wi-Fi后自动上传手机中的照片和视频到自建服务器。
2. 选择性备份：可指定特定相册或文件夹进行备份，灵活控制内容。
3. 人脸识别与聚合：AI自动识别人脸，将同一人物的照片归类到一起。
4. 物体与场景识别：自动为照片打标签，便于按内容搜索。
5. 原图无损存储：支持HEIC、RAW格式及4K视频，保留原始画质。
6. 私密文件夹：对敏感内容设置访问限制，增强隐私保护。
7. 多用户管理：支持创建家庭或团队共享相册，并分配不同权限。
8. 地图定位：根据照片EXIF信息，在地图上显示拍摄位置。
9. 离线浏览：即使没有网络，也能查看已下载或缓存的内容。
10. 跨设备同步：手机、平板、电脑登录同一账户后，媒体库实时一致。
1. 开源且自托管：所有数据存于用户自己的服务器，不经过第三方，隐私更有保障。
2. 智能整理能力强：AI自动分类、打标、识别人物，省去手动整理的麻烦。
3. 高清无损支持全面：不仅支持常见格式，还能处理专业摄影常用的RAW和HEIC。
4. 共享机制灵活：既可创建长期共享相册，也能生成临时链接分享给特定人，权限可控。
搭建 Immich 最推荐的方式是使用 Docker Compose，这种方式简单且便于后期维护升级。以下是基础搭建流程：
1、环境准备
确保你的服务器或 NAS 已经安装了：
Docker (版本 20.10+ )
Docker Compose (版本 2.10+ )
2、创建项目目录
在你的服务器上找个位置存放 Immich 的配置文件。
mkdir ./immich-app && cd ./immich-app
3、获取配置文件
你需要下载两个核心文件：docker-compose.yml（定义服务结构）和 .env（定义变量参数）。
下载配置文件
wget 下载地址：https://GitHub.com/immich-app/immich/releases/latest/download/docker-compose.yml
下载环境变量模版
wget -O .env 下载地址：https://github.com/immich-app/immich/releases/latest/download/example.env
4、编辑配置 (.env)
使用文本编辑器（如 vim 或 nano）修改 .env 文件。必须修改的项包括：
UPLOAD_LOCATION: 照片存放的具体路径（例如 /mnt/data/photos）。
5、启动服务
在包含配置文件的目录下运行以下命令：
docker compose up -d
Docker 会自动拉取镜像并启动容器。启动后，通过浏览器访问 http://服务器IP:2283 即可进入初始化界面。
【家庭私有云存储中心】
全家人可以分别创建账号，互不干扰地自动备份手机照片，同时利用“公共相册”功能一键分享家庭聚会或孩子成长的瞬间。
【Google Photos 无感迁移】
由于其界面操作逻辑与 Google Photos 高度相似，非常适合想要逃离公有云存储空间订阅费，但又不希望改变使用习惯的用户。
【摄影师的素材仓库】
支持原图无损存储和对 HEIC、RAW 等格式的良好兼容，摄影师可以将其作为移动端的初筛工具，通过地理位置和标签快速检索素材。
【旧硬件“变废为宝”】
通过 Docker 部署在吃灰的旧电脑或入门级 NAS 上，即可让旧设备摇身一变成为支持 AI 人脸识别的高级智能相册。
【敏感资料隔离区】
对于不便上传至公有云的隐私照片或证件扫描件，Immich 提供的本地存储环境能确保数据物理隔离，彻底杜绝隐私泄露风险。
1. 修复了合并视频在本地播放时画面比例显示错误的问题。
