OneBlog

2026.07.19 2474 字 10 分钟 -- 阅读

最后更新于: 2026-09-03 21:21:22

AI 摘要

OneBlog~一个简约、唯美、丝滑且强大的文档库 + 博客二合一的个人独立博客

版权

次项目是在上游余温大佬开发的 Hugo Teek / RouxZhee 主题能力之上二开的，增加了在线可视化运维后台（基于 PrimeEdge Admin 适配,把后台部署在了eo Makers项目上），使用户可以在浏览器中编辑 Markdown、调整站点配置、上传媒体，而无需在本机安装 Hugo 或手工改 Git。
感谢余温大佬开发的优秀项目❤️❤️❤️（也感谢KOK大佬贡献的基于EO的博客后台）

这里说下关于oneblog项目的迭代历程：

vdoing博客（基于vuepress，Evan大佬开发）-->teek博客（基于vitepress，天客大佬开发）-->RouxZhee博客（基于hugo，余温大佬开发）-->oneblog博客（基于RouxZhee博客二开，one菜鸡二开）。（这一路走来实属不易哈哈哈🤣🤣🤣）

最终效果

按我的手把手文档来做，你将快速拥有一个和我一样丝滑的博客哦。😊😊😊

https://onedayxyy.cn/

首页效果：

在线博客后台：

前言

为什么要做个人独立博客

以下是自己关于为什么要做个人独立博客?的看法：

个人博客，不止是技术的记录，也是生活，更是人生。
让别人拿着我写的文档保准出效果，避免踩坑。
热爱分享、传播、开源。
记录博客的人，多半也是孤独的人吧。
每更新一次博客，就像在精心打理着自己的小庄园。

开发原则

一切以大道至简为原则，拒绝任何形式的花里胡哨;
体验丝滑、性能强悍、功能完整、持续迭代；

适合谁 / 不太适合谁

🟢适合

对拥有独立备案站特别感兴趣；
这个博客是给那些折腾过一些博客（例如csdn、博客园、hexo、wordpress、halo等等），最终想安安静静写博客的人的；
喜欢 Markdown，想把笔记做成「别人能复现」的文档；
喜欢这种集文档库和博客于一身的站点方案的人；
希望有后台，又不想放弃 Git / 静态站可控性；
了解并喜爱 CNB + EdgeOne 这类云原生流水线；
对博客的样式体验、性能体验、优秀架构等有要求且喜欢折腾博客的人；

🟢建议先想清楚

不适合对本博客理念都不感兴趣的人的；
不适合不想折腾博客的人的；
没有备案域名，很多国内 CDN / 边缘能力会受限；
如果只想「三分钟主题博客」、完全不想碰仓库与配置，可能更适合纯托管式产品；
OneBlog 的爽点在于：长期可维护 + 可迁移 + 可扩展，不是「零配置玩具站」。

扩展

做博客这件事，我折腾过很久。

从 VuePress 的 vdoing，到 VitePress 的 Teek，再到 Hugo 的 RouxZhee，一路换引擎、换主题、换部署方式。每一次「看起来更香」，背后都是：本机环境、手工改 Git、改完等构建、构建完再看效果。

OneBlog 就是在这条路上长出来的答案：

前台继续吃 Hugo 静态站的性能与文档型体验；
后台补上「浏览器里就能写稿、改配置、传图」；
内容仍然落在 Markdown / Git 里——可追溯、可备份、不被 CMS 数据库锁死。

一句话：

个人博客不止是技术记录，也是生活，更是人生。用静态知识库，把踩过的坑写成别人能复现的文档。

如果你也想拥有一个「能长期养」的独立站，这篇推文就是给你的。

一、项目简介

OneBlog 是一款简约、唯美、丝滑且强大的文档库 + 博客二合一站点方案。

它在上游 Hugo Teek / RouxZhee 主题能力之上二次开发，并接入基于 EdgeOne 的可视化运维后台（致谢 KOK / PrimeEdge Admin 相关能力），让你可以：

在浏览器中编辑 Markdown；
调整站点配置与菜单；
上传媒体资源；
无需本机安装 Hugo，也不必每次手改 Git。

项	说明
定位	文档型静态博客 + 在线运维后台
前台	Hugo Extended + Hugo Teek 主题
后台	EdgeOne Pages Functions + Vue3 管理端
内容真源	Markdown + TOML，Git 托管（CNB）
发布	CNB CI 构建 → 静态产物 → EdgeOne 边缘分发
Demo	https://onedayxyy.cn/

🟢迭代脉络

1vdoing（VuePress）
2  → Teek（VitePress）
3    → RouxZhee（Hugo）
4      → OneBlog（RouxZhee 二开 + 在线后台）

这一路走来并不轻松，但也正因为踩过坑，才更清楚：什么值得保留，什么必须补上。😊😊😊

二、功能特色

1. 文档库与博客，一套站点搞定

同一套站点里，你可以同时拥有：

专题文档：侧栏导航、体系化知识库；
博客文章流：首页预览、归档、分类标签；
朋友圈 / 说说：轻量动态，和生活记录分开存放。

不是「只能写长文」或「只能写笔记」，而是按内容形态各归其位。

2. 真正能用的在线后台

OneBlog 的核心增量，是随时随地可运维：

发布 / 更新文章与文档；
配置站点外观、菜单、模块开关；
管理友链、赞助、封面、公告等；
支持图床上传（OneImg / 七牛等按需接入）；
移动端也有轻量写稿入口。

出差、摸鱼、临时改一句文案——打开后台就行。

3. Markdown 仍是唯一真源

后台再方便，数据也不进「黑盒数据库」。

改动写入 Markdown / 配置文件；
通过 Git 提交并触发构建；
线上跑的是纯静态产物。

这意味着：版本可追溯、仓库可备份、迁移不慌，长期拥有感更强。

4. 阅读体验偏「丝滑」

文档型主题该有的，尽量都给齐：

深色模式与响应式布局；
VitePress 风格容器语法转换；
代码块折叠、复制、移动端横滑体验优化；
FlexSearch 站内全文检索；
文档侧栏 + 专题结构，适合长期维护的技术笔记。

5. 评论与媒体按需接入

评论：Twikoo（自建 / 独立服务均可）；
图床：OneImg 或七牛等对象存储 + CDN；
前台保持静态可缓存，周边能力按需插拔。

6. 提交即构建，构建即上线

本地与 CI 走同一套数据管线，大致包括：

配置合并 → frontmatter / 侧栏 / 索引处理 → VitePress 语法转换 → 文档分析 → 搜索索引 → Hugo 输出静态站。

写完推上去，剩下交给流水线。

7. 开源可克隆，持续迭代

公开仓库可直接克隆部署；作者侧会持续迭代体验与稳定性。
你不是买一个「封装死」的产品，而是拿一套能看懂、能改、能养的工作流。

三、方案架构

1. 分层视角

 1┌─────────────────────────────────────────────────────────┐
 2│  ① 内容仓库（Git / CNB）                                 │
 3│     Markdown 文章 · 说说 · TOML 菜单 / 主题配置           │
 4└───────────────────────────┬─────────────────────────────┘
 5                            │ 后台 Git API / 本地 push
 6┌───────────────────────────▼─────────────────────────────┐
 7│  ② 构建发布（CNB CI）                                    │
 8│     make build-docker → Hugo public                      │
 9│     → 推送公共静态产物仓库（dist）                         │
10└───────────────────────────┬─────────────────────────────┘
11                            │
12        ┌───────────────────┼───────────────────┐
13        ▼                                       ▼
14┌───────────────────┐                 ┌─────────────────────┐
15│ ③ 站点前台         │                 │ ④ 周边能力           │
16│ EdgeOne 边缘分发   │                 │ OneBlog Admin        │
17│ Hugo Teek 渲染     │                 │ JWT + KV 登录态      │
18│ FlexSearch / UI    │                 │ OneImg / 七牛图床    │
19│ onedayxyy.cn       │                 │ Twikoo 评论          │
20└───────────────────┘                 │ oneblogadmin.*       │
21                                      └─────────────────────┘

2. 域名规划示例

角色	示例域名
博客前台	`onedayxyy.cn`
运维后台	`oneblogadmin.onedayxyy.cn`
图床 CDN	`oneimg.onedayxyy.cn`（或自建七牛域名）

3. 数据流一句话

写稿（本机或后台）→ 落入 Git → CI 打成静态站 → CDN 边缘分发；评论与图床走独立服务，前台保持纯静态。

说明：当前推荐链路是「CNB 构建产物 + EdgeOne 边缘分发」。历史上也有 EO + COS 等方案文档，可按自己的存储习惯选择，不必被某一篇旧教程绑死。

四、部署

见详细部署文档。

五、致谢

OneBlog 站在前人肩膀上：

余温 —— Hugo Teek / RouxZhee
天客 —— VitePress Teek
Evan —— VuePress vdoing
KOK —— 基于 EdgeOne 的博客后台思路与实践
W3C–提供了cnb、eo、eo边缘函数等博客部署新架构

感谢开源，也欢迎你 fork、提问题、一起把体验打磨得更丝滑。

关于我

我的博客主旨：

排版美观，语言精炼；
文档即手册，步骤明细，拒绝埋坑，提供源码；
本人实战文档都是亲测成功的，各位小伙伴在实际操作过程中如有什么疑问，可随时联系本人帮您解决问题，让我们一起进步！

🍀 个人网站：https://onedayxyy.cn/

🍀 微信二维码

x2675263825 （舍得）， qq：2675263825。

🍀 微信公众号

《云原生架构师实战》

🍀 csdn

https://blog.csdn.net/weixin_39246554?spm=1010.2135.3001.5421

🍀 知乎

https://www.zhihu.com/people/foryouone

最后

如果你还有疑惑，可以去我的网站查看更多内容或者联系我帮忙查看。

One(opens new window)

如果你有更好的方式，评论区留言告诉我。谢谢！

好了，本次就到这里了，感谢大家阅读，最后祝大家生活快乐，每天都过的有意义哦，我们下期见！

结束。

📡

👤 作者: One

🔗 链接: https://onedayxyy.cn/topics/oneblog

🌐 版权: 本站文章除特别声明外，均采用 CC BY-NC-SA 4.0 协议，转载请注明来自 One Blog！