TrueNAS [社群版]
這是社群提供的內容，並非由 Immich 團隊正式支援，但為了方便包含在此。
您可以在專用頻道中獲得社群支援，頻道位於 Discord 伺服器。
請將應用程式問題回報至相應的 Github Repository。
Immich 可輕鬆透過 TrueNAS 社群版的 社群 Train 應用程式進行安裝。 若您此前未在系統上配置過應用程式，建議先審閱 TrueNAS 應用程式資源。
TrueNAS 社群版能使 Immich 的安裝和更新變得簡便，但您必須使用 Immich 網頁入口和行動應用程式來配置帳戶及存取資料庫。
初始設定
TrueNAS 社群版中的 Immich 應用程式會安裝，完成初步配置，然後啟動 Immich 網頁入口。 當有更新可用時，TrueNAS 會發出提醒並提供簡便的更新方式。
在 TrueNAS 裡安裝 Immich 應用程式前，請檢閱 環境變數 文件，以了解您是否想在安裝期間進行配置。 您也可以在部署應用程式後的任何時間配置環境變數。
設置儲存數據集
在開始應用程式安裝前，創建數據集，以便在安裝期間配置 儲存設置 部分。
Immich 需要七個數據集：library、upload、thumbs、profile、video、backups 和 pgData。
您可以將其組織為一個父數據集和七個子數據集，例如 /mnt/tank/immich/library、/mnt/tank/immich/upload 等。
安裝 Immich 應用程式
要安裝 Immich 應用程式，進入 應用程式，點擊 發現應用程式，在搜尋字段中輸入 Immich 或向下滾動找到 Immich 應用程式元件。
點擊元件以打開 Immich 應用程式詳情頁。
點擊 安裝 以打開 Immich 應用程式配置頁。
應用程式配置設置分成若干部分，下文進行說明。 要尋找特定字段，可以在 搜尋輸入字段 搜尋字段中點擊，向下滾動至特定部分或點擊頁面右上角的導航區域中的部分標題。
應用程式名稱與版本
接受預設值或在 應用程式名稱 字段中輸入名稱。 在大多數情況下，使用預設名稱即可，但如果計劃增加應用程式的新部署，需更改此名稱。
接受 版本 預設值。 當有新版本可用，應用程式會顯示更新徽章。 已安裝的應用程式 頁面會顯示更新應用程式的選項。
Immich 配置
接受 時區 預設值或更改為匹配您的當地時區。
時區 僅在 Immich 的 exiftool 微服務無法從圖像元數據確定時使用。
取消勾選 啟用機器學習 如果您不使用人臉識別、圖像搜尋和智能重複檢測。
接受預設選項或根據 硬體加速機器學習支持的後端 為硬體選擇 機器學習圖像類型。
Immich 的預設為 postgres，但應考慮將 資料庫密碼 設為僅包含字符 A-Za-z0-9 的自定義值。
Redis 密碼 應設為僅包含字符 A-Za-z0-9 的自定義值。
接受 記錄級別 預設值 記錄。
留下 Hugging Face 端點 空白。（此用於從其他來源下載 ML 模型。）
留下 額外環境變數 空白或參考 環境變數 進行設置。
網絡配置
接受 WebUI 埠 預設值 30041 或輸入自定義埠號。
在 TrueNAS 社群版 24.10 Electric Eel 以下版本中，只能使用 9000-65535 範圍內的埠號。
不論版本如何，為避免埠衝突，不要使用 此列表中的埠。
儲存配置
Immich 需要七個儲存數據集。
數據集的預設設置是 ixVolume（由系統自動創建的數據集），但這將使您的資料手動訪問變得更加困難，如果您刪除 Immich 應用程式，還可能導致資料丟失。（不建議）
對每個儲存選項選擇 主機路徑（系統上已存在的路徑），然後選擇 在安裝應用程式前創建的匹配數據集：Immich 資料庫儲存：library，Immich 上傳儲存：upload，Immich 快照儲存：thumbs，Immich 個人配置儲存：profile，Immich 影片儲存：video，Immich 備份儲存：backups，Postgres 數據儲存：pgData。
以上圖像顯示了示例值。
額外存储 （外部資料庫）
此功能僅限高級使用者使用。如果這是您第一次安裝 Immich，請不要掛載外部資料庫，直到您完成工作設定。此外，您的掛載路徑必須是唯一的，並且不得是您的資料庫或上傳位置，也不得是像 /lib 這樣的 Linux 目錄。下圖顯示了一個有效的示例。
您可以使用 額外存储 配置 外部資料庫。 掛載路徑 是您需要複製並粘貼到 Immich 中外部資料庫設置的位置。 主機路徑 是 TrueNAS 社群版伺服器上存儲外部資料庫的位置。
資源配置
接受 CPU 限制的預設值 2 執行緒，或者指定執行緒數量（具有多執行緒/超執行緒的 CPU 每個核心有 2 執行緒）。
以 MB 為單位指定 記憶體 限制。Immich 建議至少 6000 MB (6GB)。如果您在 Immich 配置 中選擇了 啟用機器學習，應設置為超過 8000 MB。
在 TrueNAS 社群版 24.10 Electric Eel 之前：
CPU 值以不同格式指定，默認值為 4000m，即 4 執行緒。
記憶體 值以不同格式指定，預設值為 8Gi，即 8 GiB 記憶體。該值以位元組或具有測量後綴的數字指定。例如：129M、123Mi、1000000000
啟用 GPU 配置 選項，如果您有 GPU 將用於 硬件轉碼 和/或 硬件加速機器學習。更多資訊：TrueNAS 應用程式的 GPU 直通文檔
安裝
最後，點擊 安裝。 系統將打開 已安 裝應用程式 頁面，Immich 應用程式狀態為 部署中。 當安裝完成後，狀態將更改為 運行中。
點擊 網頁入口，在 應用程式資訊 小部件中開啟 Immich 網頁界面，以設置您的帳戶並開始上傳照片。
想要瞭解更多關於應用程式安裝後如何使用的資訊，請參考 安裝後 指南。
編輯應用程式設置
- 前往 已安裝的應用程式 頁面，從已安裝的應用程式列表中選擇 Immich。
- 點擊 Application Info 小工具上的 Edit 按鈕以打開 Edit Immich 屏幕。
- 更改您希望更改的任何設置。
- 編輯屏幕上的設置與安裝屏幕上的設置相同。
- 點擊頁面底部的 Update 保存更改。
- TrueNAS 自動更新、重建並重新部署包含更新設置的 Immich 容器。
環境變數
您可以通過點擊 Additional Environment Variables 選項中的 Add 按鈕並填寫 Name 和 Value 來設置 環境變數。
某些環境變數無法在 TrueNAS 社群版應用程序上使用。這主要是因為它們可以通過 Edit Immich screen 的 GUI 選項進行配置。
一些例子包括: IMMICH_VERSION, UPLOAD_LOCATION, DB_DATA_LOCATION, TZ, IMMICH_LOG_LEVEL, DB_PASSWORD, REDIS_PASSWORD。
更新應用程式
請務必閱讀一般的 升級指南。
當更新可用時，TrueNAS 會發出警報並提供簡單的更新方式。 要 將應用程式更新到最新版本:
- 前往 Installed Applications 屏幕並從已安裝應用列表中選擇 Immich。
- 點擊 Application Info 小工具上的 Update 按鈕，從 Installed Applications 屏幕開始。
- 此操作將打開一個更新窗口並提供一些選項
- 您也可以選擇鏡像更新。
- 您可以查看變更日志。
- 點擊 Upgrade 開始升級過程，並打開顯示升級進度的計數對話框。
- 完成後，更新徽章和按鈕將消失，已安裝屏幕上的應用更新狀態將從 Update Available 變更為 Up to date。