picgo-plugin-s3 是一个支持上传到 Amazon S3 兼容 API 的PicGo 插件，支持自定义上传路径、生成 URL 前缀等配置。
- Amazon S3
- BackBlaze B2
- minio
安装
首先确保已安装 PicGo-Core 或 PicGo
Core(CLI)：picgo add s3
GUI：直接搜索 s3 下载安装即可
配置
设置为默认 Uploader：
GUI 版直接在程序界面配置即可，CLI 版则执行以下命令进入交互配置
picgo set uploader aws-s3
或者手工修改配置文件。
| Key | 说明 | 例子 |
|---|---|---|
accessKeyID | AWS 凭证 ID | |
secretAccessKey | AWS 凭证密钥 | |
bucketName | S3 桶名称 | gallery |
uploadPath | 上传路径 | {year}/{month}/{fullName} |
urlPrefix | 最终生成图片 URL 的自定义前缀 | https://img.example.com/my-blog/ |
endpoint | 指定自定义终端节点 | s3.us-west-2.amazonaws.com |
region | 指定执行服务请求的区域 | us-west-1 |
上传路径支持 payload：
| payload | 描述 |
|---|---|
{year} | 当前日期 - 年 |
{month} | 当前日期 - 月 |
{day} | 当前日期 - 日 |
{fullName} | 完整文件名（含扩展名） |
{fileName} | 文件名（不含扩展名） |
{extName} | 扩展名（不含.） |
{md5} | 图片 MD5 计算值 |
{sha1} | 图片 SHA1 计算值 |
{sha256} | 图片 SHA256 计算值 |
使用
示例：通过 Typroa 使用
PicGo-Core 配置完成后，在 Typroa - 「偏好设置」修改上传服务为 PicGo-Core 即可。
https://support.typora.io/Upload-Image/#option-2-config-via-cli
示例：迁移图床
配合 pic-migrater 插件使用，配置好 S3 插件和 Pic-Migrater 插件后，则可一键迁移图片到新的 S3 图床：
picgo migrate ~/blog/posts