跳轉到內容

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

Immich Self-hosted Photos

隨著各大雲盤相冊(如 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. 環境安裝

確保你的虛擬機已經安裝了 DockerDocker Compose


三、 部署步驟

1. 創建項目目錄

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

2. 獲取配置文件

Immich 官方提供了專門的配置文件:

bash
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 文件中的存儲路徑和時區。

ini
# 修改為你的照片存儲路徑(建議掛載 ESXi 的大容量磁盤)
UPLOAD_LOCATION=/mnt/storage/immich-data

# 修改時區
TZ=Asia/Shanghai

# 生成一個隨機的數據庫密碼
DB_PASSWORD=your_secure_password

4. 啟動服務

bash
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 還在快速迭代中,建議定期更新以獲取新功能:

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

🛡️ 結語

Immich 讓你的照片重新回到了你自己的手中。在 ESXi 中部署 Immich,不僅利用了閒置的硬件資源,更為全家提供了一個安全、私密且極其強大的數字記憶中心。

如果你還沒嘗試過,今天就是搭建它的最好時機!


延伸阅读

免责声明

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

最後更新於: