如何在本機上使用 PhotoPrism 作為私有的 AI 驅動圖庫

¿如何在本地使用 PhotoPrism 作為私有的 AI 驅動畫廊？ 掌控你的照片庫無需依賴公有雲，這不再是夢想：借助 PhotoPrism，您可以在自己的電腦或伺服器上創建私密的、由 AI 驅動的照片庫，瀏覽多年的珍貴回憶，而無需擔心隱私洩露。本文將詳細且實用地解釋其工作原理、所需條件以及如何使用 Docker 在本地進行部署。

對許多人來說，Google Photos 非常方便，但這種便利性也帶來了人們對資料使用方式的合理疑慮。 如果您擔心隱私問題 或者，如果您需要在專業環境中遵守 GDPR 等法規，PhotoPrism 是一個強大的替代方案：自動組織、AI 驅動的標籤、高級搜尋以及專為大型收藏集設計的工作流程，所有這些都可以在您現有的基礎架構中實現。

什麼是 PhotoPrism？為什麼要在本地使用它？

PhotoPrism是一個網頁應用程式 這款人工智慧照片管理軟體（採用 Google TensorFlow 進行分類）能夠識別人物、物件、顏色和場景，從而標記和整理您的照片庫。它採用自架解決方案，因此您可以將照片和影片保存在家中或自己的伺服器上，在保護隱私的同時，也能享受現代化的功能。

它的DNA中隱藏著幾個線索： 相容於 RAW 和經典格式 例如 JPEG 或 PNG 格式；智慧索引，可偵測重複圖片；支援按時間軸、地點和標籤導航；搜尋引擎可讓您組合按相機、顏色、日期、國家/地區篩選，甚至可以將項目標記為收藏。所有功能都在您的電腦上運行，使用本地緩存，無需依賴第三方進行分析。

此介面為 PWA（漸進式 Web 應用），因此可以安裝在電腦和行動裝置的主螢幕上。 它在 Chrome、Chromium、Safari、Firefox 和 Edge 瀏覽器中尤其好用。請注意，某些視訊和音訊編解碼器（例如 H.264 中的 AAC）的播放可能會因瀏覽器而異，這在現代網路上是正常的。

另一個區別因素是它與 WebDAV 和外部服務的整合： 您可以使用 PhotoSync 等應用程式從行動裝置同步資料。此外，PhotoPrism 還顯示帶有密碼保護連結的圖庫，這些連結會過期。如果您需要地圖和位置數據，PhotoPrism 使用反向地理編碼服務和由 MapTiler 提供支援的高隱私地圖；這些資源旨在最大限度地減少資訊外洩並提高快取效能。要了解更多信息，我們提供了這份指南。 利用人工智慧整理照片，無需雲端儲存：PhotoPrism 和其他本地替代方案.

需求、硬體和性能

為了順利進行在地使用 建議至少配備兩個 CPU 核心、3 GB 記憶體和 64 位元系統。除了最低配置要求外，建議記憶體容量與核心數相符；對於大型庫，建議使用本地 SSD 儲存資料庫和快取。索引操作非常消耗資源；使用 SSD 並配合良好的交換機制，可以顯著提升索引效能。

如果您的伺服器交換空間小於 4 GB，或者您設定了非常嚴格的記憶體/交換空間限制， 您可能會遇到意外重啟的情況。 當索引器需要更多資源時（對於大型 RAW 檔案、360 度全景圖或 4K 影片來說很常見），請啟用或增加交換空間並耐心等待：對於大量照片，初始索引可能需要幾天時間。

關於資料庫方面， PhotoPrism 支援 SQLite 3 和 MariaDB 10.5.12 及更高版本SQLite 入門簡單，但如果您追求效能和可擴充性，MariaDB 是更好的選擇。由於需求量低且功能不如 MariaDB，MySQL 8 已停止支援。重要提示：避免使用 MariaDB 鏡像中的「latest」標籤；請堅持使用經過全面測試的穩定版本。

至於平台方面，只要有 Docker 可用的地方，就可以部署該應用程式： Linux、macOS 和 Windows 系統，支援 Docker Desktop除了 FreeBSD、Raspberry Pi 和許多 NAS 設備之外，還可以透過 PikaPods 或 DigitalOcean 使用雲端服務，不過為了保護隱私和控制，我們在這裡將重點放在本地解決方案。

Docker 安裝步驟詳解

如果你從未使用過 Docker別擔心：使用 Docker Compose 部署非常簡單。 YAML 檔案可以放在任何你喜歡的資料夾中；首先，建立一個用於存放 PhotoPrism 的目錄，並將 docker-compose.yml 檔案保存在該目錄中。重要的是要清晰地定義原始文件磁碟區、儲存磁碟區以及（如果需要）匯入磁碟區。

以下是三種典型的配置： 原始資料（唯讀或讀寫）、儲存（快取、資料庫和邊車）和匯入 （可選）您可以將原始檔案指向您已有照片的資料夾。我的建議是：將儲存空間與照片分開，以免資料庫和快取與原始檔案混淆。

docker-compose 的基本範例 使用 MariaDB 和 PhotoPrism（您可以根據自己的環境進行調整）：

version: '3.5'
services:
  mariadb:
    image: 'mariadb:11'
    restart: unless-stopped
    security_opt:
      - 'seccomp:unconfined'
      - 'apparmor:unconfined'
    command: >-
      --innodb-buffer-pool-size=512M
      --transaction-isolation=READ-COMMITTED
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_unicode_ci
      --max-connections=512
      --innodb-rollback-on-timeout=OFF
      --innodb-lock-wait-timeout=120
    environment:
      MARIADB_AUTO_UPGRADE: '1'
      MARIADB_INITDB_SKIP_TZINFO: '1'
      MARIADB_DATABASE: 'photoprism'
      MARIADB_USER: 'photoprism'
      MARIADB_PASSWORD: 'cambia-esto'
      MARIADB_ROOT_PASSWORD: 'cambia-esto'
    volumes:
      - './database:/var/lib/mysql'

  photoprism:
    image: 'photoprism/photoprism:latest'
    depends_on:
      - mariadb
    stop_grace_period: 10s
    security_opt:
      - 'seccomp:unconfined'
      - 'apparmor:unconfined'
    ports:
      - '2342:2342'
    environment:
      PHOTOPRISM_ADMIN_USER: 'admin'
      PHOTOPRISM_ADMIN_PASSWORD: 'cambia-esto'
      PHOTOPRISM_AUTH_MODE: 'password'
      PHOTOPRISM_SITE_URL: 'http://localhost:2342/'
      PHOTOPRISM_DEFAULT_TLS: 'true'
      PHOTOPRISM_DATABASE_DRIVER: 'mysql'
      PHOTOPRISM_DATABASE_SERVER: 'mariadb:3306'
      PHOTOPRISM_DATABASE_NAME: 'photoprism'
      PHOTOPRISM_DATABASE_USER: 'photoprism'
      PHOTOPRISM_DATABASE_PASSWORD: 'cambia-esto'
      PHOTOPRISM_ORIGINALS_LIMIT: 5000
      PHOTOPRISM_JPEG_QUALITY: 85
      PHOTOPRISM_DISABLE_WEBDAV: 'false'
      PHOTOPRISM_DISABLE_TENSORFLOW: 'false'
      PHOTOPRISM_DETECT_NSFW: 'false'
      PHOTOPRISM_SIDECAR_JSON: 'true'
      PHOTOPRISM_SIDECAR_YAML: 'true'
    working_dir: '/photoprism'
    volumes:
      - '~/Pictures:/photoprism/originals'
      - './storage:/photoprism/storage'
      - './import:/photoprism/import'

文件準備就緒後，在該資料夾中打開終端並運行： docker compose up -d首次初始化會下載圖像並建立資料庫；請稍等幾分鐘。然後，它開始建立索引。 docker compose exec photoprism photoprism index未來將進行更新： docker compose pull photoprism, docker compose stop photoprism y docker compose up -d --no-deps photoprism.

預設憑證：管理員使用者名稱和您在環境變數中定義的密碼。 記得更改弱密碼。 首次登入後即可進行設定。如果您要匯入大量資料，建議在初始索引期間停用機器學習功能，稍後再啟用。

安全存取、本地網域和反向代理

如果你打算將服務暴露在你的網路之外， 始終將其放在 HTTPS 之後 使用 Traefik 或 Caddy 等反向代理。如果沒有 TLS 加密，所有資料都將以明文形式傳輸，容易被攔截。保護隱私是方案的一部分：使用有效的憑證並將 HTTP 重新導向到 HTTPS。

要使用類似 photoprism.localhost 這樣的網域（不含連接埠）進行本地訪問，您有兩種選擇： 映射標準連接埠 在主機上（例如，僅供本機使用，連接埠號碼為 80:2342），或設定 Traefik 監聽連接埠 80 並將流量路由至連接埠 2342 上的服務。確保容器標籤包含路由器、入口點和內部服務連接埠。使用 Traefik 的典型模式是定義主機規則、Web 入口點，並將服務連接埠指向 2342。

另一個關鍵點是防火牆： 允許傳入連接 連接到您使用的連接埠（Web 和 HTTPS），並在必要時連接到地理編碼 API 和 Docker。如果您阻止這些出站連接，地圖和地點將無法正常運作。

組織架構、人工智慧和能夠產生影響的功能

PhotoPrism 可與強大的目錄和附屬組件配合使用； 您可以使用 JSON 和 YAML 編寫元資料。 除了原圖之外，它還會保存你的照片，因此不完全依賴資料庫。使用 TensorFlow 進行分類（人臉、物件、場景和 NSFW 內容）可以加快搜尋速度，而決定是否將敏感照片標記為私密照片也只需啟用一個設定即可。

為了保持效能，您可以調整縮圖品質和大小、視訊編解碼器、位元速率限制和縮放。 FFmpeg 由變數配置 而且，如果您的硬體支持，您可以將轉碼任務委託給 Intel QSV、Nvidia、Apple 或 VAAPI 進行加速。只需點擊幾下，您就可以從基本工作流程切換到專為您的系統量身定制的工作流程。

導航靈活便捷：時間軸、相簿、標籤、收藏夾和地點。 進階搜尋面板 它支援按相機、日期、國家/地區、顏色或人物進行篩選。如果您之前擁有雜亂無章的圖庫，重複偵測和元資料標準化功能可以幫助您輕鬆整理圖庫。

在行動裝置上，沒有官方應用程序，但您可以使用 PWA 或使用 PhotoSync 等應用程式透過 WebDAV 進行同步。 PWA非常實用。它像原生應用程式一樣安裝，省去了每次都要使用瀏覽器的麻煩。但是，與該領域的大多數解決方案一樣，在 Android TV 或 Google TV 上的體驗有限；如果您想與家人舒適地一起瀏覽照片，最可靠的選擇仍然是使用連接到電視的筆記型電腦上的瀏覽器。

誰最能從PhotoPrism中受益

專業攝影師 面對成千上萬的 RAW 文件，您會發現一個強大的幫手：索引、按鏡頭或相機搜索、重複文件檢測以及用於避免修改原始文件的附加文件。對您的照片集進行管理、標記和整合，從長遠來看可以節省大量時間。

至 平面設計師和創意人員顏色編碼的標籤和物品標籤可以幫助您快速找到視覺靈感。依時間順序瀏覽和使用時間軸可以幫助您輕鬆檢索想法和素材，避免遺漏。

在房地產領域， 房地產經紀人 他們可以按地點、日期或標籤對房源進行分類，並透過受保護的、會過期的連結分享相簿。隱私至關重要，而擁有伺服器控制權則是一大優勢。

數位行銷團隊 他們喜歡井然有序的資源庫，並能按活動、日期和國家/地區進行篩選。多用戶支援和邊車（sidecar）的使用，使得避免破壞原始資源以及在不對外公開的情況下共享內部資源庫變得輕而易舉。

至 旅行者、數位檔案管理員和開發人員其優勢包括互動式地圖，以及透過 WebDAV 將圖庫與其他服務整合。如果合規性也是您關注的重點，將資料保存在您自己的基礎架構上有助於您遵守 GDPR 和內部政策。

熱門替代方案及其適用性

伊米奇的打擊非常猛烈。它與 Google Photos 非常相似，具有流暢的時間軸、基於關鍵字的收藏夾、行動裝置同步以及按概念或顏色進行語義搜尋的功能。透過 Immich-Go 等工具，從 Google Takeout 匯入照片也極為方便。缺點在於，Android TV 應用的功能有限；如果要在電視上使用，最好還是選擇筆記型電腦瀏覽器。

在辦公室軟體套件領域， Nextcloud Photos 和 Memories 插件 如果您已經在使用 Nextcloud，那麼它們是一個不錯的選擇。 Recognize 應用程式提供臉部辨識功能，而 Imaginary 和 Preview Generator 則可以加快預覽速度。介面功能齊全，但像標記收藏夾這樣的快捷操作不如其他方案那樣即時。

光結構 它提供了一種不同的方式，主螢幕會隨機顯示一系列照片，幫助你重新發現你的照片庫。它運行速度快，介面簡潔，但其 Plus 模式解鎖了收藏夾和臉部辨識等功能，這可能會嚇跑那些尋求完全免費且本地化服務的用戶。

Piwigo、Photoview、Lychee 或 Photonix 它們涵蓋多種場景：簡單的圖庫、基本的識別功能，或按標籤整理照片。如果您優先考慮的是時間軸和快捷方式，它們可能無法滿足您的需求。 LibrePhotos 從理論上非常有前景，但它的實際操作可能比較繁瑣，而且在配置較低的電腦上運作並不總是流暢。

向上 Plex 已推出 Plex Photos。 Plex目前在iOS、Android和網頁端都處於測試階段，如果您已經是Plex用戶，那麼它是一個不錯的選擇，儘管它目前還沒有完善的Android TV原生應用程式。另一方面，Ente已經開源了其程式碼，並擁有端對端加密；它看起來很有前景，即使是桌面用戶端也是如此，儘管它的自託管需要一定的技術知識。

Docker 初學者常見問題解答

YAML檔案應該放在哪裡？你可以把它放在任何你喜歡的資料夾裡。重要的是要從該目錄執行 Docker Compose 命令，這樣它才能讀取正確的 YAML 檔案。把 docker-compose.yml 檔案和 storage、database 和 import 等子資料夾放在一起，這樣所有內容都觸手可及。

我應該掛載我目前的照片資料夾嗎？ 是的，請將您的照片資料夾對應到 /photoprism/originals。如果您不想授予寫入權限，可以將其掛載為唯讀，但這樣您將失去就地編輯元資料的功能；PhotoPrism 也避免使用 sidecar 檔案修改原始檔案。

資料庫和快取都放在哪裡？ 最好將它們儲存在照片資料夾之外的單獨路徑中，該路徑對應到 /photoprism/storage（如果您使用的是 MariaDB，則對應到 DBMS 容器中的 ./database）。這樣可以避免快取和資料庫與原始檔案混雜在一起。

如何在 Docker 中掛載資料夾在 volumes 鍵中，使用 host_path:container_path 格式。例如，~/Pictures:/photoprism/originals。驗證運行容器的使用者的權限；如有必要，請使用 PHOTOPRISM_UID 和 PHOTOPRISM_GID 變數或 user 指令來調整權限。

我們需要 Traefik 還是 Caddy？ 只有當您需要自動啟用 TLS、使用簡潔的網域名稱和路徑，或將服務暴露給網路時才需要這樣做。在本地，映射連接埠 2342 就足夠了。如果您使用 Traefik，請為服務定義主機、Web 入口點和內部連接埠 2342；這樣您就可以使用 photoprism.localhost 存取它，而無需新增 :2342。

支持、更新和社區

該項目旨在 最注重隱私的選項 而且它擁有動態的開發路線圖。他們的目標是零缺陷，因此不會為新功能設定確切的發布日期：開發進度也取決於資金和社群支援。如果您覺得它很適合您，成為會員可以加速您最感興趣的功能的發展。

為了消除任何疑慮，您有 GitHub 和社群聊天中的討論白銀、黃金和鉑金會員也可以聯繫技術支援。提交錯誤報告前，請先查看故障排除清單；通常問題出在本機設定上，可以很快解決。

在更新中，您可以自動執行以下操作： 崗樓 如果你覺得這樣可以接受，那就沒問題；否則，最好在穩定版發佈時採用「拉取、停止、再更新」的流程。在重要環境中，無論是 PhotoPrism 還是 MariaDB，都應使用固定版本，避免使用最新版本，以確保更新可控。

如果您對地圖和反向地理編碼感到擔憂， PhotoPrism 和 MapTiler 這些服務提供極高的隱私保護。它們的使用受項目保護，並採用快取機制來提升效能，防止您的查詢被過度曝光。

最後，請記住一些顯而易見但至關重要的事情： 備份並非可選項。如果您負責管理家庭回憶或客戶資料，那麼備份就是您的責任。請務必將您的資料庫、儲存空間以及最重要的原始檔案備份到至少兩個不同的位置。切勿使用廉價的USB或速度較慢的網路資料夾來儲存資料庫。

在這個階段， 光棱鏡 他贏得了這個職位。 作為一款功能強大的本地 Google Photos 解決方案，它具備以下優勢：AI 可用於照片分類，SSD 速度飛快，Sidecar 可用於保存原始照片，以及流暢的 PWA 體驗。如果您更注重照片的娛樂性而非編目功能，那麼 Immich 等其他方案的介面可能會吸引您；如果您追求精細的整理，PhotoPrism 將是您的最佳選擇。無論您的需求是什麼，只要配置好 Docker Compose、足夠的交換空間、HTTPS 網路連接以及備份措施，您就能擁有一個穩定可靠的系統，足以應對未來數年的需求。