S3 对象存储同步配置与自建 MinIO 场景
S3 是七种同步目标里最"工程师"的一个:直接对接对象存储,天然适合自建与大容量场景。
适合什么人
- 已有 S3 或兼容存储(如自建 MinIO、各类云厂商对象存储)的用户;
- 需要按量付费、几乎无限容量的重度附件用户;
- 企业内部要求数据落到指定存储的合规场景。
配置项
配置界面 > 同步,同步目标选 S3,按界面提示填:
| 配置项 | 说明 |
|---|---|
| 访问密钥(Access Key / Secret Key) | 存储服务颁发的凭据 |
| 存储桶(Bucket) | 提前建好一个专用桶 |
| 区域(Region) | 服务商给的区域标识 |
| 服务地址(Endpoint) | 自建或第三方兼容存储必填 |
| 路径风格 | 兼容存储常需选"路径式"而非"虚拟主机式" |
各项的确切名称与字段随版本略有调整,以应用内界面与官方文档为准。
配置要点
- 先建桶:桶不存在同步必失败;
- 最小权限:给 Joplin 的密钥只授权对该桶的读写删除列出,别用全局管理密钥;
- 测试连接:配置完先跑一次连通性测试再执行首次同步;
- 中文社区有大量"Joplin + 对象存储"的实操文章,配置思路一致可参考。
与 E2EE 搭配
对象存储的桶策略、服务端加密保护的是"存储层",而端到端加密保护的是"内容本身"。两者叠加才是完整的自托管安全方案,见开启 E2EE 的正确步骤。
成本直觉
对象存储按存储量加请求次数计费,纯文字笔记月成本几乎可以忽略;但如果塞了几十 GB 附件且多设备频繁同步,流量费会逐渐可见——这也是为什么官方把"附件下载行为"做成可调项(见附件管理)。
各家兼容存储的字段名称可能不同,以你的服务商文档与官方最新版为准。