存储后端

PicFast 支持 6 种存储后端，均在管理后台的存储策略中配置。可创建多个策略并分配给不同用户分组。

本地

将文件存储于本地文件系统。最简单的方式，适合单机部署与开发环境。

{
  "type": "local",
  "root": "/data/uploads",
  "url": "https://picfast.example.com/uploads"
}

S3 兼容

支持 AWS S3、MinIO、Cloudflare R2 及其他 S3 兼容服务。

{
  "type": "s3",
  "endpoint": "https://s3.us-east-1.amazonaws.com",
  "region": "us-east-1",
  "bucket": "my-picfast",
  "access_key": "your-access-key",
  "secret_key": "your-secret-key",
  "bucket": "my-picfast",
  "url": "https://my-picfast.s3.us-east-1.amazonaws.com"
}

阿里云 OSS

{
  "type": "oss",
  "endpoint": "oss-cn-hangzhou.aliyuncs.com",
  "bucket": "my-picfast",
  "access_key": "your-access-key",
  "secret_key": "your-secret-key",
  "url": "https://my-picfast.oss-cn-hangzhou.aliyuncs.com"
}

腾讯云 COS

{
  "type": "cos",
  "bucket_url": "https://my-picfast.cos.ap-guangzhou.myqcloud.com",
  "secret_id": "your-secret-id",
  "secret_key": "your-secret-key",
  "url": "https://my-picfast.cos.ap-guangzhou.myqcloud.com"
}

七牛云 Kodo

{
  "type": "kodo",
  "access_key": "your-access-key",
  "secret_key": "your-secret-key",
  "bucket": "my-picfast",
  "domain": "https://picfast.example.com",
  "zone": "z0"
}

WebDAV

连接任意 WebDAV 兼容存储（Nextcloud、ownCloud 等）。

{
  "type": "webdav",
  "endpoint": "https://dav.example.com",
  "username": "user",
  "password": "password",
  "url": "https://dav.example.com/pics"
}

链接模式

默认情况下，云存储后端（S3、OSS、COS、Kodo）返回 CDN 直链。本地和 WebDAV 后端始终通过 PicFast 的代理路由（/i/{key}.{ext}）提供服务。

可通过 link_mode 字段更改此行为：

{
  "type": "s3",
  "endpoint": "https://s3.us-east-1.amazonaws.com",
  "bucket": "my-picfast",
  "access_key": "...",
  "secret_key": "...",
  "url": "https://cdn.example.com",
  "link_mode": "proxy"
}

代理模式适用于需要统一权限控制（私有图片）或对云存储图片使用 PicFast 实时图片处理的场景。切换模式即时生效，无需重新上传或迁移。

切换后端

已存储的图片不受后端切换影响。更改分组的默认存储策略后，新上传的文件将写入新后端，已有文件仍从原有位置提供服务，无需数据迁移。