如何配置typora图片上传服务
Typora + Gitee 作为图床 的详细操作步骤(免费、国内访问快,适合笔记图片存储)
刚开始考虑使用oss,但是发现几乎都要收费,而我只是想上传一些不那么重要的图片(如:笔记图片),最后综合考虑使用gitee作为远程仓库保存图片最好,下面是详细的操作步骤。
一、准备工作
-
注册 / 登录 Gitee 账号:
打开 Gitee 官网,注册账号并登录(已有账号直接登录)。
-
创建 Gitee 公开仓库(用于存储图片):
- 点击 Gitee 首页右上角「+」→ 选择「新建仓库」;
- 填写仓库信息:
- 仓库名称:自定义(如
typora-image-bed); - 仓库介绍:选填(如「Typora 笔记图片存储」);
- 仓库类型:公开(必须选公开,否则图片无法通过链接访问);
- 初始化仓库:勾选「使用 Readme 文件初始化这个仓库」;
- 仓库名称:自定义(如
- 点击「创建」,完成仓库创建。
二、获取 Gitee 的私人令牌(Token)
Token 是 Gitee 的 API 授权凭证,用于 PicGo 上传图片时验证身份:
- 登录 Gitee 后,点击右上角头像 → 选择「设置」;
- 在左侧菜单找到「私人令牌(Private Token)」→ 点击「生成新令牌」;
- 填写令牌信息:
- 令牌描述:自定义(如「Typora 图床令牌」);
- 权限勾选:只勾选 「projects」(仓库操作权限);
- 输入 Gitee 密码,点击「提交」;
- 复制生成的 Token(这是唯一一次查看 Token 的机会,务必保存好,丢失需重新生成)。
三、安装并配置 PicGo
PicGo 是连接 Typora 和 Gitee 的工具,负责自动上传图片:
-
下载安装 PicGo:
打开 PicGo 官网,选择对应系统的安装包(Windows/macOS/Linux),安装后打开。
-
配置 Gitee 图床:
- 打开 PicGo → 点击左侧「图床设置」→ 选择「Gitee 图床」;
- 填写配置项:
- repo:Gitee 仓库地址(格式:
用户名/仓库名,如zhangsan/typora-image-bed); - branch:仓库分支(默认填
main或master); - token:粘贴刚才复制的 Gitee 私人令牌;
- path:图片存储的文件夹路径(自定义,如
typora/,图片会存在仓库的typora文件夹下); - customPath:选填(图片命名规则,默认留空即可);
- customUrl:留空(不需要自定义域名);
- repo:Gitee 仓库地址(格式:
- 点击「设为默认图床」,然后点击「确定」保存配置。
-
测试 PicGo 上传:
拖一张本地图片到 PicGo 的主界面,若能生成以
https://gitee.com/...开头的链接,则配置成功。
四、Typora 关联 PicGo
让 Typora 插入图片时自动上传到 Gitee:
- 打开 Typora → 点击「文件」→ 选择「偏好设置」;
- 在左侧菜单选择「图像」;
- 配置「插入图片时」:
- 下拉框选择「上传图片」;
- 勾选「对本地位置的图片应用上述规则」;
- 配置「上传服务设定」:
- 「上传服务」下拉框选择「PicGo」;
- 点击「浏览」,选择 PicGo 的安装路径(如 Windows 默认是
C:\Program Files\PicGo\PicGo.exe,macOS 是/Applications/PicGo.app);
- 点击「验证图片上传选项」,若提示「验证成功」,则配置完成。
五、使用效果测试
在 Typora 中插入本地图片(如拖入一张图片),Typora 会自动调用 PicGo 将图片上传到 Gitee 仓库,并将图片链接替换为 Gitee 的在线链接(格式类似 https://gitee.com/zhangsan/typora-image-bed/raw/main/typora/xxx.png)。
注意事项
- 仓库公开性:必须是公开仓库,否则图片链接无法访问;
- Token 安全:不要泄露 Token,否则他人可操作你的 Gitee 仓库;
- 流量限制:Gitee 对公开仓库的流量没有明确限制,但避免上传过大 / 过多图片(建议单张图片不超过 5MB);
- 图片命名:避免重复文件名,PicGo 会自动重命名重复文件。
问题:配置 Gitee 图床时没有gitee选项

因为默认安装的 PicGo(官方版)没有内置 Gitee 插件,需要手动安装 Gitee 图床插件来添加这个功能以下是详细操作步骤:
步骤 1:打开 PicGo 的插件市场
- 打开 PicGo → 点击左侧菜单栏的「插件设置」(如果是移动端 PicGo,一般在「我的」→「插件管理」);
- 在「插件市场」的搜索框中输入
gitee,找到「gitee-uploader」插件(官方 Gitee 图床插件)。
步骤 2:安装 Gitee 插件
- 点击「gitee-uploader」插件右侧的「安装」按钮;
- 等待安装完成(安装过程中不要关闭 PicGo);
- 安装成功后,重启 PicGo。
步骤 3:配置 Gitee 图床
重启 PicGo 后,回到「图床设置」,就能看到「Gitee」选项了,按照之前教的步骤填写配置(repo、branch、token 等)即可。
如果是移动端 PicGo(如 PicGo App),部分版本可能不支持插件安装,建议换成桌面版 PicGo(Windows/macOS) 操作(桌面版支持插件扩展)。
问题:typora上传服务中不知道选哪个

- 「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),然后验证上传即可。

浙公网安备 33010602011771号