Immich 部署全攻略：在 ESXi 中搭建私有照片管理中心

随着各大云盘相册（如 Google Photos、iCloud）的免费空间越来越少，加上隐私泄露的担忧，越来越多的家庭实验室（Home Lab）用户开始寻求私有化解决方案。

在 2026 年，Immich 已经毫无疑问地成为了这个领域的“王者”。它不仅拥有媲美 Google Photos 的丝滑体验，还集成了极其强大的 AI 人脸识别、地理位置聚类和多端自动备份功能。本文将教你如何在 ESXi 环境下的 Linux 虚拟机中，通过 Docker 完美部署 Immich。

---

一、 为什么选择 Immich？

• 极致速度：即便有数万张照片，滑动缩略图也毫无延迟。
• AI 赋能：内置机器学习模型，自动识别人脸、物体及场景。
• 多端备份：提供 iOS 和 Android 原生 App，支持后台自动备份。
• 地理信息：精美的地图视图，按足迹查看照片。
• 活跃社区：更新频率极高，功能日新月异。

---

二、 准备工作

1. 硬件建议（基于 ESXi 虚拟机）

• CPU：建议分配至少 4 核（AI 识别和视频转码需要较多算力）。
• 内存：建议 4GB 以上（机器学习模型加载后占用不小）。
• 存储：建议将系统盘（SSD）与数据盘（HDD/大容量 SSD）分开。
• 系统：推荐使用 Ubuntu 24.04 LTS 或 Debian 12。

2. 环境安装

确保你的虚拟机已经安装了 Docker 和 Docker Compose。

---

三、 部署步骤

1. 创建项目目录

mkdir -p ~/immich-app && cd ~/immich-app

2. 获取配置文件

Immich 官方提供了专门的配置文件：

wget https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget https://github.com/immich-app/immich/releases/latest/download/example.env -O .env

3. 修改 .env 配置

这是最关键的一步。你需要修改 .env 文件中的存储路径和时区。

# 修改为你的照片存储路径（建议挂载 ESXi 的大容量磁盘）
UPLOAD_LOCATION=/mnt/storage/immich-data

# 修改时区
TZ=Asia/Shanghai

# 生成一个随机的数据库密码
DB_PASSWORD=your_secure_password

4. 启动服务

docker compose up -d

Immich 会启动多个容器（包括 Redis、Postgres、Machine Learning 等）。第一次启动可能需要几分钟来下载镜像和初始化数据库。

---

四、 进阶：在 ESXi 中开启显卡直通 (可选)

如果你希望 AI 识别速度起飞，或者需要大量视频转码，可以在 ESXi 中将显卡（如核显或 NVIDIA 卡）直通给虚拟机，并在 Docker 中调用。

1. ESXi 设置：管理 -> 硬件 -> PCI 设备 -> 选择显卡 -> 切换直通。
2. 虚拟机设置：添加 PCI 设备。
3. Docker 设置：在 docker-compose.yml 中添加 deploy: resources: reservations: devices: ...（具体配置取决于你的 GPU 类型）。

---

五、 初始化与移动端备份

1. 访问 Web 端：浏览器打开 http://虚拟机IP:2283。
2. 创建管理员：按照提示设置账号。
3. 配置备份：
   • 在手机应用商店下载 Immich App。
   • 输入你的服务器地址（如 http://192.168.1.100:2283/api）。
   • 登录后开启“自动备份”。

---

六、 维护与更新

Immich 还在快速迭代中，建议定期更新以获取新功能：

cd ~/immich-app
docker compose pull && docker compose up -d

---

🛡️ 结语

Immich 让你的照片重新回到了你自己的手中。在 ESXi 中部署 Immich，不仅利用了闲置的硬件资源，更为全家提供了一个安全、私密且极其强大的数字记忆中心。

如果你还没尝试过，今天就是搭建它的最好时机！

---

延伸阅读

• 流媒体使用与常见问题汇总
• 全平台代理客户端配置指南
• 直连、中转、专线线路差异说明
• AI 工具新手入门与常见问题

免责声明

本文仅供技术交流和学习参考。涉及第三方服务的链接可能包含 sponsored 标记，请自行核实服务条款、价格和可用性，并遵守当地法律法规。