photoprism/photoprism

PhotoPrism – AI 驅動的個人照片管理工具

產品簡介 – PhotoPrism 是一款開源的自託管 Web 應用程式，讓您可以瀏覽、整理和分享您的照片和影片。它使用裝置端機器學習模型自動標籤圖像、識別面部並提取元數據，同時確保您的數據隱私。

核心功能

• 自動標籤 – 深度學習模型分析圖像內容並添加描述性標籤（例如：dog, beach, sunset）和位置資訊。
• 人臉識別 – 偵測並分組面部，以便您可以快速找到家人或朋友的照片。
• 強大的搜尋 – 結合標籤、日期、位置、解析度、顏色、品質等篩選器，在幾秒鐘內定位任何媒體檔案。
• RAW 與影片支援 – 無需轉換即可處理原始相機檔案和多種影片格式。
• 漸進式 Web 應用 (PWA) – 可在桌面端、平板電腦或手機上執行；可以像原生應用一樣安裝。
• 同步與編輯 – WebDAV、PhotoSync 及其他相容應用可以讓您備份行動裝置並直接從電腦編輯檔案。
• 隱私至上 – 所有 AI 處理均在本地（或您自己的伺服器上）執行；除非您主動選擇，否則數據不會發送到第三方雲端服務。

工作原理（高層級）

1. 攝取 (Ingestion) – 您將 PhotoPrism 指向一個資料夾（或透過 WebDAV/PhotoSync 同步）。它會掃描檔案、提取 EXIF/XMP 元數據並儲存縮圖。
2. 索引 (Indexing) – 內置的基於 TensorFlow 的模型會分析每張圖像，生成標籤和面部嵌入。
3. 搜尋索引 – 標籤、位置、時間戳、顏色等被儲存在可搜尋的資料庫（SQLite/PostgreSQL）中。

• Web UI / PWA – 前端 (Vue.js) 查詢索引並在響應式圖庫中展示結果。

入門指南

• 前提條件 – Docker (或 Docker-Compose) 和 Web 瀏覽器。該專案為 AMD64、ARM64 和 Raspberry Pi 提供多架構 Docker 鏡像。
• 典型安裝 – docker run -p 2342:2342 -v /path/to/pictures:/photoprism/storage photoprism/photoprism:latest（完整 compose 檔案和環境變數請參閱官方文件）。
• 其他方式 – 下載適用於 Linux/macOS/Windows 的 tar.gz 軟體包並執行綑綁的二進位檔案。

典型使用場景

• 希望在不放棄隱私的情況下獲得 AI 輔助整理功能的家庭個人照片存檔。
• 需要在本地擁有可搜尋媒體庫的小型企業或攝影愛好者。
• 任何想要尋找 Google Photos 等雲端服務自託管替代方案的使用者。

局限性 / 注意u事項

• AI 模型是預訓練的；它們對常見物體和面部效果良好，但可能會遺漏小眾類別。
• 對於大型庫，初始索引可能會消耗大量 CPU；配備高效能 CPU（或可選的 GPU 支援）可以提高速度。
• 免費社群版缺少部分高級功能（互動式世界地圖、私人支援），這些功能僅向付費會員開放。
• 沒有內建的協作編輯功能——變更僅保存在伺服器實例本地。

了解更多

• 完整文件：https://docs.photoprism.app/
• 公開演示（唯讀）：https://try.photoprism.app/
• 社群聊天和討論連結列在 README 中。

---

PhotoPrism 根據 AGPL-3.0 授權條款發布；文件採用 CC BY-NC-SA 4.0 授權。