joplin 中文文档 下载 App

S3 对象存储同步配置与自建 MinIO 场景

S3 是七种同步目标里最"工程师"的一个:直接对接对象存储,天然适合自建与大容量场景。

适合什么人

配置项

配置界面 > 同步,同步目标选 S3,按界面提示填:

配置项说明
访问密钥(Access Key / Secret Key)存储服务颁发的凭据
存储桶(Bucket)提前建好一个专用桶
区域(Region)服务商给的区域标识
服务地址(Endpoint)自建或第三方兼容存储必填
路径风格兼容存储常需选"路径式"而非"虚拟主机式"

各项的确切名称与字段随版本略有调整,以应用内界面与官方文档为准。

配置要点

与 E2EE 搭配

对象存储的桶策略、服务端加密保护的是"存储层",而端到端加密保护的是"内容本身"。两者叠加才是完整的自托管安全方案,见开启 E2EE 的正确步骤。

成本直觉

对象存储按存储量加请求次数计费,纯文字笔记月成本几乎可以忽略;但如果塞了几十 GB 附件且多设备频繁同步,流量费会逐渐可见——这也是为什么官方把"附件下载行为"做成可调项(见附件管理)。

各家兼容存储的字段名称可能不同,以你的服务商文档与官方最新版为准。