进阶篇:Obsidian 个人网站搭建方式怎么选
帮助您选择 Obsidian 个人知识网站搭建方式:最省心可以走插件发布,需要历史记录可以开启 Git 备份,需要深度改造可以进入源码定制。
文章目录11 个章节
搭建 Obsidian 个人知识网站,不需要所有人都走同一条路。
如果只是想低成本发布自己的技术博客、科研笔记或项目复盘,默认可以选择插件发布;如果需要版本历史,再加 Git;如果您本身就是开发者,再进入源码二开。
有的人只想在 Obsidian 里写文章,然后点一下发布。有的人希望保留 Git 历史,方便回滚和备份。也有程序员希望直接改源码、改主题、接 CI/CD。
所以这篇文章不是再讲一遍插件流程,而是回答一个更实际的问题:
我该选择哪种使用方式?
1. 先选最适合自己的入口
| 使用场景 | 推荐方式 | 需要关心什么 | 不需要先学什么 |
|---|---|---|---|
| 只想省心发布 | 插件发布 | 写作、预览、点击发布 | 源码、Git、Node、Nginx |
| 想保留历史 | 插件发布 + Git 备份 | 版本历史、回滚、远程备份 | 改主题、改构建流程 |
| 想深度改造 | 源码定制 | 主题、Schema、CI/CD、服务端扩展 | 默认流程的限制 |
默认推荐是第一种:插件发布。
它能覆盖大多数日常发布需求。
2. 最省心的方式:Obsidian 插件发布
更理想的入门体验是:
这一层不需要先理解源码。
只需要知道几件事:
- 我的内容保存在 Obsidian
- 服务器上有一个发布服务
- 插件负责把文章、图片和配置发送过去
- 网站会自动更新
这才是最省心的入门路径。
3. 一键安装服务器
可以买一台最便宜的轻量服务器,然后执行一键安装脚本。
脚本负责完成这些事情:
- 安装基础运行环境
- 初始化网站目录
- 配置发布服务
- 配置 Nginx
- 生成访问 Token
- 准备静态站构建流程
不需要手动理解每一步。
安装完成后,服务器只需要返回几项关键信息:
| 配置项 | 用途 |
|---|---|
| 服务器地址 | 插件发布目标 |
| 发布 Token | 防止外部随意写入 |
| 站点域名 | 公开访问地址 |
| 管理入口 | 查看发布状态和日志 |
这样就可以回到 Obsidian,而不是继续在服务器里折腾。
4. Obsidian 是唯一主入口
例如:
- 新建文章
- 填写标题、标签、系列
- 插入图片和附件
- 点击发布并自动检查
- 查看发布结果
插件的价值不是“上传文件”这么简单,而是把写作、检查、同步和发布变成一个连续流程。
我还是在 Obsidian 写 Markdown,只是多了一个可以发布成个人网站的按钮。
5. 进阶方式:增加 Git 备份和版本管理
如果希望保留完整历史,可以开启 Git。
例如:
- 文章改动可以追溯
- 误删内容可以恢复
- 多台设备之间可以同步
- 想把内容额外备份到远程仓库
这时可以开启 Git 模式。
但 Git 不适合作为必需条件。
发布系统正常工作不依赖 Git;如果想要版本管理,再集成 Git。
这样即使不配置远程仓库,网站也能正常发布。
如果配置了 Git,远程仓库承担的是备份、版本历史和协作能力,而不是普通发布链路的前置条件。
6. 远程仓库不绑定主流程
很多开源静态站方案会默认要求先准备一个仓库。
这对程序员很自然,但对只想写作和发布的人来说会偏重。
因为一上来就会遇到这些问题:
- 什么是仓库
- 什么是 SSH Key
- 什么是分支
- 为什么要提交
- 为什么发布失败和 Git 有关
这些问题会把“写东西并发布”变成“先学习一套工程工具链”。
所以远程仓库更适合作为第二层能力,而不是第一层门槛。
7. 第三种方式:源码定制
程序员、独立开发者和开源贡献者通常会需要更大的自由度。
这一层可以开放源码和工程能力:
- 自定义 Astro 主题
- 修改内容 Schema
- 接入自己的 CI/CD
- 改造构建流程
- 自定义 Nginx 和部署方式
- 接对象存储或 CDN
- 扩展私有 Hub 和 API
- 适配 Hugo、MkDocs 或其它发布前端
源码开源的价值在于信任、透明和可扩展。
但源码不适合作为默认入口。
更准确地说:
省心发布走插件,需要历史加 Git,深度改造再研究源码。
8. 三种使用场景,对应三种入口
| 使用场景 | 主要入口 | 适合能力 | 不需要强制要求 |
|---|---|---|---|
| 省心发布 | Obsidian 插件 | 写作、预览、一键发布 | 源码、Git、Node、Nginx |
| 版本备份 | 插件 + Git | 版本历史、远程备份、回滚 | 自己改构建系统 |
| 深度定制 | 源码仓库 | 二开、主题定制、CI/CD | 只能使用默认流程 |
这三个入口同时存在,使用方式就不会被锁死在某一条路上。
9. 为什么这种分层重要
这套个人知识网站适合程序员、科研人员、研究生、博士生、工程师和独立创作者。
真正需要的是:
- 内容长期保存
- 写作入口顺手
- 发布过程简单
- 网站稳定可访问
- 后续可以迁移
不是每个人都想研究部署。
也不是每个人都想把知识资产放进某个平台。
复杂的部分可以交给工具处理,同时保留继续深入定制的空间。
10. 最后会形成什么样的工作流
最省心的工作流是:
这不是单纯做一个博客模板。
它更像是一套从本地写作到公网发布的个人知识资产工作流。
11. 一句话总结
这套工作流可以这样理解:
默认通过 Obsidian 插件和一键安装脚本完成发布;需要版本历史再开启 Git;需要深度改造再进入源码层。
这样既能降低入门成本,也能保留开源系统的自由度。
不懂源码也可以使用;开发者也不会因为默认流程简单而失去扩展空间。