Immich 是一個可在自有伺服器上執行的開源照片與影片平台。本指南說明如何在 Windows 11 上使用 WSL2 與 Docker Desktop 部署 Immich，並介紹 2283 連接埠、儲存位置、Docker 磁碟區與備份。
Immich 是什麼？
Immich 是重視隱私的 Google 相簿替代方案。照片庫由您自行掌控，同時支援手機自動上傳、快速搜尋、人臉與物體辨識以及分享。
準備工作
| 項目 | 最低需求 | 建議 |
|---|---|---|
| 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 及其設定可能變更。修改儲存或容器前請備份資料，並在符合您版本的官方文件中核對命令。
留言