本文最后更新于 2024-08-25，

若内容或图片失效，请留言反馈。部分素材来自网络，若不小心影响到您的利益， 请联系我 删除。

本站只有Telegram群组为唯一交流群组， 点击加入

文章内容有误？申请成为本站文章修订者或作者？ 向站长提出申请

前言

为什么需要搭建自己的相册，因为自己搭建的相册更具隐私性（不用担心存了怪东西被删除屏蔽），并且这可以通过网页随时随地查看。虽然看似图床也有类似的功能，但是首先大多数图床不具备展示视频的功能，而且这个本就是为了作为相册而设计的，所以还有很多特色功能。根据官方介绍有强大的搜索功能，面部识别，地图和地点，相册分享，广泛的文件格式支持，支持高级元数据提取等。

1724579144244.webp

项目地址：https://github.com/photoprism/photoprism/
官方Demo：https://demo-zh.photoprism.app/
官方文档：https://docs.photoprism.app/getting-started

界面预览

1724579186560.webp
1724579191134.webp
1724579195316.webp
1724579199083.webp
1724579202836.webp
1724579206298.webp

安装Docker🐳

利用Docker-compose搭建，易于更新

先建立一个文件夹

mkdir -p /root/data/docker_data/photoprism

cd /root/data/docker_data/photoprism

vim docker-compose.yml

docker-compose填入以下内容：

version: '3.5'

# 示例 Docker Compose 配置文件，用于 PhotoPrism（Linux / AMD64）
#
# 注意：
# - 在内存小于 4 GB 或设置了内存/交换空间限制的服务器上运行 PhotoPrism 可能会导致意外重启（“崩溃”），
#   例如，当索引器临时需要更多内存来处理大文件时。
# - 如果您在家庭网络之外的公共服务器上安装 PhotoPrism，请始终在安全的 HTTPS 反向代理（如 Traefik 或 Caddy）后面运行它。
#   否则，您的文件和密码将以明文传输，任何人，包括您的提供商、黑客和政府都可以截获：
#   https://docs.photoprism.app/getting-started/proxies/traefik/
#
# 安装指南：
# - https://docs.photoprism.app/getting-started/docker-compose/
# - https://docs.photoprism.app/getting-started/raspberry-pi/
# - https://www.photoprism.app/kb/activation
#
# 故障排除清单：
# - https://docs.photoprism.app/getting-started/troubleshooting/
# - https://docs.photoprism.app/getting-started/troubleshooting/docker/
# - https://docs.photoprism.app/getting-started/troubleshooting/mariadb/
#
# CLI 命令：
# - https://docs.photoprism.app/getting-started/docker-compose/#command-line-interface
#
# 所有命令在非 root 用户下运行时可能需要加上 "sudo" 前缀。
# 这将使得卷挂载中的家目录快捷方式 ~ 指向 /root。

services:
  photoprism:
    ## 使用 photoprism/photoprism:preview 来测试预览版构建：
    image: photoprism/photoprism:latest
    ## 在 PhotoPrism 配置正确并经过测试之前不要启用自动重启！
    ## 如果服务陷入重启循环，这表明存在内存、文件系统、网络或数据库问题：
    ## https://docs.photoprism.app/getting-started/troubleshooting/#fatal-server-errors
    # restart: unless-stopped
    stop_grace_period: 10s
    depends_on:
      - mariadb
    security_opt:
      - seccomp:unconfined
      - apparmor:unconfined
    ports:
      - "2342:2342" # HTTP 端口（宿主机:容器）
    environment:
      PHOTOPRISM_ADMIN_USER: "admin"                 # 管理员登录用户名
      PHOTOPRISM_ADMIN_PASSWORD: "insecure"          # 初始管理员密码（8-72个字符）
      PHOTOPRISM_AUTH_MODE: "password"               # 认证模式（public，password）
      PHOTOPRISM_SITE_URL: "http://localhost:2342/"  # 服务器 URL 格式为 "http(s)://domain.name(:port)/(path)"
      PHOTOPRISM_DISABLE_TLS: "false"                # 即使网站 URL 以 https:// 开头并且可用证书也禁用 HTTPS/TLS
      PHOTOPRISM_DEFAULT_TLS: "true"                 # 如果没有其他证书可用，默认使用自签名 HTTPS/TLS 证书
      PHOTOPRISM_ORIGINALS_LIMIT: 5000               # 原始文件的大小限制，以 MB 为单位（提高高分辨率视频的限制）
      PHOTOPRISM_HTTP_COMPRESSION: "gzip"            # 提高传输速度和带宽利用率（none 或 gzip）
      PHOTOPRISM_LOG_LEVEL: "info"                   # 日志级别：trace, debug, info, warning, error, fatal, 或 panic
      PHOTOPRISM_READONLY: "false"                   # 不修改原始目录（功能减少）
      PHOTOPRISM_EXPERIMENTAL: "false"               # 启用实验性功能
      PHOTOPRISM_DISABLE_CHOWN: "false"              # 禁用在启动时通过 chmod 和 chown 更新存储权限
      PHOTOPRISM_DISABLE_WEBDAV: "false"             # 禁用内置的 WebDAV 服务器
      PHOTOPRISM_DISABLE_SETTINGS: "false"           # 禁用设置 UI 和 API
      PHOTOPRISM_DISABLE_TENSORFLOW: "false"         # 禁用所有依赖 TensorFlow 的功能
      PHOTOPRISM_DISABLE_FACES: "false"              # 禁用人脸检测和识别（需要 TensorFlow）
      PHOTOPRISM_DISABLE_CLASSIFICATION: "false"     # 禁用图像分类（需要 TensorFlow）
      PHOTOPRISM_DISABLE_VECTORS: "false"            # 禁用矢量图形支持
      PHOTOPRISM_DISABLE_RAW: "false"                # 禁用 RAW 图像的索引和转换
      PHOTOPRISM_RAW_PRESETS: "false"                # 启用在转换 RAW 图像时应用用户预设（降低性能）
      PHOTOPRISM_JPEG_QUALITY: 85                    # 提高 JPEG 图像和缩略图的质量和文件大小的值（25-100）
      PHOTOPRISM_DETECT_NSFW: "false"                # 自动将可能冒犯的照片标记为私有（需要 TensorFlow）
      PHOTOPRISM_UPLOAD_NSFW: "true"                 # 允许上传可能冒犯的内容（没有 TensorFlow 无效）
      # PHOTOPRISM_DATABASE_DRIVER: "sqlite"         # SQLite 是一个不需要服务器的嵌入式数据库
      PHOTOPRISM_DATABASE_DRIVER: "mysql"            # 使用 MariaDB 10.5+ 或 MySQL 8+ 而不是 SQLite 以提高性能
      PHOTOPRISM_DATABASE_SERVER: "mariadb:3306"     # MariaDB 或 MySQL 数据库服务器（主机名:端口）
      PHOTOPRISM_DATABASE_NAME: "photoprism"         # MariaDB 或 MySQL 数据库架构名称
      PHOTOPRISM_DATABASE_USER: "photoprism"         # MariaDB 或 MySQL 数据库用户名
      PHOTOPRISM_DATABASE_PASSWORD: "insecure"       # MariaDB 或 MySQL 数据库用户密码
      PHOTOPRISM_SITE_CAPTION: "AI-Powered Photos App"
      PHOTOPRISM_SITE_DESCRIPTION: ""                # 网站描述元信息
      PHOTOPRISM_SITE_AUTHOR: ""                     # 网站作者元信息
      ## 视频转码（https://docs.photoprism.app/getting-started/advanced/transcoding/）：
      # PHOTOPRISM_FFMPEG_ENCODER: "software"        # H.264/AVC 编码器（software, intel, nvidia, apple, raspberry, 或 vaapi）
      # PHOTOPRISM_FFMPEG_SIZE: "1920"               # 视频尺寸限制，以像素为单位（720-7680）（默认值：3840）
      # PHOTOPRISM_FFMPEG_BITRATE: "32"              # 视频比特率限制，以 Mbit/s 为单位（默认值：50）
      ## 首次启动时运行/安装（选项：update https gpu tensorflow davfs clitools clean）：
      # PHOTOPRISM_INIT: "https gpu tensorflow"
      ## 初始化后以非 root 用户身份运行（支持：0, 33, 50-99, 500-600, 以及 900-1200）：
      # PHOTOPRISM_UID: 1000
      # PHOTOPRISM_GID: 1000
      # PHOTOPRISM_UMASK: 0000
    ## 在初始化之前以非 root 用户身份启动（支持：0, 33, 50-99, 500-600, 以及 900-1200）：
    # user: "1000:1000"
    ## 与 FFmpeg 和 TensorFlow 共享硬件设备（可选）：
    # devices:
    #  - "/dev/dri:/dev/dri"                         # Intel QSV
    #  - "/dev/nvidia0:/dev/nvidia0"                 # Nvidia CUDA
    #  - "/dev/nvidiactl:/dev/nvidiactl"
    #  - "/dev/nvidia-modeset:/dev/nvidia-modeset"
    #  - "/dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl"
    #  - "/dev/nvidia-uvm:/dev/nvidia-uvm"
    #  - "/dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools"
    #  - "/dev/video11:/dev/video11"                 # Video4Linux 视频编码设备 (h264_v4l2m2m)
    working_dir: "/photoprism" # 不要更改或移除
    ## 存储文件夹："~" 是您家目录的快捷方式，"." 是当前目录
    volumes:
      # "/host/folder:/photoprism/folder"                # 示例
      - "~/Pictures:/photoprism/originals"               # 原始媒体文件（不要移除）
      # - "/example/family:/photoprism/originals/family" # 可以像这样挂载*额外的*媒体文件夹
      # - "~/Import:/photoprism/import"                  # *可选*可以从中将文件导入到原始文件的基础文件夹
      - "./storage:/photoprism/storage"                  # *可写的*存储文件夹，用于缓存、数据库和旁路文件（不要移除）

  ## 数据库服务器（推荐）
  ## 参见 https://docs.photoprism.app/getting-started/faq/#should-i-use-sqlite-mariadb-or-mysql
  mariadb:
    image: mariadb:10.11
    ## 如果 MariaDB 陷入重启循环，这表明存在内存或文件系统问题：
    ## https://docs.photoprism.app/getting-started/troubleshooting/#fatal-server-errors
    restart: unless-stopped
    stop_grace_period: 5s
    security_opt: # 参见 https://github.com/MariaDB/mariadb-docker/issues/434#issuecomment-1136151239
      - seccomp:unconfined
      - apparmor:unconfined
    command: mariadbd --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
    ## 永远不要将数据库文件存储在不可靠的设备上，如 USB 闪存盘、SD卡或共享网络文件夹：
    volumes:
      - "./database:/var/lib/mysql" # 不要移除
    environment:
      MARIADB_AUTO_UPGRADE: "1"
      MARIADB_INITDB_SKIP_TZINFO: "1"
      MARIADB_DATABASE: "photoprism"
      MARIADB_USER: "photoprism"
      MARIADB_PASSWORD: "insecure"
      MARIADB_ROOT_PASSWORD: "insecure"

  ## Watchtower 自动升级服务（可选）
  ## 参见 https://docs.photoprism.app/getting-started/updates/#watchtower
  ## 通过 "COMPOSE_PROFILES=update docker compose up -d" 激活
  watchtower:
    restart: unless-stopped
    image: containrrr/watchtower
    profiles: ["update"]
    environment:
      WATCHTOWER_CLEANUP: "true"
      WATCHTOWER_POLL_INTERVAL: 7200 # 每两小时检查一次更新
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"
      - "~/.docker/config.json:/config.json" # 可选，如果您有 Docker Hub 账户用于认证

yaml源文件地址：https://dl.photoprism.app/docker/docker-compose.yml

根据自己需求更改相关的设置（比如账号密码等等）

运行

docker-compose up -d

我们现在可以输入 http://ip:2342/访问了。

更新

cd /root/data/docker_data/photoprism

docker-compose pull

docker-compose up -d    # 请不要使用 docker-compose stop 来停止容器，因为这么做需要额外的时间等待容器停止；docker-compose up -d 直接升级容器时会自动停止并立刻重建新的容器，完全没有必要浪费那些时间。

docker image prune  # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像

卸载

cd /root/data/docker_data/photoprism

docker-compose down

cd ..

rm -rf /root/data/docker_data/photoprism  # 完全删除映射的数据文件

反向代理

参考教程：安装及使用

⚠️Nginx Proxy Manager（以下简称NPM）会用到80、443端口，所以本机不能占用（比如原来就有Nginx）

互联网使用请确保完成了域名解析

反向代理之后就可以用域名+/admin（即 https://你的域名/admin）来安装访问了。