存储后端

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

本地

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

{
  "type": "local",
  "root": "/data/uploads",
  "url": "https://pics.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": "AKIAIOSFODNN7EXAMPLE",
  "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "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://pics.example.com",
  "zone": "zone0"
}

WebDAV

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

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

切换后端

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