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 自托管更稳定
相关推荐
kk哥88997 小时前
iOS 26 适配指南:UIScrollView 新特性与最佳实践
macos·ios·cocoa
壕壕14 小时前
Re: 0x03. 从零开始的光线追踪实现-多球体着色
macos·计算机图形学
LZ7工作室14 小时前
MAC编程:在MACOS安装和使用 Git 的方法
网络·git·macos·github·个人开发
白玉cfc18 小时前
【iOS】多线程基础
macos·ios
2501_9151063220 小时前
游戏上架 App Store 的技术流程解析 从构建到审核的全流程指南
游戏·macos·ios·小程序·uni-app·cocoa·iphone
laocaibulao1 天前
mac电脑brew update很慢咋办?
macos
心灵宝贝1 天前
XMind for Mac v24.01.dmg 安装教程(Mac思维导图软件下载安装步骤)
macos·xmind
醇氧1 天前
Mac 安装 Docker Desktop
macos·docker·容器
神秘人-解说1 天前
在Mac上安装Windows 11/10双系统(M1/M2/Intel通用)
windows·macos·mac安装双系统·mac安装虚拟机·mac安装windows
知难行难1 天前
macOS配置Apocrita及ssh访问及获取GPU权限
运维·macos·ssh