PicGo Enhanced Amazon S3 上传插件。
- 支持 Amazon S3 与其他如 backblaze b2 等兼容 S3 API 的云存储
- 支持 PicGO GUI
- 支持 MinIO
- 新增：自动添加元数据（MD5、时间戳、CRC64、标记）
- 新增：UUID 占位符支持，避免文件名冲突
- 新增：多域名随机选择功能
- 新增：Content-Disposition 设置，确保下载时文件名正确
GUI 直接搜索 revanced-s3 下载即可，Core 版执行 picgo add revanced-s3 安装。
picgo set uploader aws-s3
| Key | 说明 | 例子 |
|---|---|---|
accessKeyID | AWS 凭证 ID | |
secretAccessKey | AWS 凭证密钥 | |
bucketName | S3 桶名称 | gallery |
uploadPath | 上传路径，详细配置查看以下说明 | {year}/{month}/{uuid}.{extName} |
endpoint | 指定自定义终端节点 | s3.us-west-2.amazonaws.com |
proxy | 代理地址 | 支持 http 代理，例如 http://127.0.0.1:1080 |
region | 指定执行服务请求的区域 | us-west-1 |
pathStyleAccess | 是否启用 S3 Path style | 默认为 false，使用 minio 请设置为 true (e.g., https://s3.amazonaws.com// instead of https://.s3.amazonaws.com/) |
rejectUnauthorized | 是否拒绝无效 TLS 证书连接 | 默认为 true，如上传失败日志显示证书问题可设置为false |
acl | 访问控制列表，上传资源的访问策略 | 默认为 public-read, AWS 可选 `private" |
outputURLPattern | 自定义输出 URL 模板，详细配置查看以下说明 | {protocol}://{host}:{port}/{path} |
urlPrefix | 最终生成图片 URL 的自定义前缀（支持多域名，逗号分隔） | https://img1.example.com, https://img2.example.com |
urlSuffix | 最终生成图片 URL 的自定义后缀（已废弃，请使用 outputURLPattern） | ?oxx=xxx |
disableBucketPrefixToURL | 开启 pathStyleAccess 时，是否要禁用最终生成 URL 中添加 bucket 前缀 （已废弃，请使用 outputURLPattern） | 默认为 false |
上传路径 和 自定义输出 URL 模板 支持的通用占位符，插件将会自行用变量替换到实际使用的路径中。
| payload | 描述 |
|---|---|
{year} | 当前日期 - 年 |
{month} | 当前日期 - 月 |
{day} | 当前日期 - 日 |
{hour} | 当前日期 - 时 |
{minute} | 当前日期 - 分 |
{second} | 当前日期 - 秒 |
{millisecond} | 当前日期 - 毫秒 |
{timestamp} | Unix 时间戳 |
{timestampMS} | Unix 时间戳（毫秒） |
支持占位符方式配置，如 {year}/{month}/{uuid}.{extName}。除以下列表外，还指出上述通用占位符。
| payload | 描述 |
|---|---|
{fullName} | 完整文件名（含扩展名） |
{fileName} | 文件名（不含扩展名） |
{extName} | 扩展名（不含.） |
{md5} | 图片 MD5 计算值 |
{sha1} | 图片 SHA1 计算值 |
{sha256} | 图片 SHA256 计算值 |
{uuid} | 唯一标识符（UUID v4） |
支持占位符方式配置，如 {protocol}://{host}:{port}/{path}。除以下列表外，还指出上述通用占位符。
| payload | 描述 | 例子 |
|---|---|---|
{protocol} | 原上传 URL 的协议 | http 或 https |
{host} | 原上传 URL 的域名，可不不使用次此变量改为其他自己的反代的域名 | example.com |
{port} | 原上传 URL 的端口 | 80 |
{dir} | 原上传 URL 的目录 | testBucket/2024/12 |
{path} | 原上传 URL 的完整路径 | testBucket/2024/12/4aa4f41e38817e5fd38ac870f40dbc70.jpg |
{fileName} | 文件名（含扩展名） | test.jpg |
{extName} | 扩展名（不含.） | jpg |
{query} | 上传 URL 的 querystirng 部分（不含 ? ） | height=100&width=200 |
{hash} | 上传 URL 的 hash 部分（不含 # ） | abc |
{bucket} | 上传桶名 | testBucket |
这个配置将会替代原有的 urlPrefix 、urlSuffix、disableBucketPrefixToURL 的配置。
另外每个变量都支持正则替换
语法： {payload:/pattern/reFlag,'replacement'}
比如配置为 {protocol}://example.imgbed/{path:/testBucket/i,'myimage'}，如果原URL为 https://cluster-test-1.s3.us-east-001.example.com/testBucket/image.jpg 则会生成 https://example.imgbed/myimage/image.jpg。
上传时自动为每个文件添加以下元数据：
x-amz-meta-md5: 文件的 MD5 哈希值x-amz-meta-timestamp: Unix 时间戳x-amz-meta-crc64ecma: CRC64-ECMA 校验值x-amz-meta-set: 标记为已设置元数据
- 新增
{uuid}占位符，每次上传生成唯一标识符 - 避免文件名冲突，特别适合批量上传场景
- 示例：
{year}/{month}/{uuid}.{extName}
urlPrefix支持多个域名，用英文逗号分隔- 上传后随机选择其中一个域名作为图片链接前缀
- 示例：
https://img1.example.com, https://img2.example.com
- 自动设置
inline; filename="原始文件名" - 确保下载时文件名正确，提升用户体验
"aws-s3": {
"accessKeyID": "xxx",
"secretAccessKey": "xxxxx",
"bucketName": "my-bucket",
"uploadPath": "{year}/{uuid}.{extName}",
"endpoint": "s3.us-west-000.backblazeb2.com",
"outputURLPattern": "{protocol}://{host}/{path}",
"urlPrefix": "https://img1.example.com, https://img2.example.com"
}
如果 PicGo 像以上配置，执行上传：picgo upload sample.png，则最终得到图片地址为：https://img1.example.com/2021/123e4567-e89b-12d3-a456-426614174000.png
With the following command, a versioned commit which modifies the version of package.json would be genereated and pushed to the origin. Github Action will automatically compile this pacakage and publish it to NPM.
npm run patch npm run minor npm run major
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Released under the MIT License.
