约 5 分钟
如何在 Aktar 中使用 Wasabi、Hetzner、Scaleway 及其他 S3 兼容存储
Aktar 支持任何实现了 Amazon S3 API 的服务商。选择 Other S3-Compatible,填写服务商的端点、区域和密钥即可。常见示例:
- Wasabi:
https://s3.<region>.wasabisys.com,例如s3.eu-central-1.wasabisys.com - Hetzner Object Storage:
https://<location>.your-objectstorage.com,例如fsn1.your-objectstorage.com - Scaleway:
https://s3.<region>.scw.cloud,例如s3.fr-par.scw.cloud - Akamai (Linode):
https://<region>.linodeobjects.com
准备工作
- 一个 S3 兼容服务商的账号
- 已在 Mac 上安装 Aktar
操作步骤
- 1
创建存储桶
在服务商的控制台中创建一个存储桶,并记下它的区域或位置,例如
eu-central-1、fsn1或fr-par。 - 2
允许公开读取
让存储桶中的对象可公开读取,可以使用服务商的存储桶可见性设置,或添加允许
s3:GetObject的存储桶策略。Aktar 不会为单个文件设置权限,因此必须在存储桶上完成配置。 - 3
创建访问密钥
创建一组对该存储桶具有读写权限的 S3 访问密钥(Access Key 和 Secret)。
- 4
在 Aktar 中添加上传目标
在 Settings → Destinations → Add Destination 中选择 Other S3-Compatible,填写下表中的值。该预设使用虚拟主机式 URL(
bucket.endpoint)。如果你的服务器只支持路径式 URL,请改用 MinIO 预设。 - 5
测试并保存
点击 Test Connection,然后点击 Save。
Aktar 中的设置
在 Settings → Destinations → Add Destination 中填写以下值。字段名称与应用内保持一致。
| 字段 | 示例值 |
|---|---|
| Provider | Other S3-Compatible |
| Endpoint | https://fsn1.your-objectstorage.com服务商的 S3 端点。 |
| Region | fsn1存储桶的区域或位置。 |
| Access Key ID | … |
| Secret Access Key | •••••••• |
| Bucket | your-bucket |
| Public Base URL | your-bucket.fsn1.your-objectstorage.com或存储桶前面的 CDN 或自定义域名。 |
小技巧
- 请查阅服务商文档,确认你所选区域的准确端点。
- 如果服务商提供 CDN 或自定义域名,请将该地址用作 Public Base URL。
故障排查
Test Connection 无法访问存储桶
仔细检查端点和区域。如果服务商只支持路径式 URL,请将预设切换为 MinIO。
链接返回 403
存储桶尚未允许公开读取。参见 Access Denied 错误。
仍然遇到问题?浏览常见问题,或在 GitHub 上提问。