Typora 配置 PicGo 使用 Gitee 图床实现图片自动上传(Mac 详细教程)

Typora+PicGo+Gitee搭建属于自己的图床MAC版

  • 问题: 用typora写完笔记,但是上传其他的笔记平台的时候,图片处理起来很麻烦,
    此方法可以解决你的烦恼. github没有魔法国内使用体验不佳, 所以采用gitee替换
  • Gitee 作为国内代码托管平台(类似 GitHub),速度快、访问稳定,非常适合国内笔记 / 博客用户用来存图片。

一、 Gitee 作为图床的原理

把图片上传到 Gitee 仓库中,然后通过图片的 原始链接(Raw URL) 访问它。

Typora、PicGo 等工具都可以自动完成上传 + 链接替换。

例子:

复制代码
https://gitee.com/yourname/image-repo/raw/master/img/test.png

这类链接可以直接在网页(如 CSDN、掘金等)中访问和显示图片。


二、基础使用方法(适合 Typora / PicGo)

1、 创建一个公开仓库
  • 登录 Gitee → 点击右上角 "+" → "新建仓库"
  • 仓库名如:image-host
  • 必须设置为 公开(Public),否则图片外链无法访问。

2、 生成访问令牌(Token)
  • 进入 Gitee → 个人设置 → "安全设置" → "私人令牌(Personal Access Token)"

  • 新建一个 Token,勾选:

    repos, notes, issues, pull_requests

  • 复制生成的 Token(只显示一次, 存到到备忘录一会用)。


3、安装并配置 PicGo
  • 下载对应的mac版
  • 下载后, 安装如果显示这个
  • PicGo 没有通过苹果的「开发者签名认证」,macOS 默认会认为这是"不受信任来源的应用"。

打开终端执行

shell 复制代码
sudo xattr -rd com.apple.quarantine /Applications/PicGo.app
sudo 以管理员权限执行命令(需要输入密码)
xattr macOS 自带的命令,用于查看或修改文件的"扩展属性"(extended attributes)
-r 表示递归操作(recursive),作用于文件夹内所有文件
-d 表示删除指定的属性(delete)
com.apple.quarantine 这个属性名就是苹果系统添加的"隔离标记"
/Applications/PicGo.app 要操作的目标文件路径,也就是 PicGo 的安装位置

打开后, 会在顶部显示, 这时候还需要下载一个插件,才能完成图片自动上传到gitee

4、安装配置插件(显示gitee选项和gitee自动上传)

在 PicGo 设置 → 插件设置 → 搜索并安装:

复制代码
picgo-plugin-gitee-uploader
  • 如果不能搜到就需要用命令行来安装(安装后重启即可看到)
shell 复制代码
cd ~/Library/Application\ Support/picgo   # picgo插件存放的位置
npm install picgo-plugin-gitee-uploader   #用npm下载这个插件

#没有npm工具可以用homebrew安装
brew install node

✔️ npm 是 Node.js 自带的包管理器,当你安装 Node.js 时,npm 会自动一并安装。


填写:

参数 示例
仓库名 yourname/image-host
分支名 master
Token (刚才生成的 Token)
存储路径 img/
自定义域名(方便回显) https://gitee.com/yourname/image-host/raw/master

随便上传一个图片,然后去你刚才gitee创建的仓库中看看有没有

5、 配置 Typora

设置 → 图像 → 上传图片 → 图像上传服务选择 "PicGo (app)" 配置完成你在粘贴图片会自动上传并回显示


三、优点与缺点分析

项目 优点 缺点
访问速度快 国内 CDN,加载非常快 ---
操作简单 可直接用 PicGo 上传 ---
CSDN/掘金兼容好 外链可直接显示 ---
⚠️ 仓库需公开 私有仓库外链无法访问 图片有隐私风险
⚠️ 有时触发防盗链 某些平台(知乎)会屏蔽 raw 链接 可通过反向代理或 CDN 解决
⚠️ 空间有限 免费账户存储空间有限(1GB) 图片太多时需分仓或清理

四、建议实践方案

需求 推荐方案
个人笔记、CSDN、掘金 ✅ Gitee 图床(速度快、稳定)
私密文档 / 公司项目 🚫 不建议(公开仓库才能访问)
跨国博客(中外访问) 🌍 GitHub + jsDelivr
高可靠性 / 企业用途 ☁️ 阿里 OSS / 腾讯 COS

五、补充(你的仓库删除了, 也不会影响已经上传到csdn的图片)

  • 当你把文章发布到 CSDN 时,平台会自动替换外部图片链接为它自己的 csdnimg.cn 链接。

为什么 CSDN 会自动替换图片链接?

机制逻辑

1️⃣ 你在 Markdown 或 HTML 中插入图片:

复制代码
![](https://gitee.com/gjlearn/image-host/raw/master/img/202510102038612.png)

2️⃣ 当你在 CSDN 编辑器中预览 / 保存 / 发布时,

CSDN 会扫描文章中的所有图片链接。

3️⃣ 如果发现图片来自外站(比如 Gitee、GitHub、SM.MS 等),

CSDN 会自动下载那张图片

再上传到它自己的图片服务器(i-blog.csdnimg.cn)。

4️⃣ 然后它会自动替换 Markdown 链接为:

复制代码
![](https://i-blog.csdnimg.cn/img_convert/xxxxxxxxxxxxxxxx.png)

这样文章在 CSDN 平台上完全使用自家的图床资源。

主要是为了:

目的 说明
✅ 提高图片加载速度 自家的 CDN 更快,特别是在国内访问
✅ 避免外链失效 如果你删掉 Gitee 仓库,CSDN 依然能显示图片
✅ 内容安全 避免外部图片被篡改或带恶意脚本
✅ 图片防盗链 Gitee、GitHub 对频繁访问的外链可能封禁,CSDN 自托管更稳定
相关推荐
林鸿群3 小时前
Apple M3 MacOS arm64 编译QGroundControl5.0.8(base on Qt 6.8.3)
macos·ios·qgc·qgroundcontrol
Someone_sky3 小时前
Color Wheel for Mac:一键解锁专业配色,设计效率翻倍
macos
柯南二号3 小时前
【大前端】Android Deep Link 技术详解与实践指南
gitee·deeplink
2501_9151063215 小时前
iOS 26 能耗监测全景,Adaptive Power、新电池视图
android·macos·ios·小程序·uni-app·cocoa·iphone
Python私教18 小时前
5分钟上手 MongoDB:从零安装到第一条数据插入(Windows / macOS / Linux 全平台图解)
windows·mongodb·macos
南部余额18 小时前
gitee设置不公开邮箱地址,推送报错解决方案
gitee
Damon小智2 天前
玩转CodeX:CodeX安装教程(Windows+Linux+MacOS)
linux·windows·macos·ai·ai编程·codex·gpt-5
小番茄夫斯基2 天前
团队效率神器!Mac 下 Homebrew 从入门到精通
macos
空安小菜鸟2 天前
Mac 重启电脑导致代理失效
macos