我写了一套博客笔记系统,开源送给所有想自建博客的人

2026-06-30 10:20:12
1
1
1,686
8分钟26秒

B站视频合集: https://www.bilibili.com/video/BV1Rkuw69EyS

一、先看一眼"长什么样"

如果你也曾被这些问题折磨过,这篇文值得你多看 30 秒:

  • 想用 Markdown 写博客,同时也想发布到公众号,结果一到发布就格式乱飞
  • 想用 Markdown 做知识付费内容,要么插件一堆、要么平台抽成高得离谱
  • 想在 Markdown 集成付费视频,发现没有现成的方案

我将这些痛点都解决了,开发出这套博客系统。

它不是又一个「换皮博客」,而是我为自己量身打造的「写作 + 变现」一体化工具——平时它是纯净 Markdown 博客,需要时它就是一套完整知识付费商城。

  • 前台:极简、自带 Markdown 阅读、评论、订阅。
  • 后台:文章、编辑器、媒体、评论、订单、优惠券、会员、卡密、数据看板等。
  • 可选的重磅功能【知识付费】:Markdown 文章直接集成付费阅读、付费下载、付费视频。
  • 作为自己纯净博客:不设置付费选项,它就是一个纯净的 markdown 笔记型博客。

前台页面
前台页面

后台页面
后台页面

付费视频
付费视频

手机端
手机端

✅ 它可以是「极简博客」

  • 前台干净、专注阅读
  • 原生 Markdown 体验,代码、DAX、公式渲染友好
  • 评论、订阅、SEO 一步到位

✅ 它也可以是「知识付费系统」

  • 文章内一键开启:付费阅读 / 付费下载 / 付费视频
  • 会员、卡密、优惠券、订单管理全套自带
  • 视频 HLS 加密播放

一句话总结:不做知识付费,它就是完全免费的纯净博客系统,想做知识付费赚钱,它就是零搭建成本的知识付费商城。

二、这套系统由 3 个项目组成

很多读者只想"直接用起来",但作为项目作者,我有义务先把项目身份讲清楚:

项目 作用 协议 仓库
blog-server 后端服务(Go + Gin) 专有软件 仅镜像分发
blog-client 前端站点(Vue 3 + Vite + Nginx) MIT 开源 GitHub、Gitee
blog-tool 部署工具(Bash) MIT 开源 GitHub、Gitee

三者均由焦棚子独立开发与维护。

对普通博主:您只需要用 blog-tool 把博客部署起来,然后写文章。前后端是怎么实现的,您完全不必关心。

对开发者:前端 + 部署工具源码任您阅读、二开、自研主题;后端以镜像形式提供,作者长期维护。

三、为什么我又造了一个轮子

我的核心需求只有两个:

  1. 平时写博客 纯净的 markdown 写作体验,最开始因为没有一个很好的 DAX 的渲染,纯粹是为了一碟醋,从种小麦开始;
  2. 如果某段内容值得付费,写完能挂上付费,解决在 markdown 中,实现知识付费的问题(付费阅读,付费下载,付费视频)。

笔者之前也是使用 WordPress 也有一些插件,但是已经不能满足需求;其他的一些方案各有各的妥协。

所以我做了这一套:普通用户免费用,只有真正发生交易时才介入收费的知识付费博客系统。

四、它能做的事,远不止"博客"

后台一打开,您会发现这是一套 【内容 + 商城】双系统:

板块 功能
📝 内容 文章、分类、标签、媒体库、单页面、评论、友链
🎬 视频 加密播放(HLS)、付费视频播放器
🎟️ 商城 会员、卡密、订单、优惠券、支付配置
📊 数据 用户趋势、会员增长、订单数据、登录日志
📬 个性化通知 自定义邮件模板,按"定时、注册、登录"触发场景
🔐 权限 角色粒度授权

技术栈一句话:Go + Gin + Vue3 + PostgreSQL + Redis + Elasticsearch(带 IK 中文分词),全部 Docker 化,一条命令部署完。

五、它适合谁

✅ 想拥有自己博客、喜欢 Markdown 记录 —— 付费功能根据需要自行开启,有收益才付费,纯净博客完全免费。

✅ 想做付费阅读、付费视频、卡密、会员系统的独立创作者 —— 知识付费商城零搭建成本

❌ 只想发 5 篇就不更新的人 —— 那您不如直接用公众号。

六、10 分钟快速上线

完整部署教程见 《使用 blog-tool 一键部署博客系统》。速通版就这 2 步:

1、下载部署工具(OSS 国内更快)

curl -fsSL -o blog-tool.sh https://demo.jiaopengzi.com/sh/blog-tool.sh

2、零交互安装

sudo bash blog-tool.sh --auto \
 --domain=example.com \
 --project_name=blog-server \
 --public_ip=1.2.3.4 \
 --cert=/your/path/cert.pem \
 --cert_key=/your/path/cert.key \
 --admin_username=admin \
 --admin_email=admin@example.com \
 --admin_password='Password123'

可以执行 sudo bash blog-tool.sh 使用交互式工具面板。

工具面板
工具面板

七、免费、开源、持续更新

八、配套教程

1、系统准备

2、博客部署和初始化

3、博客后台管理

blogblog