第十四章：Docker / 服务器部署

14.1 服务器模式概述

Photocatalyst 支持以服务器模式运行，通过 Web 界面进行访问和管理。

两种服务器模式

模式	说明	适用场景
CLI 模式	命令行直接启动	开发测试、简单部署
Docker 模式	容器化部署	NAS、家庭服务器、生产环境

服务器模式功能

通过浏览器访问 Web 管理界面
相册分享功能
文件上传、浏览、搜索（部分高级功能需桌面版）

14.2 Docker 部署

镜像架构

标准版（x86-64 架构）
ARM 版（树莓派、Apple Silicon 等）
ARM 加速版（支持显卡加速的 ARM 架构）

使用 docker-compose（推荐）

创建 docker-compose.yaml 文件：

services:
  lightedium:
    image: lightedium:latest
    container_name: lightedium
    ports:
      - "10242:10240"
    volumes:
      - /your/photos:/photos:ro        # 照片目录（只读）
      - ./data:/app/data                # 数据持久化
    environment:
      - PORT=10240
    restart: unless-stopped

参数说明

配置项	说明
`ports`	主机端口映射（`主机端口:容器端口`），默认容器端口 10240
`volumes`	数据卷挂载：照片目录、数据目录
`PORT`	容器内服务监听端口

启动步骤

# 1. 拉取镜像
docker pull lightedium:latest

# 2. 创建数据目录
mkdir -p ./data

# 3. 启动服务
docker-compose up -d

# 4. 查看日志
docker-compose logs -f

访问服务

浏览器访问 http://your-server-ip:10242 即可使用 Web 管理界面。

14.3 CLI 模式部署

直接运行

# 编译或下载 CLI 版本
./lightedium --cli

# 指定端口
./lightedium --cli --port 8080

配置环境变量

export PORT=10240
export DATA_DIR=/path/to/data
export PHOTOS_DIR=/path/to/photos
./lightedium --cli

14.4 Web 管理界面

通过浏览器访问后，可以看到与桌面版类似的界面：

侧边栏导航
照片网格浏览
搜索功能
相册管理
设置页面

与桌面版的区别

功能	桌面版	Web 版
本地文件浏览	✓	✓
AI 功能	✓ 全部	✓ 取决于硬件
文件系统监听	✓	-
原生菜单	✓	Web 菜单
拼图工具	✓	部分支持
分享页面	✓	✓

14.5 维护操作

重启服务

docker-compose restart

更新镜像

docker-compose pull
docker-compose up -d

备份数据

备份数据目录（包含数据库和配置）：

tar -czf backup.tar.gz ./data

下一步：阅读第十五章了解维护与故障排除。