开源 · GNU GPL v3
一行命令,部署完整的
自托管图床。
一条 docker run 即可启动,数分钟内完成部署。原生支持 ShareX、MCP(AI Agent)及任意 HTTP 客户端。
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 功能完备,部署极简
一键 Docker 部署
拉取预构建镜像,一条 docker run 命令即可完成部署,无需从源码构建。同时提供完整的 Docker Compose 模板,几行配置即可部署生产级实例。
完整管理面板
基于 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 |
| 维护状态 | 维护中 | 已停更 | 已停更 | 活跃开发 |
快速开始
1
下载编排文件
获取 Compose 文件和环境变量模板,无需克隆整个仓库。
mkdir picfast && cd picfast
wget https://raw.githubusercontent.com/atbeta/picfast/main/docker/docker-compose.yml
wget https://raw.githubusercontent.com/atbeta/picfast/main/docker/.env.example -O .env2
编辑配置
编辑 .env — 设置域名、数据库密码和 JWT 密钥。无头部署可添加管理员凭据跳过向导。
3
启动服务
一行命令同时启动 PostgreSQL 和 PicFast。打开 http://localhost:18080 完成初始化向导。
docker compose up -d