写博客、记笔记离不开图片但图片存哪一直是个问题。本文教你用 Gitee码云搭建免费图床配合 PicGo 实现一键上传并接入 Typora 和 Obsidian 两大笔记软件实现粘贴即上传的丝滑体验。一、方案介绍图床就是专门用来存放图片的服务器上传图片后返回一个 URL 链接你在文章里引用这个链接就能展示图片。方案费用优点缺点Gitee 图床本教程免费免费、国内访问快、稳定仓库有容量限制图片多了可能需要清理腾讯云对象存储 COS约 10 元/年容量大、速度快需要付费GitHub 图床免费容量大国内访问慢可能需要科学上网本教程选择Gitee PicGo的组合完全免费国内访问速度快适合个人博客和笔记使用。这是同学的腾讯云对象存储的付费方案教程和GitHub 图床教程可提供帮助勤奋又努力的他值得基于腾讯云对象存储 COS 与 PicGo 的 Obsidian 自动化图床方案深度实践_picgo连接cos-CSDN博客如何在gitee/github上面搭建obsidian的图床_gitee 图片床-CSDN博客二、准备工作需要提前安装好以下软件Typora或 Obsidian—— Markdown 编辑器PicGo—— 图片上传工具Node.js—— PicGo 插件依赖的运行环境PicGo 2.x 需要安装3.x 版本可跳过三、Gitee 中创建仓库并生成 Token1. 新建仓库登录 Gitee点击右上角号 →新建仓库。关键设置仓库名称随意比如picture是否开源选择开源重要选私有图片无法公开访问初始化仓库勾选添加一个 README 文件2. 生成私人令牌Token进入 Gitee → 右上角头像 →设置→私人令牌→生成新令牌。勾选权限只需要勾选projects仓库相关权限即可提交后会要求输入密码验证验证通过后页面会显示一串 Token 字符串⚠️重要提醒Token 只在生成时显示一次请立即复制保存到安全的地方关闭页面后就再也看不到了。如果丢了只能重新生成。四、安装 PicGo 和 Node.js1. 下载 PicGo前往 PicGo 官方发布页下载Releases · Molunerfinn/PicGo往下滚动找到对应平台的安装包这里给出Window64位:https://release.picgo.app/3.0.0/PicGo-3.0.0-x64.exe下载时如果浏览器提示有风险出现感叹号点击「保留」即可这是正常的安全提示。2. 安装 Node.jsPicGo 2.x 需要前往 Node.js 官网 下载 LTS长期支持版并安装。安装完成后打开命令行WinR 输入cmd输入node -v如果显示版本号如v22.x.x说明安装成功。 PicGo 3.x 版本已经内置了运行环境可以跳过 Node.js 的安装。五、配置 PicGo1. 设置中文界面打开 PicGo → 右上角设置齿轮图标 → 找到语言设置切换为中文。2. 安装 Gitee 上传插件PicGo 默认不包含 Gitee 图床需要安装插件点击左侧插件设置搜索gitee安装gitee-uploader插件⚠️ 如果插件安装失败请检查 Node.js 是否正确安装命令行输入node -v有版本号输出。检查一下是不是地址端口对不对一般都是这个可以再看看。3. 开启时间戳重命名点击左侧PicGo 设置→ 开启时间戳重命名。这样可以避免图片重名覆盖每张图片的文件名都是唯一的时间戳。4. 配置 Gitee 图床点击左侧图床设置→ 找到Gitee填写以下信息配置项说明示例仓库名你的 Gitee 用户名/仓库名zero111888/picture分支名仓库分支默认mastermasterToken第三步生成的私人令牌a1b2c3d4e5...存储路径图片在仓库中的存放目录可选img/自定义域名留空即可Gitee 会自动生成不填仓库名格式是用户名/仓库名比如你的 Gitee 主页是https://gitee.com/zero111888仓库名是picture那这里就填zero111888/picture。填写完成后点击确定然后点击设为默认图床。5. 测试上传在 PicGo 的上传区拖入一张图片或点击选择一张图片上传。如果配置正确上传成功后会显示通知并且剪贴板会自动复制图片的 URL 链接。你可以粘贴到浏览器中验证图片是否能正常显示。❌ 如果上传失败请检查仓库是否设为开源Token 是否正确是否多复制了空格仓库名格式是否为用户名/仓库名网络是否正常六、Typora 接入图床Typora 可以配置为自动上传图片到图床实现粘贴图片即上传。配置步骤打开 Typora →文件→偏好设置→图像插入图片时选择上传图片上传服务选择PicGo(app)PicGo 路径选择你安装的 PicGo 程序路径如C:\Program Files\PicGo\PicGo.exe点击验证图片上传选项进行测试验证成功后你在 Typora 中粘贴截图或拖入图片时Typora 会自动调用 PicGo 上传到 Gitee并将返回的 URL 链接插入到文档中。七、Obsidian 接入图床1. 安装图片上传插件打开 Obsidian →设置→第三方插件关闭安全模式如果已开启点击浏览搜索Image Auto Upload或obsidian picgo找到对应插件并安装然后启用2. 配置上传接口进入插件设置页面上传方式选择PicGo接口地址默认http://127.0.0.1:36677PicGo 本地服务端口⚠️ 确保 PicGo 已打开且PicGo 设置 → 设置 Server中的端口与插件一致默认 36677。配置完成后在 Obsidian 中粘贴图片时会自动上传到 Gitee 图床。八、常见问题Q1上传失败提示 401 未授权Token 错误或已过期。重新到 Gitee 生成令牌更新 PicGo 配置。Q2图片上传成功但链接打不开仓库设为了私有。进入 Gitee 仓库 →管理→ 将仓库改为开源。Q3PicGo 插件安装失败确认 Node.js 已安装命令行输入node -v有输出尝试更换 npm 源在 PicGo 设置中设置 npm 镜像为https://registry.npmmirror.com重启 PicGo 后重试Q4Typora 验证图片上传失败确认 PicGo 已打开并正在运行确认 PicGo 路径填写正确指向.exe程序文件尝试重启 TyporaQ5Gitee 仓库满了怎么办Gitee 单个仓库有容量限制通常 500MB。解决方案定期清理不需要的图片新建一个仓库继续使用如果图片量大建议迁移到腾讯云 COS一年十几块Q6Obsidian 插件上传图片没反应检查 PicGo 是否在运行检查 Server 端口是否匹配尝试手动上传一张图片测试九、总结整个流程回顾Gitee 建仓库开源 → 生成 Token ↓ 安装 PicGo Node.js → 安装 gitee 插件 → 配置图床信息 ↓ Typora / Obsidian 对接 PicGo → 完成搭建完成后你在 Typora 或 Obsidian 中粘贴截图图片会自动上传到 Gitee 仓库并返回链接写博客时再也不用担心图片丢失了。方案优缺点✅免费不花一分钱✅国内速度快Gitee 是国内的访问比 GitHub 快很多✅支持多端Typora、Obsidian 都能用⚠️容量有限Gitee 仓库有大小限制图片多了需要清理⚠️不适合大量图片如果是图量大的商用场景建议使用腾讯云 COS