如何配置typora图片上传服务

Typora + Gitee 作为图床 的详细操作步骤(免费、国内访问快,适合笔记图片存储)

刚开始考虑使用oss,但是发现几乎都要收费,而我只是想上传一些不那么重要的图片(如:笔记图片),最后综合考虑使用gitee作为远程仓库保存图片最好,下面是详细的操作步骤。

一、准备工作

  1. 注册 / 登录 Gitee 账号

    打开 Gitee 官网,注册账号并登录(已有账号直接登录)。

  2. 创建 Gitee 公开仓库(用于存储图片):

    • 点击 Gitee 首页右上角「+」→ 选择「新建仓库」;
    • 填写仓库信息:
      • 仓库名称:自定义(如 typora-image-bed);
      • 仓库介绍:选填(如「Typora 笔记图片存储」);
      • 仓库类型:公开(必须选公开,否则图片无法通过链接访问);
      • 初始化仓库:勾选「使用 Readme 文件初始化这个仓库」;
    • 点击「创建」,完成仓库创建。

二、获取 Gitee 的私人令牌(Token)

Token 是 Gitee 的 API 授权凭证,用于 PicGo 上传图片时验证身份:

  1. 登录 Gitee 后,点击右上角头像 → 选择「设置」;
  2. 在左侧菜单找到「私人令牌(Private Token)」→ 点击「生成新令牌」;
  3. 填写令牌信息:
    • 令牌描述:自定义(如「Typora 图床令牌」);
    • 权限勾选:只勾选 「projects」(仓库操作权限);
  4. 输入 Gitee 密码,点击「提交」;
  5. 复制生成的 Token(这是唯一一次查看 Token 的机会,务必保存好,丢失需重新生成)。

三、安装并配置 PicGo

PicGo 是连接 Typora 和 Gitee 的工具,负责自动上传图片:

  1. 下载安装 PicGo

    打开 PicGo 官网,选择对应系统的安装包(Windows/macOS/Linux),安装后打开。

  2. 配置 Gitee 图床

    • 打开 PicGo → 点击左侧「图床设置」→ 选择「Gitee 图床」;
    • 填写配置项:
      • repo:Gitee 仓库地址(格式:用户名/仓库名,如 zhangsan/typora-image-bed);
      • branch:仓库分支(默认填 mainmaster);
      • token:粘贴刚才复制的 Gitee 私人令牌;
      • path:图片存储的文件夹路径(自定义,如 typora/,图片会存在仓库的 typora 文件夹下);
      • customPath:选填(图片命名规则,默认留空即可);
      • customUrl:留空(不需要自定义域名);
    • 点击「设为默认图床」,然后点击「确定」保存配置。
  3. 测试 PicGo 上传

    拖一张本地图片到 PicGo 的主界面,若能生成以 https://gitee.com/... 开头的链接,则配置成功。

四、Typora 关联 PicGo

让 Typora 插入图片时自动上传到 Gitee:

  1. 打开 Typora → 点击「文件」→ 选择「偏好设置」;
  2. 在左侧菜单选择「图像」;
  3. 配置「插入图片时」:
    • 下拉框选择「上传图片」;
    • 勾选「对本地位置的图片应用上述规则」;
  4. 配置「上传服务设定」:
    • 「上传服务」下拉框选择「PicGo」;
    • 点击「浏览」,选择 PicGo 的安装路径(如 Windows 默认是 C:\Program Files\PicGo\PicGo.exe,macOS 是 /Applications/PicGo.app);
  5. 点击「验证图片上传选项」,若提示「验证成功」,则配置完成。

五、使用效果测试

在 Typora 中插入本地图片(如拖入一张图片),Typora 会自动调用 PicGo 将图片上传到 Gitee 仓库,并将图片链接替换为 Gitee 的在线链接(格式类似 https://gitee.com/zhangsan/typora-image-bed/raw/main/typora/xxx.png)。

注意事项

  1. 仓库公开性:必须是公开仓库,否则图片链接无法访问;
  2. Token 安全:不要泄露 Token,否则他人可操作你的 Gitee 仓库;
  3. 流量限制:Gitee 对公开仓库的流量没有明确限制,但避免上传过大 / 过多图片(建议单张图片不超过 5MB);
  4. 图片命名:避免重复文件名,PicGo 会自动重命名重复文件。

问题:配置 Gitee 图床时没有gitee选项

image-20251129134618915

因为默认安装的 PicGo(官方版)没有内置 Gitee 插件,需要手动安装 Gitee 图床插件来添加这个功能以下是详细操作步骤:

步骤 1:打开 PicGo 的插件市场

  1. 打开 PicGo → 点击左侧菜单栏的「插件设置」(如果是移动端 PicGo,一般在「我的」→「插件管理」);
  2. 在「插件市场」的搜索框中输入 gitee,找到「gitee-uploader」插件(官方 Gitee 图床插件)。

步骤 2:安装 Gitee 插件

  1. 点击「gitee-uploader」插件右侧的「安装」按钮;
  2. 等待安装完成(安装过程中不要关闭 PicGo);
  3. 安装成功后,重启 PicGo。

步骤 3:配置 Gitee 图床

重启 PicGo 后,回到「图床设置」,就能看到「Gitee」选项了,按照之前教的步骤填写配置(repo、branch、token 等)即可。

如果是移动端 PicGo(如 PicGo App),部分版本可能不支持插件安装,建议换成桌面版 PicGo(Windows/macOS) 操作(桌面版支持插件扩展)。

问题:typora上传服务中不知道选哪个

image-20251129134708502

  • 「PicGo (app)」:对应你安装的桌面版 PicGo 应用(带图形界面的那个),Typora 会直接调用这个应用来上传图片;
  • 「PicGo-Core (command line)」:是 PicGo 的命令行版本(需要单独安装),你没装的话不用选;
  • 「Custom Command」:是自定义上传命令,适合高级场景,这里用不到。

选完「PicGo (app)」后,点击「浏览」按钮,找到你电脑上 PicGo 桌面应用的安装路径(比如 Windows 默认是C:\Program Files\PicGo\PicGo.exe,macOS 是/Applications/PicGo.app),然后验证上传即可。

posted @ 2025-11-29 13:51  LackyQueen  阅读(5)  评论(0)    收藏  举报