差異處

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

--- tech:immich [2025/03/22 11:06] – jonathan
+++ tech:immich [2025/09/03 15:15] (目前版本) – 設定 Google oAuth 認證方式 jonathan
@@ 行 4: / 行 4: @@
 ===== 安裝程序 =====
-  * 採用 cifs 方式將 NAS 內的 LocalPhotos <cli>//192.168.11.245/Photos/LocalPhotos</cli> 掛入 <cli>/root/Pictures</cli>
+  * 採用 nfs 方式將 LocalPhotos <cli>//192.168.11.252/pbs-zpool/nfsshare/immich</cli> 掛入 <cli>/nfs-immich</cli>
     * 處理程序:<cli>
-su -
+apk add nfs-utils
-apk add cifs-utils
+mkdir -p /nfs-immich
-cat <<EOF | tee /root/.smb > /dev/null
+mount -o nfsvers=4 -t nfs 192.168.11.252:/pbs-zpool/immich /nfs-immich
-username=jonathan
-password=xxxxxxx
-EOF
-chmod 600 /root/.smb
-mkdir -p /root/Pictures
-mount -t cifs -o credentials=/root/.smb //192.168.11.245/Photos/LocalPhotos /root/Pictures
 </cli>
-  * 如果可以正確掛上 /root/Pictures 看到 NAS 內的檔案, 就可以設定開機自動掛上 <cli>
+  * 如果可以正確掛上 /nfs-immich 看到 NAS 內的檔案, 就可以設定開機自動掛上 <cli>
-rc-update add netmount
+rc-update add nfsmount default
-echo "//192.168.11.245/Photos/LocalPhotos /root/Pictures cifs credentials=/root/.smb 0 0" >> /etc/fstab
+echo "192.168.11.252:/pbs-zpool/immich /nfs-immich nfs rw 0 0" >> /etc/fstab
 </cli>
   * 使用 Docker Compose 進行安裝 <cli>
-wget https://dl.photoprism.app/docker/docker-compose.yml
+wget https://raw.githubusercontent.com/tryweb/docker-compose/refs/heads/main/immich/docker-compose.yml
+wget https://raw.githubusercontent.com/tryweb/docker-compose/refs/heads/main/immich/.env
 </cli>
-  * 修改 docker-compose.yml 內的 restart,  密碼與網址設定 <file>
+    * {{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>
 :
-services:
+UPLOAD_LOCATION=/nfs-immich/upload
-  photoprism:
-    ## Use photoprism/photoprism:preview for testing preview builds:
-    image: photoprism/photoprism:latest
-    depends_on:
-      - mariadb
-    ## Don't enable automatic restarts until PhotoPrism has been properly configured and tested!
-    ## If the service gets stuck in a restart loop, this points to a memory, filesystem, network, or database issue:
-    ## https://docs.photoprism.app/getting-started/troubleshooting/#fatal-server-errors
-    restart: unless-stopped
 :
-      PHOTOPRISM_ADMIN_PASSWORD: "xxxxxxxxxx"          # initial superadmin password (minimum 8 characters)
+DB_USERNAME=immich
-:
+DB_PASSWORD=MyDb_Password
-      PHOTOPRISM_SITE_URL: "http://photoprism.ichiayi.com:2342/"  # server URL in the format "http(s)://domain.name(:port)/(path)"
+DB_DATABASE_NAME=immich
-:
-      PHOTOPRISM_DATABASE_PASSWORD: "xxxxxxxxxx"       # MariaDB or MySQL database user password
-:
-:
-      MARIADB_PASSWORD: "xxxxxxxxxx"
-      MARIADB_ROOT_PASSWORD: "xxxxxxxxxx"
 :
+JWT_SECRET=your_jwt_xxxxxxxxxxx-secret_key_here
 </file>
   * 啟動服務 <cli>
@@ 行 52: / 行 36: @@
 </cli>
-===== 開始使用 =====
+===== 常見問題 =====
-  * Exp. http://192.168.11.202:2342/ 使用 admin / xxxxxxx 登入
+==== 1. 中文搜尋結果不理想問題 =====
-  * 開始對 NAS 內的 LocalPhotos 建立索引 - Library -> INDEX -> START \\ {{:tech:2023-01-15_002432.png?600|}}
+  * 主要是預設的 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://docs.photoprism.app/getting-started/
+  * https://github.com/immich-app/immich/tree/main/docker
-  * https://www.hiroom2.com/2017/08/21/alpinelinux-3-6-cifs-utils-en/
+  * https://github.com/tryweb/docker-compose/tree/main/immich
+  * https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
 {{tag>AI 照片管理}}