====== 安裝 Immich (取代 Google 相簿) ======
  * VM : 2vCore / 4GRAM / 32GSSD
  * OS : Alpine 3 參考 - [[tech/alpine_docker]]

===== 安裝程序 =====
  * 採用 nfs 方式將 LocalPhotos <cli>//192.168.11.252/pbs-zpool/nfsshare/immich</cli> 掛入 <cli>/nfs-immich</cli> 
    * 處理程序:<cli>
apk add nfs-utils
mkdir -p /nfs-immich
mount -o nfsvers=4 -t nfs 192.168.11.252:/pbs-zpool/immich /nfs-immich
</cli>

  * 如果可以正確掛上 /nfs-immich 看到 NAS 內的檔案, 就可以設定開機自動掛上 <cli>
rc-update add nfsmount default
echo "192.168.11.252:/pbs-zpool/immich /nfs-immich nfs rw 0 0" >> /etc/fstab
</cli>
  * 使用 Docker Compose 進行安裝 <cli>
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>
    * {{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>
:
UPLOAD_LOCATION=/nfs-immich/upload
:
DB_USERNAME=immich
DB_PASSWORD=MyDb_Password
DB_DATABASE_NAME=immich
:
JWT_SECRET=your_jwt_xxxxxxxxxxx-secret_key_here

</file>
  * 啟動服務 <cli>
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 帳號 abc20250903@gmail.com 後, 這 Google 帳號才能透過 Google oAuth 方式登入 Immich
      - 自動啟動 : 關閉
      - 覆蓋行動端重新導向 URI : 啟用 (如果要支援行動 APP)
      - 行動端重新導向 URI : https://your-server-domain-name/api/oauth/mobile-redirect (如果要支援行動 APP)

==== 3. 已經存在的使用者設定連結 Google oAuth 認證方式 =====
  * 之前已經建立的使用者 Exp. abc@ichiayi.com 想要使用 Google oAuth 帳號 Exp. abc20250903@gmail.com 登入
  - 先使用原本 abc@ichiayi.com 登入 Immich 網站
  - 點右上角 ICON  -> 帳號設定 
    - 2FR OAuth -> 點連接 OAuth 
    - 會跳出 Google oAuth 帳號登入畫面進行登入 Exp. abc20250903@gmail.com
  - 登出後, 在登入畫面選 Login with OAuth
    - 跳出 Google oAuth 帳號登入畫面進行登入 Exp. abc20250903@gmail.com
    - 登入後看到的是原本 abc@ichiayi.com 的照片資料





===== 參考網址 =====
  * 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 照片管理}}