约 5 分钟
如何在 Aktar 中使用 MinIO
MinIO 让你在自己的服务器上运行 S3 兼容存储。Aktar 的 MinIO 预设使用路径式寻址（https://server/bucket/file），这也是大多数自建环境所采用的方式。
准备工作
- 一台可从你的 Mac 访问的 MinIO 服务器，最好启用 HTTPS
- MinIO Client（mc）或 MinIO Console 的访问权限
- 已在 Mac 上安装 Aktar
操作步骤
- 1
创建存储桶
使用已为服务器配置别名的 MinIO Client：
mc mb myminio/screenshots - 2
允许匿名下载
为存储桶设置公开读取策略，让分享出去的链接任何人都能打开：
mc anonymous set download myminio/screenshots - 3
创建访问密钥
在 MinIO Console 中创建一个访问密钥（或一个对该存储桶具有读写权限的专用用户），复制 Access Key 和 Secret Key。
- 4
在 Aktar 中添加上传目标
在 Settings → Destinations → Add Destination 中选择 MinIO，填写下表中的值。由于 MinIO 使用路径式 URL，Public Base URL 需要包含存储桶名称。
- 5
测试并保存
点击 Test Connection，然后点击 Save。
Aktar 中的设置
在 Settings → Destinations → Add Destination 中填写以下值。字段名称与应用内保持一致。
| 字段 | 示例值 |
|---|---|
| Provider | MinIO |
| Endpoint | https://minio.example.com你的 MinIO API 地址（通常为 9000 端口）。 |
| Region | us-east-1服务器上配置的区域；如果从未设置过，则为 us-east-1。 |
| Access Key ID | aktar |
| Secret Access Key | •••••••• |
| Bucket | screenshots |
| Public Base URL | https://minio.example.com/screenshots包含存储桶名称。 |
小技巧
- 将 MinIO 放在启用 HTTPS 的反向代理后面，让链接在所有浏览器和聊天应用中都能正常打开。
- 上传只需要你的 Mac 能访问服务器（VPN 或局域网均可），但分享出去的链接需要公开 URL 对打开它的人可访问。
故障排查
Test Connection 报告区域或签名错误
将 Region 设为 MinIO 服务器上配置的区域。如果从未配置过，请使用 us-east-1。
链接返回 403
存储桶没有匿名读取策略，或 Public Base URL 缺少存储桶名称。参见 Access Denied 错误。
仍然遇到问题？浏览常见问题，或在 GitHub 上提问。