S3 云端用于连接 Amazon S3 及其他提供 S3 兼容接口的对象存储服务。添加并启用账户后，可以在奕澄Markdown中按目录浏览 Bucket 内的对象，新建、导入、下载和编辑文件，并将云端 Markdown 的修改回传到对应位置。

现有《使用须知》记录了 MinIO、七牛云、阿里云和腾讯云的测试经历，但不同服务商、区域和配置仍可能存在兼容性差异。建议先使用专用测试 Bucket 或子目录验证主要操作，再迁移重要文档。

准备连接信息

开始前，请在对象存储服务商处准备：

• 已创建的 Bucket，以及具有相应权限的访问密钥。
• S3 兼容接口的 Endpoint 和 Region ID。
• 允许应用列出、读取、上传、复制和删除对象的权限。
• 如需限制应用只能访问部分数据，可准备 Bucket 内的专用根路径。

建议创建权限受限的专用密钥，不要直接使用云账户的主密钥，也不要在截图或文档中泄露 Secret Key。

添加 S3 账户

1. 打开 设置 > 云端设置 > 账户管理。
2. 在页面顶部将协议切换为 S3。
3. 点击右上角新建按钮，选择 新建账户。
4. 按下表填写信息。
5. 打开 是否启用，点击顶部确认按钮保存。

配置项	填写说明
账户昵称	自定义名称，同时用作本地镜像目录名称。建议使用简短、唯一的名称，不要包含 / 等路径分隔符
Endpoint	S3 接口入口，通常包含 http:// 或 https://，按服务商文档填写，不要混入 Bucket 名称或对象路径
Access Key	访问密钥的 AccessKey ID
Secret Key	与 Access Key 配对的 SecretKey Secret
Bucket	已创建的存储桶名称，须与控制台中的名称一致
Region ID	存储桶或 S3 接口所在区域的标识，按服务商要求填写
直链域名/CDN	可选项，用于公开访问或云端图床，不影响普通云端文件浏览与同步
根目录	Bucket 内的路径前缀，默认为 /；建议使用专用子目录，例如 /yicheng/
是否启用	打开后，该账户才会出现在云端浏览器的可用账户中
Addressing Style	当前界面显示 Path-style，选择器不可编辑
TLS Verify	当前界面显示 Skip，选择器不可编辑

根目录会自动规范为带首尾 / 的形式。例如输入 yicheng/notes，会按 /yicheng/notes/ 处理。这里填写的是 Bucket 内的前缀，不是完整 URL，也不需要重复填写 Bucket 名称。

当前版本的 Addressing Style 与 TLS Verify 不可在界面中切换。公网连接仍应优先使用具有有效证书的 HTTPS Endpoint，不要把不安全的连接方式用于不可信网络。

配置示例

以下仅演示字段格式，不代表你的服务商一定使用这些值：

账户昵称：我的S3
Endpoint：https://s3.example.com
Access Key：你的AccessKey ID
Secret Key：你的SecretKey Secret
Bucket：my-documents
Region ID：按服务商实际区域填写
根目录：/yicheng/
是否启用：开启

阿里云 OSS、腾讯云 COS、MinIO 等服务的 Endpoint 与 Region ID 格式不同，请以对应控制台或官方文档为准。自建 MinIO 使用 HTTP 时，Endpoint 应包含实际监听地址和端口，例如 http://192.168.1.100:9000。

浏览和管理云端文件

1. 从应用侧边栏进入 云端。
2. 在顶部选择 S3，再选择要使用的已启用账户。
3. 点击文件夹进入相应前缀；电脑端可使用鼠标双击。
4. 使用顶部刷新按钮重新加载当前目录。

S3 以对象和键前缀组织数据，应用会将相应层级呈现为文件和文件夹。常用操作包括：

• 新建：在底部新建 Markdown 或文件夹。
• 导入：将本机文件、图库图片等上传到当前云端位置。
• 打开：点击 Markdown 或 PDF 后，先下载到本地镜像目录，再进入编辑或预览。
• 文件菜单：长按文件，或在电脑端右键文件，可使用下载、编辑、预览、复制、移动、重命名、删除和复制下载地址等功能；实际项目以文件类型为准。
• 文件夹菜单：可重命名或删除文件夹。

复制、移动、重命名和删除会直接修改 Bucket 中的对象。执行文件夹级操作前，请确认账户权限和影响范围。

编辑并同步 Markdown

从 S3 云端打开 Markdown 后，应用会将文件下载到当前账户的本地镜像目录。编辑时：

• 云端文档同步为自动：在单文档编辑器中，本地保存后将当前文档回传到对应 S3 位置。
• 手动上传文档：在编辑器云端菜单选择 上传文档到云端，应用会先保存当前内容再上传。
• 多页签编辑器：S3 文档请使用 上传文档到云端 完成回传，不要只依赖自动文档同步。
• 图片未显示：确认文中使用相对路径后，执行 资源下载到本地。
• 插图需要回传：将 云端资源上传 设为自动，或手动执行 资源上传到云端。

三项设置的详细区别见 云端概述。

直链域名/CDN（可选）

普通云端浏览与文档同步使用 Access Key 和 Secret Key 鉴权，不需要配置直链域名。只有需要公开访问文件或使用云端图床时，才需要关注此项。

• 填写公开访问域名或 CDN 域名后，应用可据此拼接文件直链。
• 未填写时，应用可基于 Endpoint 拼接地址，但 Bucket 或对象必须允许公开读取才能直接访问。
• 配置直链域名不会自动修改 Bucket 权限，也不会将私有对象公开。
• 公网直链应只用于确实需要公开的资源，不要对私人文档目录开放匿名读取。

连接与使用问题排查

云端列表没有账户

检查账户管理顶部是否选择了 S3，并确认账户已保存且 是否启用 已打开。

无法列出对象

依次检查：

1. Endpoint 是否为服务商提供的 S3 接口地址，协议和端口是否正确。
2. Bucket 与 Region ID 是否匹配，是否误将区域名称或控制台网页地址填入 Endpoint。
3. Access Key、Secret Key 是否有效，密钥是否具有列出和读取对象的权限。
4. 根目录是否指向预期前缀，该前缀下是否确实有对象。
5. 当前服务是否支持界面所示的寻址方式；不可切换的选项不要按旧教程强行修改。

提示鉴权或权限不足

核对密钥状态、Bucket 策略和 Region ID。能够浏览但上传、重命名或删除失败时，通常还需检查创建、写入、复制或删除对象的权限，以及存储配额和服务端限制。

下载或同步失败

先检查网络、Endpoint、证书和对象权限。文档回传失败时，本地镜像文件仍会保留；修复问题后可手动执行 上传文档到云端。重要修改同时建议另行导出备份。

文档中的图片没有显示

确认图片已经上传到相同镜像层级，并且 Markdown 中的相对路径、大小写和文件扩展名完全匹配。S3 对象键区分大小写。随后执行 资源下载到本地；已有本地缓存不会仅因云端图片变化而自动更新。

贡献者: lotoze

上一页Webdav云端

下一页图床概述