什么是 Immich?
Immich 是一款开源平台,可在个人服务器上进行私有化的照片和视频管理。它被设计为 Google Photos 的替代方案,具备自动备份、高速搜索、AI 图像识别以及共享功能等特性。

Immich 的主要特点
- 隐私优先:所有数据完全存储在用户的服务器上,无需依赖云服务。
- 自动备份:通过移动应用自动上传照片和视频,无需手动管理。
- AI 分类与搜索:支持人脸识别、物体识别、GPS 数据检索,提升搜索体验。
- 简洁的 UI/UX:类似 Google Photos,提供直观易用的操作界面。
本教程将介绍在 Windows 环境 下安装 Immich 的方法。
Windows 上的 Immich 安装步骤
安装必需软件
在 Windows 上运行 Immich 需要 Docker。
启用 WSL2
在 Windows 上使用 Docker,需要启用 WSL2(Windows 适用于 Linux 的子系统)。
- 以管理员模式打开 PowerShell,执行以下命令以启用 WSL:
- 重新启动计算机。
- 打开 Windows Terminal,安装 Ubuntu 等 WSL 发行版。
wsl --install
安装 Docker Desktop
- 从 Docker 官方网站 下载 Docker Desktop for Windows。
- 安装完成后,启动 Docker Desktop,然后在 设置 → General 中启用 WSL 2 作为后端。
- 在 WSL Integration 选项中启用 Ubuntu。
- 运行
wsl --list
命令,检查已安装的 WSL 发行版。
设置 Immich
获取 Immich 仓库
- 打开 WSL 终端,创建工作目录。
- 从 Immich 官方仓库 获取 Docker 配置。
mkdir -p ~/immich && cd ~/immich
git clone https://github.com/immich-app/immich.git cd immich
配置 .env 文件
- 复制
.env.example
并重命名为.env
。 - 根据需要修改
docker-compose.yml
,调整端口和存储路径。
cp .env.example .env
启动 Immich
- 运行以下命令启动容器。
- 确认容器是否成功启动。
- 打开浏览器,访问 http://localhost:3001,进入 Immich 管理界面。
docker-compose up -d
docker ps
Immich 的初始设置
- 在浏览器中打开 http://localhost:3001。
- 注册首次用户(创建管理员账户)。
- 在智能手机上安装 Immich 移动应用。
- 通过应用连接服务器,并设置自动备份。


总结
至此,您已成功在 Windows 环境中搭建 Immich。作为 Google Photos 的替代方案,Immich 非常适合希望注重隐私的用户进行照片和视频管理。
未来,您还可以进一步配置外部存储,或自定义 AI 功能,以满足更高级的需求。
如需更多信息,请参考官方文档:
📌 官网:https://immich.app/
コメント