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 中插入图片:

2️⃣ 当你在 CSDN 编辑器中预览 / 保存 / 发布时,
CSDN 会扫描文章中的所有图片链接。
3️⃣ 如果发现图片来自外站(比如 Gitee、GitHub、SM.MS 等),
CSDN 会自动下载那张图片,
再上传到它自己的图片服务器(i-blog.csdnimg.cn)。
4️⃣ 然后它会自动替换 Markdown 链接为:

这样文章在 CSDN 平台上完全使用自家的图床资源。
主要是为了:
目的 | 说明 |
---|---|
✅ 提高图片加载速度 | 自家的 CDN 更快,特别是在国内访问 |
✅ 避免外链失效 | 如果你删掉 Gitee 仓库,CSDN 依然能显示图片 |
✅ 内容安全 | 避免外部图片被篡改或带恶意脚本 |
✅ 图片防盗链 | Gitee、GitHub 对频繁访问的外链可能封禁,CSDN 自托管更稳定 |