开源 · 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。切换后端无需迁移已有数据。

图片处理与安全

自动生成缩略图,支持可配置的图片压缩与水印。支持管理员手动审核,同时预置自动审核接口,后续可接入第三方审核服务。

与同类方案对比

CheveretoLsky ProPicsurPicFast
部署时间约 30 分钟约 30 分钟约 10 分钟约 5 分钟
管理面板基础完整基础完整 React 后台
API 支持基础APIPostmanOpenAPI + 在线文档
ShareX 集成✅ 内置
AI / MCP 工具✅ 5 工具 + 资源
存储后端有限9 种后端仅本地6 种后端
内容审核✅ 内置
图片处理基础✅ 水印✅ 编辑/转换✅ 压缩 + 水印
协议付费GPL v3AGPL v3GPL 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 .env
2

编辑配置

编辑 .env — 设置域名、数据库密码和 JWT 密钥。无头部署可添加管理员凭据跳过向导。

3

启动服务

一行命令同时启动 PostgreSQL 和 PicFast。打开 http://localhost:18080 完成初始化向导。

docker compose up -d

浏览完整文档 →