如何配置 Typora + PicGo 实现图片自动上传 OSS（阿里云）？

配置 Typora + PicGo 实现图片自动上传到 OSS（对象存储），可以让你在 Markdown 中插入图片时，自动将图片上传到云端，从而确保文档在任何地方打开都能正常显示图片。

下面我将为你提供一份详细的、分步的配置指南。

整体思路

在阿里云 OSS 端做好准备：创建 Bucket，获取关键密钥。
安装并配置 PicGo：设置阿里云 OSS 图床。
在 Typora 中绑定 PicGo：让 Typora 调用 PicGo 进行上传。
测试整个流程：插入一张图片，验证是否自动上传到 OSS。

第一步：准备工作 - 配置阿里云 OSS

开通 OSS 服务
- 如果你还没有开通，请登录阿里云官网，进入 OSS 产品页面进行开通。
创建 Bucket（存储空间）
- 进入 OSS 管理控制台。
- 点击 创建 Bucket。
- 填写 Bucket 名称 ，例如 my-markdown-images。这个名称必须全局唯一。
- 区域：选择离你用户最近的地域，例如 华东1（杭州）。
- 存储类型 ：选择 标准存储 即可。
- 读写权限 ：非常重要！ 为了能让图片被公开访问，请选择 公共读。如果你的图片需要完全保密，请选择私有，但这需要更复杂的签名URL，对于博客等公开场景，"公共读"是最简单的选择。
- 其他设置保持默认，点击"确定"创建。
获取 Access Key（访问密钥）
- 将鼠标悬停在网页右上角的头像上，点击 AccessKey 管理。
- 你可以使用已有的 AccessKey，也可以创建新的（推荐使用子账户的 AccessKey，权限更安全）。
- 点击 创建 AccessKey，并按要求完成验证。
- 重要提示 ：系统会弹出对话框，显示你的 AccessKey ID 和 AccessKey Secret。这是你唯一一次能看到完整 Secret 的机会，请立即妥善保存（建议放入密码管理器）。
（可选）创建存储路径文件夹
- 在刚刚创建的 Bucket 中，你可以点击"文件管理"，然后新建一个文件夹，例如 typora/，这样上传的图片就会存放在这个目录下，方便管理。

第二步：安装并配置 PicGo

下载并安装 PicGo
- 前往 PicGo 的 GitHub Releases 页面：https://github.com/Molunerfinn/PicGo/releases
- 下载适合你操作系统的最新版本（通常是 .exe 文件用于 Windows，.dmg 文件用于 macOS）。
- 像安装普通软件一样完成安装。
安装阿里云 OSS 插件
- 打开 PicGo 应用。
- 在左侧边栏点击 插件设置。
- 在搜索框中输入 aliyun 或 oss。
- 找到 picgo-plugin-aliyun-oss 插件，点击安装。安装完成后可能需要重启 PicGo。
配置阿里云 OSS 图床
- 在左侧边栏点击 图床设置。
- 找到并点击 阿里云OSS ，开始填写配置信息：
  - KeyId：填写你第一步获取的 AccessKey ID。
  - KeySecret：填写你第一步获取的 AccessKey Secret。
  - Bucket：填写你创建的 Bucket 名称，例如 my-markdown-images。
  - Area：填写你的 Bucket 所在区域的 Endpoint（地域节点） ，不需要 https:// 。例如，如果你的区域是"华东1（杭州）"，则填写 oss-cn-hangzhou.aliyuncs.com。你可以在 Bucket 的"概览"页面找到这个Endpoint。
  - StorePath：填写你希望图片存储的路径，例如 typora/。这个路径可以不存在，PicGo 会自动创建。为了整洁，建议以 / 结尾。
  - CustomDomain：（强烈推荐设置） 如果你为 OSS Bucket 绑定了自定义域名（并完成了CNAME解析），可以在这里填写，例如 https://img.example.com。如果没有，可以留空，PicGo 会使用 OSS 的默认域名。
- 填写完毕后，点击确定或 设为默认图床。
测试上传
- 在 PicGo 主界面的 上传区，拖拽一张图片进去，或者点击截图上传。
- 如果底部的日志显示上传成功，并且相册里出现了刚刚上传的图片，说明 PicGo 配置正确。
- 你可以复制链接，在浏览器中打开，确认图片可以正常访问。

第三步：配置 Typora

打开 Typora 设置
- 打开 Typora，进入 文件 -> 偏好设置（macOS 是 Typora -> Preferences...）。
配置图像设置
- 在左侧点击图像。
- 进行如下关键设置：
  - 插入图片时... ：选择 上传图片。
  - 上传服务 ：选择 PicGo (app)。
  - PicGo 路径 ：这里需要填写 PicGo 应用程序在你电脑上的安装路径。
    - Windows : 通常是 C:\Users\[你的用户名]\AppData\Local\Programs\PicGo\PicGo.exe。你也可以通过右键点击 PicGo 桌面快捷方式 -> 属性 来查看"目标"路径。
    - macOS : 通常是 /Applications/PicGo.app。你可以打开"应用程序"文件夹，将 PicGo.app 拖拽到输入框中，路径会自动填充。
- 配置完成后，如下图所示：
验证图片上传服务
- 点击上图中的 验证图片上传选项 按钮。
- Typora 会尝试调用 PicGo 上传一张测试图片。
- 如果出现 "成功" 或 "验证成功" 的提示，并且你的 PicGo 相册里多了一张测试图片，说明 Typora 和 PicGo 的联动已经成功！

第四步：开始享受！

现在，一切就绪。你可以：

直接粘贴截图 （Ctrl+V）到 Typora。
直接拖拽本地图片到 Typora。
使用 格式 -> 图像 -> 插入本地图片...。

Typora 会立即在后台调用 PicGo，将图片上传到你配置的阿里云 OSS，并自动将 Markdown 文档中的图片地址替换为 OSS 上的公网 URL。

从此，你的 Markdown 文档就实现了 "一次编写，处处显示"，再也不用担心图片路径丢失的问题了。

常见问题与技巧

PicGo 路径找不到？ 确保 PicGo 已经成功安装。在 Windows 上，如果找不到，可以去 C:\Program Files\ 或 C:\Program Files (x86)\ 目录下找找看。
上传失败？
- 检查 PicGo 的阿里云 OSS 配置，特别是 KeySecret、Bucket 和 Area（Endpoint）是否正确。
- 检查 OSS Bucket 的读写权限是否为 "公共读"。
- 查看 PicGo 的详细日志，里面通常会有明确的错误信息。
安全提醒：你的 AccessKey 拥有操作 OSS 的权限，请务必妥善保管，不要泄露。使用子账户的 AccessKey 是更安全的选择。
图片管理：定期去 PicGo 的"相册"或阿里云 OSS 控制台查看和管理已上传的图片，可以删除不再使用的图片以节省存储空间。