跳到主要内容

系統設定

管理員用戶可以在此處管理 Immich 實例的設定。

提示

您可以隨時通過點擊 恢復出廠設置 按鈕返回默認設置。

驗證設定​

管理密碼、OAuth 和其他驗證設定

OAuth 驗證​

Immich 支援 OAuth 驗證。更多有關此功能及其配置的信息請參閱 此處。

密碼驗證​

管理員可以選擇禁用整個實例的用戶名和密碼登錄。這意味著包括系統管理員在內的 任何人 都無法通過這種方法登錄。如果 OAuth 驗證 也被禁用,那麼任何用戶將無法使用 任何 方法登錄。更改此設定不會影響現有會話,僅影響新的登錄嘗試。

提示

您始終可以使用 服務器 CLI 重新啟用密碼登錄。

圖片設定(縮略圖和預覽)​

  • 縮略圖 - 用於主時間線。
  • 預覽 - 用於資產瀏覽器。

默認情況下 Immich 為每個資產創建 3 個縮略圖, 模糊(thumbhash)、小縮略圖(webp)和大縮略圖(jpeg/webp)。使用這些設定,您可以修改創建的縮略圖和預覽文件的品質。

縮略圖格式
允許您選擇縮略圖的圖像格式。Webp 文件比 jpeg 更小,但編碼速度較慢。

提示

您可以在 Adobe 的網站 上詳細了解使用 webp 替代 jpeg 的優勢和劣勢。

縮略圖解析度
在檢視照片組時使用(例如主時間線、專輯視圖等)。更高的解析度可以保留更多細節,但編碼時間更長,文件大小更大,並且可能會降低應用程序的響應速度。

預覽格式
允許您選擇預覽圖像的格式。Webp 文件比 jpeg 更小,但編碼速度較慢。

預覽解析度
拍攝單張照片和用於機器學習時使用。更高的解析度可以保留更多細節,但編碼時間更長,文件大小更大,並且可能會降低應用程序的響應速度。

品質
圖像品質從 1 到 100。數值越高,品質越好,但文件也越大,此選項會影響縮略圖和預覽圖像。

偏向寬色域
對縮略圖使用 Display P3。這可以更好地保留具有寬色域圖像的鮮豔度,但在老舊設備上可能顯示不同。對於 sRGB 圖像會保持為 sRGB 以避免顏色偏移。

偏向內嵌預覽
對於嵌入式的 RAW 預覽照片,使用內嵌預覽作為圖像處理的輸入,當可用時。這可以對某些圖像生成更準確的顏色,但預覽品質取決於相機,並且圖像可能會有更多壓縮噪點。

提示

大縮略圖的預設解析度可以從 1440p(默認)降低至 1080p 或 720p 以節省存儲空間。

任務設定​

使用這些設定,您可以為微服務中的每個任務設置可同時運行的工作量。一些任務可以在性能強大的硬件和存儲具有良好 I/O 能力的計算機上設置為更高的值。

並發性越高,主機將同時處理更多資產,这些建議提高了吞吐量但不改善延遲,例如,这将使智能搜索任務處理更快,但不会使搜索更快。

請記住某些任務(例如智能搜索、人脸检测、人脸识别和视频转码)需要大量的处理能力,因此不要夸大任务数量,否则可能会因此彻底超载服务器。

重要

如果您将并发量从默认值提升,特别是对于缩略图生成,一定不要将其设置为超过可用 CPU 核心的数量。 這樣做可能會影響 API 響應速度,而不會提高縮略圖生成速度。

人脸识别并发性

人脸识别的并发值不能更改,因为 DBSCAN 传统上是顺序执行的,但目前市面上存在某些平行实现。我们的实现不支持平行方法。

外部图书馆​

图书馆监控(实验性)​

外部图书馆可以在没有进行全面重新扫描的情况下自动导入已更改的文件。只要操作系统报告了文件更改,文件就会被导入。如果您的照片是通过网络挂载的,这个功能可能无效。

定期扫描​

您可以在 管理 -> 設定 -> 圖書館畫面下設置觸發外部圖書館重新掃描的自定義時間間隔。 掃描間隔可以使用預設值或 cron 格式來設置。更多信息請參考例如 Crontab Guru。

日誌​

默認情況下 Immich 的日誌級別為 Log(通常稱為 Info)。Immich 管理員可以選擇更高或更低的日誌級別,根據個人偏好或 Immich 支援團隊的要求。

系統管理員可以通過管理面板選擇刪除用戶,系統管理員可以立即刪除用戶,也可以選擇延遲刪除(默認為7天)。此操作將永久刪除用戶的帳戶和資產。用戶刪除工作在午夜運行以檢查準備刪除的用戶。對此設置的更改將在下一次執行中評估。

版本檢查​

啟用此選項時,immich-server 將定期向 GitHub 發送請求以檢查新版本。

視頻轉碼設置​

系統管理員可以配置哪些視頻文件將被轉換為不同格式。設置可以深入更改,要了解此處使用的術語,請參閱 FFmpeg 為 H.264 編碼器、HEVC 編碼器和 VP9 編碼器的文檔。

視頻文件的哪個流將被轉碼由 轉碼策略 確定。被轉碼的流使用以下設置(配置文件名稱在括號中)。未被轉碼的流保持原樣並保留其原始設置。

可接受的容器格式 (ffmpeg.acceptedContainers)​

如果視頻資產的容器格式不在此列表中,即使沒有流需要轉碼,它也將被重新封裝為 MP4。

默認可接受的容器格式包括 mov、ogg 和 webm。

預設 (ffmpeg.preset)​

在轉碼中投入的"計算努力"量。這些使用 h264 的預設名稱,並將根據不同編碼器的配置方式轉換為適當值。

默認值為 ultrafast。

音頻編碼器 (ffmpeg.targetAudioCodec)​

當音頻流被轉碼時使用哪種音頻編碼器。可選之一為 mp3、aac、libopus。

默認值為 aac。

視頻編碼器 (ffmpeg.targetVideoCodec)​

當視頻流被轉碼時使用哪種視頻編碼器。可選之一為 h264、hevc、vp9 或 av1。

默認值為 h264。

目標解析度 (ffmpeg.targetResolution)​

在轉碼視頻流時,將最大尺寸縮小到此值,同時保持縱橫比。視頻永遠不會被放大。

默認值為 720。

轉碼策略 (ffmpeg.transcode)​

轉碼策略配置視頻資產的哪些流將被轉碼。視頻流和音頻流的轉碼決策是獨立進行的。這意味著如果視頻流需要轉碼,但音頻流不需要,則視頻流將被轉碼,而音頻流將被原樣拷貝。如果轉碼策略不要求任何流被轉碼且不要求視頻被重新封裝,則不會創建單獨的視頻文件。

默認策略為 required。

所有視頻 (all)​

視頻始終被轉碼。這確保了視頻回放的一致性。

不轉碼任何視頻 (disabled)​

視頻從不轉碼。這節省了服務器的空間和資源,但可能會阻止在不支持源格式的設備上播放(尤其是網頁瀏覽器)或在播放高比特率文件時導致高帶寬使用。

僅轉碼不屬於可接受格式的視頻 (required)​

在滿足以下任一條件時,視頻流將被轉碼:

  • 視頻是 HDR。
  • 視頻不是 yuv420p 像素格式。
  • 視頻編碼器不在 acceptedVideoCodecs 中。

如果音頻編碼器不在 acceptedAudioCodecs 中,音頻將被轉碼。

比特率超過最大值或不屬於可接受格式的視頻 (bitrate)​

除了 required 中的條件,視頻流如果其比特率超過 maxBitrate 也將被轉碼。

像素解析度高於目標解析度或不屬於可接受格式的視頻 (optimal)​

除了 required 中的條件,視頻流如果水平和垂直尺寸均高於 targetResolution,也將被轉碼。