差異處

這裏顯示兩個版本的差異處。

--- tech:immich [2025/03/22 14:04] – jonathan
+++ tech:immich [2025/09/03 15:15] (目前版本) – 設定 Google oAuth 認證方式 jonathan
@@ 行 1: / 行 1: @@
-====== (Draft)安裝 Immich (取代 Google 相簿) ======
+====== 安裝 Immich (取代 Google 相簿) ======
   * VM : 2vCore / 4GRAM / 32GSSD
   * OS : Alpine 3 參考 - [[tech/alpine_docker]]
@@ 行 19: / 行 19: @@
 wget https://raw.githubusercontent.com/tryweb/docker-compose/refs/heads/main/immich/.env
 </cli>
+    * {{repo>https://raw.githubusercontent.com/tryweb/docker-compose/refs/heads/main/immich/docker-compose.yml | docker-compose.yml}}
+    * {{repo>https://raw.githubusercontent.com/tryweb/docker-compose/refs/heads/main/immich/.env | .env}}
   * 修改 .env 內的密碼與網址設定 <file>
 :
@@ 行 33: / 行 35: @@
 docker-compose up -d
 </cli>
+===== 常見問題 =====
+==== 1. 中文搜尋結果不理想問題 =====
+  * 主要是預設的 CLIP 模型 ViT-B-32__openai 中文支援度低, 需要更換支援多語言的模型 Exp. XLM-Roberta-Large-Vit-B-16Plus
+  * 處理方式如下
+    - 找到 immich 的模型存放目錄 Exp. /var/lib/docker/volumes/root_model-cache/_data/
+    - 找到 Hugging Face 模型頁面 Exp. https://huggingface.co/immich-app/XLM-Roberta-Large-Vit-B-16Plus
+    - 透過 git 方式將模型下載到存放目錄 Exp. <cli>
+cd clip
+git clone https://huggingface.co/immich-app/XLM-Roberta-Large-Vit-B-16Plus
+</cli>
+    - 重起服務 <cli>
+docker compose down && docker compose up -d
+</cli>
+    - 進入 immich 管理介面修改使用模型設定
+      * 設定 -> 機器學習設定 -> 智慧搜尋 -> CLIP 模型 改成 **XLM-Roberta-Large-Vit-B-16Plus**
+      * ++看設定畫面|{{:tech:螢幕擷取畫面_2025-07-22_113547.png?1024|}}++
+    - 重新執行全部智慧搜尋項目 : 任務 -> 智慧搜尋 -> 全部
+      * ++看設定畫面|{{:tech:螢幕擷取畫面_2025-07-22_113907.png?1024}}++
+==== 2. 設定 Google oAuth 認證方式 =====
+  * 參考 - https://immich.app/docs/administration/oauth/
+  * Google 端設定
+    - https://console.cloud.google.com/
+    - 建立或選擇一個專案 Exp. ichiayi -> 選擇 API 和服務 -> oAuth 同意畫面
+    - Google Auth Platform -> 用戶端 -> 建立用戶端
+      - 應用程式類型 : 網頁應用程式
+      - 名稱 : Exp. immich
+      - 已授權的 JavaScript 來源 : Exp. https://your-server-domain-name
+      - 已授權的重新導向 URI : Exp. https://your-server-domain-name/auth/login 與 https://your-server-domain-name/user-settings (如果要支援行動 APP 還要加上 https://your-server-domain-name/api/oauth/mobile-redirect )
+    - 將產生的 ClientID 與 ClientSecret 記錄下來
+  * Immich 端系統管理設定
+    - admin -> 設定 -> 驗證設定 -> oAuth
+      - 使用 OAuth 登入 : 開啟
+      - ISSUER_URL : https://accounts.google.com
+      - CLIENT_ID : 填上 Google 端產生的 ClientID Exp. 51xxxxxxx0-9xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxv.apps.googleusercontent.com
+      - CLIENT_SECRET : 填上 Google 端產生的 ClientSecret Exp. Gxxxxx-UxxxxxxxxxxPB_4xxxxxxxxxxxxz
+      - TOKEN_ENDPOINT_AUTH_METHOD : 選 client_secret_post
+      - SCOPE : openid email profile
+      - ID_TOKEN_SIGNED_RESPONSE_ALG : RS256
+      - USERINFO_SIGNED_RESPONSE_ALG : none
+      - 請求逾時 : 30000
+      - 儲存標籤宣告 : preferred_username
+      - 角色宣告 : immich_role
+      - 儲存配額宣告 : immich_quota
+      - 按鈕文字 : Login with OAuth
+      - 自動註冊 : 關閉 (避免閒雜人等加入使用) -> 表示系統管理者需要先建立使用者 Exp. Google 帳號 [email protected] 後, 這 Google 帳號才能透過 Google oAuth 方式登入 Immich
+      - 自動啟動 : 關閉
+      - 覆蓋行動端重新導向 URI : 啟用 (如果要支援行動 APP)
+      - 行動端重新導向 URI : https://your-server-domain-name/api/oauth/mobile-redirect (如果要支援行動 APP)
+==== 3. 已經存在的使用者設定連結 Google oAuth 認證方式 =====
+  * 之前已經建立的使用者 Exp. [email protected] 想要使用 Google oAuth 帳號 Exp. [email protected] 登入
+  - 先使用原本 [email protected] 登入 Immich 網站
+  - 點右上角 ICON  -> 帳號設定
+    - 2FR OAuth -> 點連接 OAuth
+    - 會跳出 Google oAuth 帳號登入畫面進行登入 Exp. [email protected]
+  - 登出後, 在登入畫面選 Login with OAuth
+    - 跳出 Google oAuth 帳號登入畫面進行登入 Exp. [email protected]
+    - 登入後看到的是原本 [email protected] 的照片資料
 ===== 參考網址 =====
-  *
+  * https://github.com/immich-app/immich/tree/main/docker
+  * https://github.com/tryweb/docker-compose/tree/main/immich
+  * https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
 {{tag>AI 照片管理}}