快速开始

PicFast 提供生产可用的 Docker Compose 文件，无需克隆仓库。下载文件、编辑几个变量，即可上线。

1. 下载 Compose 文件

mkdir picfast && cd picfast

# 下载 Compose 文件和环境变量模板
wget https://raw.githubusercontent.com/atbeta/picfast/main/docker/docker-compose.yml
wget https://raw.githubusercontent.com/atbeta/picfast/main/docker/.env.example -O .env

2. 编辑配置

编辑 .env，至少需要设置以下内容：

# 域名与访问地址
PICFAST_DOMAIN=picfast.example.com
PICFAST_SERVER_BASE_URL=https://picfast.example.com

# 安全
PICFAST_JWT_SECRET=your-strong-random-secret
POSTGRES_PASSWORD=your-db-password

# 可选：跳过初始化向导（无头部署）
PICFAST_APP_ADMIN_EMAIL=admin@example.com
PICFAST_APP_ADMIN_PASSWORD=your-admin-password

3. 启动

docker compose up -d

同时启动 PostgreSQL 和 PicFast。打开 http://localhost:18080，跟随引导向导创建管理员账号。

数据存储在当前目录下：./data/postgres、./data/uploads、./data/thumbnails。

4. 上传第一张图片

登录 Web UI 拖拽文件上传，或通过 API：

curl -X POST http://localhost:18080/api/v1/images \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "file=@image.png"

反向代理

默认 Compose 将 PicFast 绑定到 127.0.0.1:18080。建议在前置 Nginx、Caddy 或 NPM 等反代后提供 HTTPS。如需直接暴露，在 .env 中设置 PICFAST_HTTP_BIND=0.0.0.0。

完整的反向代理配置（Nginx、Caddy、Traefik）见 部署 页面。

下一步

开发环境

如需从源码构建或参与开发：

  • 环境要求：Go 1.26+、Node 20+、pnpm、Docker
  • 启动服务：make docker-up（或 docker compose -f docker/docker-compose.dev.yml up --build -d）
  • 运行后端：go run ./cmd/picfast（需先执行 cp .env.example .env）
  • 运行前端：cd web && pnpm install && pnpm dev

数据库迁移在启动时自动执行。完整说明见 README。