云端地址图床

约 2150 字大约 7 分钟

2026-11-01

云端地址图床会将图片上传到你绑定的 WebDAV 或 S3 账户，并根据公开直链域名、CDN 或公开端点生成图片 URL，再将该 URL 插入 Markdown。

它适合希望集中管理图片、复用已有云端存储，并且能够为图片提供免认证访问地址的场景。

能上传并不等于能作为图床。 云端图床既要求账户有上传权限，也要求生成的图片 URL 无需登录即可访问。只支持鉴权下载的 WebDAV 地址或私有 S3 对象，不能直接作为跨环境图床链接。

配置前准备

1. 准备云端账户

先在 设置 > 云端设置 > 账户管理 中添加 WebDAV 或 S3 账户。配置方法见：

云端图床会绑定你选择的固定账户，不会自动跟随云端浏览器或文档同步的当前账户。切换文档同步账户，不会改变已有图床的上传目标。

2. 确认公开直链条件

WebDAV：需要在账户中配置可用的 直链域名。WebDAV 的 /dav/ 等接口通常需要认证，不能直接当作公开图片地址。
S3：Bucket 或对象需要允许公开读取，或者配置可公开访问的 CDN/自定义域名。应用不会自动修改 Bucket 的公开权限，也不会把临时的预签名 URL 写入文档。

建议先准备一个专用测试目录和测试图片，不要一开始就开放整个私人存储空间。

添加云端地址图床

打开 设置 > 图床设置。
点击右上角新建按钮，选择 新建图床。
将类型设为 云端地址。
填写 图床名称。
在 上传账户 中选择一个 WebDAV 或 S3 账户。
按需填写 图床根目录，默认为 YICHENG_IMAGEHOST。
查看页面显示的直链提示；WebDAV 可执行 测试直链。
如需立即使用，打开 是否启用，再点击顶部确认按钮保存。
确认 个性化设置 > 编辑器 > 编辑器应用图床 已打开。

如果还没有云端账户，点击页面中的创建引导前往账户管理。测试直链失败不会阻止保存图床配置，但未解决直链问题前，插图会回退为本地相对路径。

图床根目录与链接组成

图床根目录支持多级目录，使用 / 分隔，例如：

YICHENG_IMAGEHOST
img/blog
notes/2026

首尾多余的 / 会在保存时去除；留空会恢复默认值 YICHENG_IMAGEHOST。修改图床根目录只影响之后上传的图片，已经插入文档的旧链接不会改变。

WebDAV 示例

假设：

账户根目录：/dav/
图床根目录：YICHENG_IMAGEHOST
直链域名：https://cdn.example.com
图片文件名：cover.png

上传位置为：

/dav/YICHENG_IMAGEHOST/cover.png

生成的图片 URL 为：

https://cdn.example.com/YICHENG_IMAGEHOST/cover.png

WebDAV 的直链结果不再重复拼接账户根目录。因此，直链域名应当是与该云端账户根目录对应的公开访问前缀；如果服务商的 CDN 还包含用户 ID 或其他路径段，需要一并填写。

S3 示例

假设：

Bucket：my-documents
账户根目录：/notes/
图床根目录：YICHENG_IMAGEHOST
CDN 域名：https://cdn.example.com
图片文件名：cover.png

对象键为：

notes/YICHENG_IMAGEHOST/cover.png

配置 CDN 后，生成的图片 URL 为：

https://cdn.example.com/notes/YICHENG_IMAGEHOST/cover.png

如果未配置直链域名/CDN，应用会根据 Endpoint、Bucket 和对象键拼接地址，但该地址仍必须能够公开读取。

云端图床按原文件名写入统一目录。不同文档中的同名图片可能指向同一个远端文件并发生覆盖。建议使用具有区分度的文件名，或按项目使用不同的图床根目录。

WebDAV 直链测试

绑定 WebDAV 账户后，页面会显示当前直链状态，并提供 测试直链：

已配置直链域名时，用于验证手动填写的地址。
未配置时，应用会尝试根据 WebDAV 地址探测常见公开访问形式。
测试成功后，会回填并保存账户的直链域名，之后的插图即可使用。
测试会向图床目录上传测试图片、尝试匿名访问，并清理测试文件，请确保账户具有相应写入和删除权限。

部分服务的公开 CDN 与 WebDAV 地址没有可推导关系，例如包含独立用户路径的 123 云盘 CDN。这类情况需要在云端账户页手动填写完整直链域名，再用测试功能验证。

坚果云的 WebDAV 接口需要认证，当前界面会提示不支持免认证直链，不建议将它用作云端图床账户。

S3 公开访问与 CDN

S3 绑定页无法自动判断 Bucket 是否公开读，需要在服务商控制台自行确认：

上传账户具有对象写入权限。
用于图床的对象允许匿名读取，或 CDN 能正确回源并提供公开访问。
直链域名/CDN 的路径前缀与对象键匹配。
返回的是图片内容，而不是登录页、XML 错误页或临时跳转。

不要为了图床方便而直接开放整个包含私人文档的 Bucket。更稳妥的方式是使用专用 Bucket、专用前缀或仅公开图床目录的策略。

账户绑定后的变化

修改绑定账户的密码、密钥或直链域名后，之后的图床上传会使用账户的最新配置。
更换图床绑定的账户，只影响之后上传的图片。
删除绑定账户后，图床列表会提示账户已删除，插图将回退本地；重新编辑图床并选择可用账户即可。
云端账户的 是否启用 控制其是否用于云端浏览和同步，不限制图床绑定。即使停用了同步账户，图床仍可能使用该账户上传，请按实际需要管理权限和配置。

与云端资源上传的关系

云端地址图床会插入公网绝对 URL；云端资源上传则将图片放在当前云端 Markdown 的镜像位置，并插入相对路径。

编辑云端镜像文档且云端资源上传为自动时，插图默认优先走云端资源上传。如果需要明确上传到本页配置的图床，请长按图片或右键图片，使用 上传此图片到图床 或 上传全部本地图片到图床。

两种方式的区别详见图床概述。

常见问题排查

提示未配置直链域名

检查绑定的 WebDAV 账户。填写正确直链域名并测试，或改用能够提供公开 URL 的账户。问题未解决前，图片会保留本地引用。

提示绑定账户已删除

编辑云端图床，重新选择仍然存在的 WebDAV/S3 账户并保存。

上传成功但图片 URL 无法打开

WebDAV 重点检查直链域名与账户根目录的对应关系；S3 重点检查公开读策略、CDN 回源路径和对象键。将 URL 放到不登录云端账户的浏览器中验证，确认返回的是图片本身。

S3 返回权限错误

分别检查上传权限和公开读取权限。允许上传不代表允许匿名下载，使用 CDN 时还要检查 CDN 回源是否具备访问私有对象的合法配置。

同名图片内容被替换

检查不同文档是否上传了相同文件名到相同图床根目录。为图片使用唯一文件名，或按项目拆分图床根目录；已经被覆盖的远端图片需要从备份恢复。

插图仍显示相对路径

确认默认图床、编辑器应用图床和公开直链配置均可用，并查看是否有上传失败提示。如果当前是云端文档且自动云端资源上传已生效，相对路径也可能表示图片已经成功上传到文档的云端镜像位置，而不是上传失败。