约 5 分钟
如何上传文件到 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 中添加上传目标
在设置 → 上传目标 → 添加上传目标 中选择 MinIO，填写下表中的值。由于 MinIO 使用路径式 URL，公开基础 URL 需要包含存储桶名称。
- 5
测试并保存
点击 测试连接，然后点击 存储。
Aktar 中的设置
在“设置 → 上传目标 → 添加上传目标”中填写以下值。字段名称与应用内保持一致。
| 字段 | 示例值 |
|---|---|
| 服务商 | MinIO |
| 端点 | https://minio.example.com你的 MinIO API 地址（通常为 9000 端口）。 |
| 区域 | us-east-1服务器上配置的区域；如果从未设置过，则为 us-east-1。 |
| 访问密钥 ID | aktar |
| 私有访问密钥 | •••••••• |
| 存储桶 | screenshots |
| 公开基础 URL | https://minio.example.com/screenshots包含存储桶名称。 |
小技巧
- 将 MinIO 放在启用 HTTPS 的反向代理后面，让链接在所有浏览器和聊天应用中都能正常打开。
- 上传只需要你的 Mac 能访问服务器（VPN 或局域网均可），但分享出去的链接需要公开 URL 对打开它的人可访问。
故障排查
“测试连接”报告区域或签名错误
将“区域”字段设为 MinIO 服务器上配置的区域。如果从未配置过，请使用 us-east-1。
链接返回 403
存储桶没有匿名读取策略，或公开基础 URL 缺少存储桶名称。参见 Access Denied 错误。
仍然遇到问题？浏览常见问题，或在 GitHub 上提问。