引言:为什么要解决搭建图床?
本地 Markdown 笔记的图片依赖本地路径,是困扰无数创作者的痛点。换电脑或分享笔记时,图片链接容易失效。解决这个问题的核心是搭建一个'图床',把图片托管到云端,让链接永远有效。
本文将介绍使用 Gitee(国内免费仓库)+ PicGo(自动上传工具)+ Node.js(运行环境)搭建图床的方案,实现国内访问快、完全免费、无缝对接 Obsidian 等功能。
一、概念扫盲:为什么需要这些工具?
在开始操作前,先搞懂四个核心概念:
- 图床:专门用来存储图片的云端平台,核心是生成'永久可访问的图片 URL'。将图片当成'货物',图床就是'网络仓库',摆脱路径依赖。
- Gitee:国内版代码托管平台,类似 GitHub。选它当图床的理由包括访问快(国内节点)、免费开源、支持 RAW 链接直接访问图片。
- PicGo:图片上传客户端,核心是'一键上传本地图片,自动生成网络链接'。默认不直接支持 Gitee,需安装插件。
- Node.js:让 JavaScript 代码能在电脑本地运行的运行时环境。PicGo 的插件是用 Node.js 开发的,必须安装才能运行。
二、环境搭建:Node.js 安装
-
下载 Node.js 访问 Node.js 官网,选择 LTS 长期支持版。
- Windows 用户选 x64 Installer;
- macOS 选 .pkg 安装包;
- Linux 通过包管理器安装。
-
安装与验证 双击安装包,勾选'Add to PATH'(自动配置环境变量)。打开命令提示符(CMD),输入以下命令验证:
node -v
npm -v
若正常输出版本,说明安装成功。
三、PicGo 安装:图片上传客户端
-
下载对应版本 访问 PicGo 官网或国内镜像,根据系统选择。
- Windows:优先选 64 位系统专属版本;
- macOS:选 .dmg;
- Linux:选 .AppImage。 建议选 2.4 及以上版本,老版本可能不支持 Gitee 插件。
-
安装与启动 双击安装包完成安装。启动 PicGo 后,右下角托盘会出现图标,右键打开主界面即可操作。
四、Gitee 配置:创建图片仓库
-
新建 Gitee 仓库 登录 Gitee 官网,点击右上角'+'→新建仓库。
- 仓库名称:建议含 img 或者 picture;
- 可见性:必须选'开源'(否则图片无法公开访问);
- 初始化仓库:勾选(自动生成 README)。
-
获取访问令牌(Token) 点击 Gitee 头像→'设置'→'私人令牌'→'生成新令牌'。
- 描述:填 PicGo 图床;
- 权限:仅勾选 projects(最小必要权限)。 提交后,复制生成的 Token(仅显示一次,务必保存)。
五、PicGo 配置:连接 Gitee 图床
- 安装 Gitee 插件 打开 PicGo 主界面→左下角'插件设置'。命令行手动安装:
npm config set registry https://registry.npmmirror.com
npm install picgo-plugin-gitee-uploader -g
搜索框输入 gitee,找到 gitee-uploader 插件,点击安装。


