约 5 分钟
如何上传文件到任意 S3 兼容存储
Aktar 支持任何实现了 Amazon S3 API 的服务商。选择 其他兼容 S3 的服务，填写服务商的端点、区域和密钥即可。常见示例：
- 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 中添加上传目标
在设置 → 上传目标 → 添加上传目标 中选择 其他兼容 S3 的服务，填写下表中的值。该预设使用虚拟主机式 URL（
bucket.endpoint）。如果你的服务器只支持路径式 URL，请改用 MinIO 预设。 - 5
测试并保存
点击 测试连接，然后点击 存储。
Aktar 中的设置
在“设置 → 上传目标 → 添加上传目标”中填写以下值。字段名称与应用内保持一致。
| 字段 | 示例值 |
|---|---|
| 服务商 | 其他兼容 S3 的服务 |
| 端点 | https://fsn1.your-objectstorage.com服务商的 S3 端点。 |
| 区域 | fsn1存储桶的区域或位置。 |
| 访问密钥 ID | … |
| 私有访问密钥 | •••••••• |
| 存储桶 | your-bucket |
| 公开基础 URL | your-bucket.fsn1.your-objectstorage.com或存储桶前面的 CDN 或自定义域名。 |
小技巧
- 请查阅服务商文档，确认你所选区域的准确端点。
- 如果服务商提供 CDN 或自定义域名，请将该地址用作公开基础 URL。
故障排查
“测试连接”无法访问存储桶
仔细检查端点和区域。如果服务商只支持路径式 URL，请将预设切换为 MinIO。
链接返回 403
存储桶尚未允许公开读取。参见 Access Denied 错误。
仍然遇到问题？浏览常见问题，或在 GitHub 上提问。