文章
文章用户商铺文档快讯圈子网址导航

搭建属于自己的个人相册 ——PhotoPrism

释放双眼，带上耳机，听听看~！

1. 前言

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

总的来说是非常好用的。

搭建属于自己的个人相册 ——PhotoPrism

2. 项目展示

搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism

3. 相关地址

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

4. 搭建环境

  • 服务器：咕咕这边用的彬红茶IDC ，（最好选 非大陆的，而且线路还不错的机器）如果是小白刚开始玩的话，也可以选择 Racknerd 的高性价比服务器（注意地区选美国西部城市的）或者 莱卡云的香港或者美国 CN2 GIA
  • 系统：Debian 11 （DD 脚本 非必需 DD，用原来的系统也 OK，之后教程都是用 Debian 或者 Ubuntu 搭建～）
  • 安装好 Docker、Docker-compose
  • 【非必需但建议】域名一枚，并做好解析到服务器上
  • 【非必需】提前安装好宝塔面板海外版本 aapanel，并安装好 Nginx
  • 【非必需本教程选用】安装好 Nginx Proxy Manager（相关教程）

服务器建议：在有更大的内存的服务器上运行。官方建议是 4G，大于 2G 内存的添加 SWAP 后可尝试运行

添加 SWAP 脚本：

BASH

wget -O box.sh https://raw.githubusercontent.com/BlueSkyXN/SKY-BOX/main/box.sh && chmod +x box.sh && clear && ./box.sh

5. 搭建视频（以后有时间再录 = =）

5.1 YouTube

无

5.2 哔哩哔哩

无

6. 搭建方式

如果你不是用的腾讯云的轻量应用服务器，可以直接跳到 6.1 部分。

安装系统（腾讯云轻量应用服务器）

搭建属于自己的个人相册 ——PhotoPrism

腾讯云轻量服务器最大的特点就是 “轻量”，相比 CVM，更适合小白上手，这边我们之间选择 Docker 基础镜像，就可以省去后面安装 Docker 的步骤（如果你非要用国内的服务器，这边装的 Docker 镜像还会帮你配置好国内镜像源，让你加速访问 docker 镜像资源）不建议用国内的 。

登陆（腾讯云轻量应用服务器）

搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism

6.1 安装 Docker 与 Nginx Proxy Manager

可以直接参考这篇内容：

https://blog.binhongtea.top/%e4%b8%80%e4%b8%aa%e5%8f%8d%e5%90%91%e4%bb%a3%e7%90%86%e7%a5%9e%e5%99%a8-nginx-proxy-manager

6.2 创建安装目录

创建一下安装的目录：

BASH

sudo -i

mkdir -p /root/data/docker_data/photoprism

cd /root/data/docker_data/photoprism

vim docker-compose.yml

英文输入法下，按 i

YAML

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:
– “8080: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

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

切换成英文输入法，修改好之后，按一下 esc，然后 :wq 保存退出。

6.3 打开服务器防火墙（非必需）并访问网页

打开防火墙的端口 8080

举例，腾讯云打开方法如下（部分服务商没有自带的面板防火墙，就不用这步操作了）：

搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism

类似图中的，这边我们填 8080，示例填 photoprism ，确定即可（如果你在 docker-compose 文件里换了 9009，这边就需要填 9009，以此类推）

搭建属于自己的个人相册 ——PhotoPrism

查看端口是否被占用（以 8080 为例），输入：

BASH

lsof -i:8080 #查看 8080 端口是否被占用，如果被占用，重新自定义一个端口

如果啥也没出现，表示端口未被占用，我们可以继续下面的操作了～

如果出现：

BASH

-bash: lsof: command not found

运行：

BASH

apt install lsof #安装 lsof

如果端口没有被占用（被占用了就修改一下端口，比如改成 8381，注意 docker 命令行里和防火墙都要改）

理论上我们就可以输入 http://ip:8080 访问了。

但是这边我们必须先搞一下反向代理！

做反向代理前，你需要一个域名！

namesilo 上面 xyz 后缀的域名一年就 7 块钱，可以年抛。（冷知识，namesilo 上 6 位数字的 xyz 续费永远都是 0.99 美元 = =）

如果想要长期使用，还是建议买 com 后缀的域名，更加正规一些，可以输入 laodade 来获得 1 美元的优惠（不知道现在还有没有）

namesilo 自带隐私保护，咕咕一直在用这家，价格也是这些注册商里面比较低的，关键是他家不像其他家域名注册商，没有七七八八的套路！（就是后台界面有些丑古老 = =）

彬红茶二级域名

我们接着往下看！

7. 反向代理

7.1 利用 Nginx Proxy Manager

在添加反向代理之前，确保你已经完成了域名解析，不会的可以看这个：域名一枚，并做好解析到服务器上

搭建属于自己的个人相册 ——PhotoPrism

之后，登陆 Nginx Proxy Manager（不会的看这个：安装 Nginx Proxy Manager（相关教程））

注意：

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

这边以 photoprism 为例子，element 也是一样操作即可。

直接丢几张图：

搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism

注意填写对应的 域名、IP 和 端口，按文章来的话，应该是 8080

IP 填写：

如果 Nginx Proxy Manager 和 photoprism 在同一台服务器上，可以在终端输入：

BASH

ip addr show docker0

查看对应的 Docker 容器内部 IP。

搭建属于自己的个人相册 ——PhotoPrism

否则直接填 photoprism 所在的服务器 IP 就行。

7.2 利用宝塔面板

发现还是有不少小伙伴习惯用宝塔面板，这边也贴一个宝塔面板的反代配置：

直接新建一个站点，不要数据库，不要 php，纯静态即可。

然后打开下面的配置，修改 Nginx 的配置。

搭建属于自己的个人相册 ——PhotoPrism
搭建属于自己的个人相册 ——PhotoPrism

代码如下：

NGINX

location / {
proxy_pass http://127.0.0.1:8080/; # 注意改成你实际使用的端口
rewrite ^/(.*)$ /$1 break;
proxy_redirect off;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade-Insecure-Requests 1;
proxy_set_header X-Forwarded-Proto https;
}

此方法对 90% 的反向代理都能生效，然后就可以用域名来安装访问了。

有同学可能会问，为什么不直接用宝塔自带的反向代理功能。

搭建属于自己的个人相册 ——PhotoPrism

也可以，不过咕咕自己之前遇到过当有多个网站需要反代的时候，在这边设置会报错的情况 = =

所以后来就不用了，直接用上面的方法来操作了。

8. 使用教程

建议参考视频，或者自己尝试一下。

8.1 更新 photoprism

YAML

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 标记和未被容器使用的镜像

提示：

BASH

WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N]

输入 y

利用 Docker 搭建的应用，更新非常容易～

8.2 卸载 photoprism

同样进入安装页面，先停止所有容器。

BASH

cd /root/data/docker_data/photoprism

docker-compose down

cd ..

rm -rf /root/data/docker_data/photoprism # 完全删除

可以卸载得很干净。

9. 常见问题及注意点

待补充

10. 结尾

祝大家用得开心，有问题可以去 GitHub 提 Issues，也可以在评论区互相交流探讨。

同时，有能力给项目做贡献的同学，也欢迎积极加入到 项目 中来，贡献自己的一份力量！

最后，感谢开发人员们的辛苦付出，让我们能用到这么优秀的项目！

参考资料

https://github.com/photoprism/photoprism/

给TA打赏
共{{data.count}}人
人已打赏
docker网站
docker网站

搭建属于自己的个人相册 ——PhotoPrism

2024-1-29 11:02:51

docker网站

一个反向代理神器 ——Nginx Proxy Manager

2024-1-29 11:09:51

重要声明

本站资源大多来自网络，如有侵犯你的权益请联系管理员，我们会第一时间进行审核删除。站内资源为网友个人学习或测试研究使用，未经原版权作者许可,禁止用于任何商业途径！请在下载24小时内删除！

如果遇到付费才可观看的文章，建议升级会员或者成为认证用户。全站所有资源“任意下免费看”。本站资源少部分采用7z压缩，为防止有人压缩软件不支持7z格式，7z解压，建议下载7-zip，zip、rar解压，建议下载WinRAR。

0 条回复 A文章作者 M管理员
    暂无讨论，说说你的看法吧
❯

解锁会员权限

开通会员

解锁海量优质VIP资源

立刻开通
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索

  • 扫码打开当前页

返回顶部

关注我们

Guducat.CN 孤独豹猫的个人博客
一个兴趣使然的网站

彬红茶 2023-2024 版权所有

-->