快速开始

PicFast 运行在单个 Docker 容器中。你只需要一个 PostgreSQL 实例和 Docker Hub 上的预构建镜像即可开始。

环境要求

  • Docker
  • 一个可用的 PostgreSQL 实例（本地、远程或 Docker 均可）
  • 一个域名（生产环境）或直接使用 localhost 测试

1. 启动服务栈

三条命令：创建 Docker 网络，启动 PostgreSQL，启动 PicFast。

docker network create picfast-net

docker run -d --name picfast-db --network picfast-net \
  -e POSTGRES_PASSWORD=devonly \
  -v picfast-pgdata:/var/lib/postgresql/data \
  postgres:16-alpine

docker run -d --name picfast --network picfast-net -p 18080:8080 \
  -e PICFAST_DATABASE_URL='postgres://postgres:devonly@picfast-db:5432/postgres?sslmode=disable' \
  -e PICFAST_JWT_SECRET='change-me-in-production' \
  -e PICFAST_SERVER_BASE_URL='http://localhost:18080' \
  -v picfast-uploads:/app/data/uploads \
  -v picfast-thumbnails:/app/data/thumbnails \
  xbeta/picfast:latest

可用镜像标签：latest、版本标签（vX.Y.Z）、按提交追踪标签（sha-<commit>）。完整列表见 Docker Hub。

2. 初始化设置

在浏览器打开 http://localhost:18080，引导式初始化向导将协助你创建第一个管理员账号。

对于无头（非浏览器）部署，设置以下环境变量可在启动时自动创建管理员并跳过向导：

PICFAST_APP_ADMIN_EMAIL=admin@example.com
PICFAST_APP_ADMIN_PASSWORD=your-admin-password

3. 上传第一张图片

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

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

AI Agent 集成请参阅 MCP 集成。ShareX 一键配置请参阅 ShareX 集成。

下一步

开发环境部署

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

  • 环境要求：Go 1.26+、Node 20+、pnpm、PostgreSQL 16、Git
  • 启动服务：make docker-up（启动 PostgreSQL + Mailpit）
  • 运行后端：go run ./cmd/picfast
  • 运行前端：cd web && pnpm install && pnpm dev

数据库迁移在启动时自动执行。打包运行：cd web && pnpm build && go run ./cmd/picfast。

完整开发说明请参阅 GitHub README。