前言

PhotoPrism是一款基于AI技术的开源照片管理工具，能够帮助用户自动整理、分类和搜索个人照片与视频。无论你是想要搭建私人照片服务器，还是希望摆脱对商业云服务的依赖，本教程都将从零开始，手把手教你如何在Linux系统上部署PhotoPrism。无需任何专业背景，只需按照步骤操作，你就能拥有一个功能强大的本地照片管理系统。

一、准备工作：

准备一台具备公网IP的云服务器（推荐使用雨云）

优惠注册地址：https://www.rainyun.com/sn_

使用优惠码：sn

注: 使用优惠码注册后绑定微信可领取5折优惠券

服务器选购步骤：

1. 注册后，在"总览"页面找到"云服务器"入口，进入后点击"购买云服务器"

​

2.根据需求选择合适的配置，建议选择国内的服务器，访问更快，选好后点击立即购买即可

3.选好后进入控制台，使用SSH客户端远程连接服务器即可，SSH客户端建议选择FinalShell

二、安装Docker和Docker Compose

2.1 安装Docker

首先，我们需要安装Docker，这是运行PhotoPrism的基础环境。

打开终端，执行以下命令：

# 更新软件包列表
sudo apt update

# 安装Docker依赖
sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release

# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 添加Docker仓库
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker引擎
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io

# 启动Docker服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

# 将当前用户添加到docker组，避免每次使用sudo
sudo usermod -aG docker $USER

注意：执行最后一条命令后，你需要重新登录系统才能使权限生效。

验证Docker是否安装成功：

docker --version

如果显示Docker版本信息，说明安装成功。

2.2 安装Docker Compose

Docker Compose是一个用于定义和运行多容器Docker应用程序的工具。

# 下载Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 授予执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 创建符号链接
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

验证安装：

docker-compose --version

显示版本信息则表示安装成功。

三、下载和配置PhotoPrism

3.1 创建项目目录

为PhotoPrism创建一个专用目录，用于存放配置文件和照片：

# 创建目录
sudo mkdir -p /opt/photoprism

# 进入目录
cd /opt/photoprism

3.2 下载PhotoPrism配置文件

PhotoPrism官方提供了Docker Compose配置文件，我们直接下载：

# 下载官方docker-compose.yml文件
sudo wget https://dl.photoprism.app/docker/docker-compose.yml

3.3 修改配置文件

使用文本编辑器（如nano）打开并修改配置文件：

sudo nano docker-compose.yml

找到以下关键配置项并进行修改：

services:
  photoprism:
    environment:
      # 管理员用户名，默认为admin
      PHOTOPRISM_ADMIN_USER: "admin"

      # 初始管理员密码，请务必修改！
      PHOTOPRISM_ADMIN_PASSWORD: "your_secure_password"

      # 访问URL，如果是本地使用可保持localhost
      # 如果通过域名访问，请修改为你的域名
      PHOTOPRISM_SITE_URL: "http://localhost:2342/"

      # 数据库连接配置
      PHOTOPRISM_DATABASE_DRIVER: "mysql"
      PHOTOPRISM_DATABASE_SERVER: "mariadb:3306"
      PHOTOPRISM_DATABASE_NAME: "photoprism"
      PHOTOPRISM_DATABASE_USER: "photoprism"
      PHOTOPRISM_DATABASE_PASSWORD: "photoprism_password"

    # 映射目录配置
    volumes:
      # 原始照片目录：冒号前是主机上的照片路径，请根据实际情况修改
      - "/path/to/your/photos:/photoprism/originals"

      # 导入目录（可选）
      - "/path/to/import:/photoprism/import"

      # 存储目录：存放配置、缓存和索引数据
      - "./storage:/photoprism/storage"

  mariadb:
    environment:
      # 数据库密码，应与上面photoprism配置一致
      MYSQL_ROOT_PASSWORD: "mariadb_root_password"
      MYSQL_DATABASE: "photoprism"
      MYSQL_USER: "photoprism"
      MYSQL_PASSWORD: "photoprism_password"

    # 数据库文件存储位置
    volumes:
      - "./database:/var/lib/mysql"

重要说明：

• 请将/path/to/your/photos替换为你实际存放照片的目录路径
• 务必修改所有默认密码，特别是管理员密码和数据库密码
• 如果是在本地使用，PHOTOPRISM_SITE_URL可保持http://localhost:2342/不变

3.4 创建所需目录

根据你在配置文件中设置的路径，创建相应的目录：

# 创建照片目录（如果不存在）
sudo mkdir -p /path/to/your/photos

# 创建存储目录
sudo mkdir -p /opt/photoprism/storage

# 设置权限
sudo chmod -R 755 /opt/photoprism

四、启动PhotoPrism

4.1 启动服务

在PhotoPrism目录下执行以下命令启动服务：

sudo docker-compose up -d

第一次运行时会自动下载所需的Docker镜像，包括PhotoPrism本身和MariaDB数据库。这可能需要一些时间，取决于你的网络速度。

4.2 检查服务状态

查看服务是否正常启动：

sudo docker-compose ps

如果看到两个服务（photoprism和mariadb）的状态都是"Up"，说明启动成功。

4.3 查看实时日志

如果需要监控启动过程，可以查看实时日志：

sudo docker-compose logs -f photoprism

五、访问和初始设置

5.1 访问PhotoPrism

打开浏览器，访问你配置的URL：

• 如果是在本机访问：http://localhost:2342

• 如果是在服务器上部署，使用服务器IP地址：http://服务器IP:2342

5.2 登录系统

使用你在配置文件中设置的管理员账号和密码登录：

• 用户名：admin（或你自定义的用户名）

• 密码：你设置的密码

5.3 设置中文界面

1. 登录后，点击左下角的设置（齿轮图标）

2. 在"General"选项卡中找到"Language"选项

3. 选择"简体中文"

4. 点击"Save"保存设置

5.4 开始使用

索引现有照片

如果你的照片已经存放在配置的目录中，需要建立索引：

1. 点击顶部菜单的"资料库"

2. 选择"索引"选项卡

3. 点击"开始"按钮

PhotoPrism将开始扫描你的照片目录，自动提取元数据并进行AI分析。这个过程可能需要较长时间，取决于照片数量。

导入新照片

如果你有需要导入的照片：

1. 点击"资料库"

2. 选择"导入"选项卡

3. 选择"导入"按钮，从导入目录添加照片

---

通过以上步骤，你已经成功在Linux系统上部署了PhotoPrism，拥有了一个私有的、功能强大的照片管理系统。现在你可以开始整理和探索你的照片库，享受AI技术带来的便捷照片管理体验！

如果你在部署过程中遇到任何问题，可以查阅PhotoPrism官方文档或在技术社区寻求帮助。