开源 · GNU GPL v3

一行命令，部署完整的
自托管图床平台。

拉取预构建镜像，一条 docker run 即可完成部署 —— PostgreSQL 加 PicFast，数秒启动。首次访问提供引导式初始化向导。内置 React 管理面板、6 种存储后端、API 优先架构。原生支持 MCP 协议供 AI 工作流集成，同时提供 ShareX 等客户端工具接入。

terminal

$ 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

快速开始 GitHub

功能完备，部署极简

一键 Docker 部署

拉取预构建镜像，一条 docker run 命令即可完成部署，无需从源码构建。同时提供完整的 Docker Compose 模板，支持 Traefik 和 Let's Encrypt 自动证书。

完整管理面板

基于 React 构建的管理后台，可集中管理用户、分组、存储策略、图片资源及站点配置。日常运维无需直接操作数据库。

API 优先，AI 就绪

完整的 REST API 与 OpenAPI 规范文档，支持在线调试。内置 MCP 服务器，Claude、Cursor 等 AI 助手可通过标准协议完成图片上传、查询与管理。执行 npx @picfast/mcp 即可接入。

原生工具集成

内置 ShareX、PicGo、PicList、uPic、Dropshare 等工具的一键配置支持。多格式链接输出（URL、Markdown、BBCode、HTML）。兼容任意 HTTP 客户端，无供应商锁定风险。

6 种存储后端

支持本地文件系统、S3 兼容协议（MinIO、R2）、阿里云 OSS、腾讯云 COS、七牛云 Kodo 及 WebDAV。切换后端无需迁移已有数据。

图片处理与安全

自动生成缩略图，支持可配置的图片压缩与水印。可选内容审核功能，通过管理员审批队列保障公开内容的合规性。

与同类方案对比

	Chevereto	Lsky Pro	Picsur	PicFast
部署时间	约 30 分钟	约 30 分钟	约 10 分钟	约 5 分钟
管理面板	基础	完整	基础	完整 React 后台
API 支持	基础	API	Postman	OpenAPI + 在线文档
ShareX 集成	✅	❌	✅	✅ 内置
AI / MCP 工具	❌	❌	❌	✅ 5 工具 + 资源
存储后端	有限	9 种后端	仅本地	6 种后端
内容审核	❌	✅	❌	✅ 内置
图片处理	基础	✅ 水印	✅ 编辑/转换	✅ 压缩 + 水印
协议	付费	GPL v3	AGPL v3	GPL v3
维护状态	维护中	已停更	已停更	活跃开发

快速开始

启动服务栈

创建 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

完成初始化

打开 http://localhost:18080，引导式向导将创建首个管理员账号。无头部署可设置 PICFAST_APP_ADMIN_EMAIL 和 PICFAST_APP_ADMIN_PASSWORD 跳过向导。

开始上传

通过 Web UI、ShareX、curl 或任意 HTTP 客户端上传，每次上传返回即用链接。

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

浏览完整文档 →

一行命令，部署完整的自托管图床平台。