约 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. 1

    创建存储桶

    在服务商的控制台中创建一个存储桶,并记下它的区域或位置,例如 eu-central-1、fsn1 或 fr-par。

  2. 2

    允许公开读取

    让存储桶中的对象可公开读取,可以使用服务商的存储桶可见性设置,或添加允许 s3:GetObject 的存储桶策略。Aktar 不会为单个文件设置权限,因此必须在存储桶上完成配置。

  3. 3

    创建访问密钥

    创建一组对该存储桶具有读写权限的 S3 访问密钥(Access Key 和 Secret)。

  4. 4

    在 Aktar 中添加上传目标

    在 Settings → Destinations → Add Destination 中选择 Other S3-Compatible,填写下表中的值。该预设使用虚拟主机式 URL(bucket.endpoint)。如果你的服务器只支持路径式 URL,请改用 MinIO 预设。

  5. 5

    测试并保存

    点击 Test Connection,然后点击 Save。

Aktar 中的设置

在 Settings → Destinations → Add Destination 中填写以下值。字段名称与应用内保持一致。

字段示例值
ProviderOther S3-Compatible
Endpointhttps://fsn1.your-objectstorage.com服务商的 S3 端点。
Regionfsn1存储桶的区域或位置。
Access Key ID…
Secret Access Key••••••••
Bucketyour-bucket
Public Base URLyour-bucket.fsn1.your-objectstorage.com或存储桶前面的 CDN 或自定义域名。

小技巧

  • 请查阅服务商文档,确认你所选区域的准确端点。
  • 如果服务商提供 CDN 或自定义域名,请将该地址用作 Public Base URL。

故障排查

Test Connection 无法访问存储桶

仔细检查端点和区域。如果服务商只支持路径式 URL,请将预设切换为 MinIO。

链接返回 403

存储桶尚未允许公开读取。参见 Access Denied 错误。

仍然遇到问题?浏览常见问题,或在 GitHub 上提问。