Immich 是一个可以运行在自有服务器上的开源照片和视频平台。本指南介绍如何在 Windows 11 上使用 WSL2 和 Docker Desktop 部署 Immich，并说明 2283 端口、存储位置、Docker 卷和备份。
Immich 是什么？
Immich 是注重隐私的 Google Photos 替代方案。照片库由您自己掌控，同时支持手机自动上传、快速搜索、人脸和物体识别以及共享。
准备工作
| 项目 | 最低要求 | 建议 |
|---|---|---|
| CPU | 2 核 | 4 核 |
| 内存 | 6 GB | 8 GB |
| 系统 | 64 位系统 | 安装 WSL2 的 Windows 11 |
- 具有管理员权限的 Windows 11 电脑
- Windows 版 Docker Desktop
- 包含 Ubuntu 发行版的 WSL2
- 足够存放照片库和数据库的空间
启用 WSL2
- 以管理员身份打开 PowerShell。
- 运行下面的命令。
- 按提示重新启动 Windows。
- 从开始菜单打开 Ubuntu 并完成首次设置。
wsl --install安装 Docker Desktop
- 从 Docker 官方网站下载 Docker Desktop。
- 安装时保持 WSL 2 后端启用。
- 在 Settings → Resources → WSL Integration 中启用 Ubuntu。
当前安装界面请参考 Docker Desktop 官方文档。
下载 Immich 文件
打开 Ubuntu 或 WSL 终端并创建工作目录。下面的命令会从 Immich 的最新发行版下载 Docker Compose 文件和环境变量示例文件。
mkdir -p ~/immich-app
cd ~/immich-appwget -O docker-compose.yml 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配置存储位置
在 .env 中检查 UPLOAD_LOCATION 和 DB_DATA_LOCATION。UPLOAD_LOCATION 保存照片和视频，DB_DATA_LOCATION 保存 PostgreSQL 数据库。请选择容量充足的磁盘，并同时备份这两个位置。
使用 Docker 卷
也可以在 Compose 配置中使用命名卷。这样便于迁移，但仍然需要为卷制定独立的备份方案。
启动 Immich
docker compose up -d检查运行中的容器：
docker ps打开 http://localhost:2283。同一网络中的其他设备可使用 http://服务器-IP:2283，并在 Windows 防火墙中允许该端口。
首次设置与手机备份
- 在网页界面创建第一个账户。
- 安装 Immich 手机应用。
- 填写服务器 URL 并登录。
- 为需要保护的相册开启自动备份。
备份与更新
Immich 本身不是备份方案。请将上传目录和数据库备份到其他磁盘或存储服务，并定期测试恢复。更新前阅读发行说明并保留 .env 文件副本。
故障排查
- 页面无法打开时，检查 Docker Desktop 是否运行以及 2283 端口是否被阻止。
- 服务反复重启时，运行 docker ps 并查看容器日志。
- 磁盘空间不足时，先停止服务，再移动数据并一致地修改所有路径。
总结
使用 WSL2、Docker Desktop 和最新的 Immich Compose 文件，即可在 Windows 11 上运行私有照片库。请记录存储路径、2283 端口和经过测试的备份方案。
免责声明：本文仅供参考。Immich、Docker Desktop、Windows 及其设置可能发生变化。修改存储或容器前请备份数据，并在与您版本相对应的官方文档中核对命令。
评论