从零搭建全自动化极客博客 (Obsidian + Hugo + Vercel)

一、引言:为什么选择这套工作流? 痛点分析: 我之前使用的是wordpress + WampServer + 阿里云创建的网站,这个流程最大的缺点就是在编辑笔记时需要去wordpress后台,后台不仅慢,编辑起来还费劲,虽然也可以在Obsidian中配合wordpress插件,但总还是感觉wordpress臃肿,不仅如此,服务器使用的是轻量级的,只有2M的带宽,访问很慢,而且域名备案流程繁琐且缓慢。接下来我介绍的流程可以免费托管,只需要为域名付费即可,而且域名无需在国内备案。 我的终极解法: 一套本地丝滑写作、云端自动构建、且几乎零成本的现代化技术博客方案。 核心技术栈预览: Obsidian (本地编辑) + PicGo (图床管理) + Hugo (静态生成) + GitHub (版本控制) + Vercel (全球部署)。 二、 构建本地终极写作环境 (Obsidian 篇) 1. 认识 Obsidian 为什么它是技术笔记的神器(Markdown 原生、双链、极速响应),在遇到Obsidian之前我使用的是有道云和xmind,随着笔记内容越来越多有道云启动都要半天,现在还有好多广告。Obsidian完全本地化管理,数据安全,社区插件生态丰富,可以创建白板,一定程度上可以取代xmind。下载链接:https://obsidian.md/zh/ 2. 图文分离:优雅的图片管理方案 (PicGo) (1)、本地图片的痛点(分享不便、打包体积大)。技术笔记里面通常有很多图片,当积累一定规模时,无论时分享还是传到Github上进行云端备份都是一个棘手的问题。如果将笔记部署到网站里,那么图片多的时候往往加载很慢,对服务器带宽是一个极大的考验。所以图文分离是一个很有必要的步骤。 (2)、配置阿里云OSS对象存储。关于OSS不细述,只讲几个关键点。首先是关于AccessKey的,点击头像找到“权限与安全->AccessKey”,我这里使用RAM用户AccessKey,如图1所示。然后根据配置执行生成即可,保存好你的AccessID和Key,只显示一次。然后进入对象存储OSS控制页面,先创建一个bucket,点击创建的bucket,找到权限控制->阻止公共访问,点击关闭,如图2所示。在同一个页面,找到读写权限,将“Bucket ACL"设置为公共读。不然当你将图片链接放入笔记中时并不会正常显示图片。OSS有桌面版可视化管理工具,也可以下载使用。 (3)、配置 PicGo 图床方案(搭配阿里云 OSS 云存储)。首先安装PicGo,Github下载链接:https://github.com/Molunerfinn/PicGo/releases。我下载的是2.5.2版本。如图2-2-2-1所示,我使用的是阿里云的OSS作为图床,填入相关配置后,保存即可。关于 (4)、在 Obsidian 中实现“复制粘贴,自动上传并返回图床链接”的丝滑体验。这一步可以实现在Obsidian笔记中直接粘贴图片(配合Snipaste截图软件更方便,F1直接截图,Ctrl + V直接复制),自动将图片传到图床,并返回图床的链接。在Obsidian中下载一个叫“Image auto upload”的第三方插件,启用插件后,进入插件设置,设置PicGOServer 上传接口:http://127.0.0.1:36677/upload,一般默认就是这个值,端口号和PicGo中设置的保持一致,如下图所示。 3. 云端托管与版本控制 (Obsidian Git) 安装与配置 Obsidian Git 插件。 (1)、即使不准备搭建个人博客,只要你有记录笔记的习惯,这一部分对你也有很多帮助。Obsidian自带有云端同步功能,而且是端到端加密的,但是需要付费。另一个方案就是将Obsidian仓库上传到Github,这样可以实现在不同的工作地点对同一篇笔记进行无缝编辑。 (2)、首先创建一个Github仓库,然后将仓库克隆到本地,这一步可以参考笔记“Github配合Sourcetree管理UE4工程”(牵扯到SSH密钥)。在Obsidian中点击仓库管理,选择打开本地仓库,将刚才克隆的本地到仓库作为Obsidian的工作空间。在.gitignore文件中可以设置忽略的文件。 (3)、在Obsidian中下载Git第三方插件,启用后会在右侧出现Git操作面板,如图所示。常用的流程如下,当修改文件后,点击加号(Stage All)暂存所有,然后在输入框(默认Update Bolg:)输入当前修改的内容,接着点击对号(Commit)提交,最后点击上传按钮(push)推送到GitHub仓库。如果是比较小的修改,可以直接点击第一个向上的箭头(Commit-And-Sync)一键提交和推送。 总结 到这里已经实现了Obsidian + Picgo + Github的笔记托管方案。如果不考虑创建个人博客的话,这套流程用来写笔记也是非常舒服的,数据同步,免费托管,图文分离。...

四月 23, 2026 · Imrcao