drklee3/picatch

picatch

概述

picatch是一个基于目录结构的无数据库极简照片画廊，使用Actix web框架构建，支持自托管。目前处于早期开发阶段，可能会有重大功能变更和UI/UX调整。

核心功能

• 无数据库依赖，直接通过目录结构管理照片
• 支持Docker或二进制文件自托管部署
• 可自定义站点名称和导航栏链接
• 自动处理照片尺寸调整（生成缩略图）
• 轻量级设计，资源占用低

使用场景

• 个人照片库的管理与展示
• 家庭照片共享（本地或私有服务器）
• 小型团队内部图片资源库
• 个人博客/网站的图片展示模块

部署与配置

通过Docker部署

Docker Run命令

bash
docker run \
    -p 8080:8080 \
    -v /本地照片路径:/photos \
    drklee3/picatch

Docker Compose配置

yaml
version: "3"
services:
  picatch:
    image: drklee3/picatch
    ports:
      - "8080:8080"
    volumes:
      - /本地照片路径:/photos

配置说明

支持TOML配置文件或环境变量设置，环境变量优先级高于配置文件。

配置文件示例（picatch.toml）

toml
original_photos_dir = "./photos"  # 原始照片目录
resized_photos_dir = "./photos_resized"  # 调整尺寸后的照片目录
interface = "0.0.0.0"  # 服务器监听地址
port = 8080  # 服务器端口

[public]
site_name = "picatch"  # 站点名称

[[public.links]]
text = "Picatch项目"
url = "https://github.com/drklee3/picatch"

[[public.links]]
text = "GitHub"
url = "https://github.com/drklee3/"

环境变量示例

bash
env PICATCH_PUBLIC.SITE_NAME="我的照片库" \
    PICATCH_PUBLIC.LINKS[0].TEXT="我的博客" \
    PICATCH_PUBLIC.LINKS[0].URL="https://example.com" \
    picatch

源码编译

依赖要求

• 后端：Rust 1.40.0+
• 前端：Node.js、Yarn

构建步骤

1. 前端构建：

bash
cd web && yarn && yarn build

2. 后端构建：

bash
cargo build --release

3. 运行：

bash
./target/release/picatch

许可证

MIT许可证 ===FULL_DESC===