引言:为什么要解决搭建图床?
你是否遇到过这样的场景:
- 用 Obsidian 写了半年的知识库,换电脑时发现所有图片都变成'破碎图标';
- 把 Markdown 笔记分享给同事,对方打开后图片全是本地路径,根本看不到内容;
- 尝试用云盘链接替代,却因为'防盗链'或'链接过期',图片还是无法正常显示……
本地 Markdown 笔记的'图片依赖本地路径',是困扰无数创作者的痛点。而解决这个问题的核心,就是搭建一个'图床'——把图片托管到云端,让链接永远有效。
本文将带你用'Gitee(国内免费仓库)+ PicGo(自动上传工具)+ Node.js(运行环境)'搭建图床,不仅解决'图片失效',还能实现:
- ✔️ 国内访问快:Gitee 服务器在国内,无需科学上网,图片秒加载;
- ✔️ 完全免费:Gitee 仓库、PicGo、Node.js 均为开源免费工具;
- ✔️ 无缝对接 Obsidian:写笔记时'拖入图片自动上传',全程无感知;
从工具原理解析到 Step by Step 实操(包括环境搭建、插件配置、异常排查),甚至帮你避过 90% 的踩坑点。无论你是笔记爱好者,还是专业创作者,都能通过这篇文章彻底解决'图片链接失效'的心病。
一、概念扫盲:为什么需要这些工具?
在开始操作前,先搞懂四个核心概念,避免'盲目操作':
1. 图床:图片的'云端仓库'
- 定义:专门用来存储图片的云端平台,核心是生成'永久可访问的图片 URL'(如
https://gitee.com/xxx.png)。 - 类比:把图片当成'货物',图床就是'网络仓库',随时能通过链接提取货物(图片)。
- 解决的痛:
- 本地笔记里的
,换电脑、分享给别人时,链接必然失效; - 图床的链接是'云端地址',在哪台设备打开都能访问,彻底摆脱'路径依赖'。
- 本地笔记里的
2. Gitee:国内版'代码托管平台'(选它当图床的理由)
- 定义:类似 GitHub,但服务器在国内,是免费的代码/文件托管平台,可以理解为'中国的 GitHub'。
- 为什么选 Gitee 当图床?
- ✅ 访问快:国内节点,不用科学上网,图片加载秒开;
- ✅ 免费开源:创建'开源仓库'后,图片可被公开访问(非开源仓库的图片无法外链);
- ✅ 支持 RAW 链接:仓库里的图片能通过
https://gitee.com/用户名/仓库名/raw/分支/图片路径.png直接访问(类似 GitHub 的 RAW 链接,但速度更快)。
- 对比其他云盘:百度网盘的链接带防盗链,无法直接插入 Markdown;而 Gitee 的 RAW 链接是'纯静态文件地址',完美适配 Markdown 语法。
3. PicGo:图片上传'自动化神器'
- 定义:图片上传客户端,核心是'一键上传本地图片,自动生成网络链接'。
- 核心价值:把'登录 Gitee→找仓库→点击上传→复制链接'的繁琐步骤,压缩成'拖入图片→自动出链接'(甚至支持快捷键
Ctrl+Alt+U)。 - 为什么需要插件?
PicGo 默认支持 GitHub、七牛云等图床,但不直接支持 Gitee。这时需要安装
gitee-uploader插件(用 Node.js 开发),让 PicGo 能对接 Gitee。
4. Node.js:插件的'动力引擎'
- 定义:让 JavaScript 代码能在电脑本地运行的运行时环境(类似 Java 的 JVM,Python 的解释器)。
- 在图床场景里的作用:
PicGo 的插件(如
gitee-uploader)是用 Node.js 开发的,必须安装 Node.js 才能运行这些插件。简单说:Node.js 是'插件的发动机',没有它,PicGo 无法加载 Gitee 插件。


