因为选择艰难症,自己写了一套开源博客系统

2年前 (2022) 程序员胖胖胖虎阿
245 0 0

项目主页: https://vanblog.mereith.com

开源地址: https://github.com/mereithhh/van-blog

Demo 站: https://blog-demo.mereith.com

因为选择艰难症,自己写了一套开源博客系统

前因

我大二那年,第一次接触到了个人博客这个东东。看着别人炫酷的个人网站很羡慕,于是第一次买了一台云服务器,在网上到处搜教程,用 hexonext 主题部署了我的第一版博客。

那时候抱着巨大的热情,我折腾了背景,折腾了 live2d,折腾了鼠标特效,等等。

但用了一阵子觉得有些很不方便。因为 hexo 这类的静态网站生成器本身是没有后台的,所以我必须用自己的方式写 markdown 文件、敲命令行、发布到网上(那时候还不会搞 CI/CD)。

后面我陆续尝试了其他带后台的博客系统,比如 typechowordpress ,后者给我的感觉有些臃肿,前者感觉挺依赖主题的,很多也没有满足我的审美,有些特效加多了还挺卡,而且自带的编辑器和图床也没有很好用。

毕业的时候我用 react 写了一版带前后台的博客,SSR 渲染的博客,但是因为当时没有一个统一的规划,小问题不断,也不支持暗色模式,也没有内置图床,加载速度也并没有很快。

工作后闲暇时间,我又用 gastby 重构了一版博客,加载速度快了很多,但本质上 gastby 也是个静态页面生成器,而且每次发版都要全量构建。

后果

辞职后在家有时间了,我又想折腾一下博客,我的核心要求大概是:

  1. 最好是静态页面(SSG),方便 SEOCDN
  2. 要带一个方便的后台。
  3. 要内置图床,支持剪切板上传图片,支持不同的图床。
  4. 前后台都要支持移动端,都要支持暗色模式且能自动切换。
  5. SSG 的话希望不要每次发版都全量构建。
  6. 不要花里胡哨的特效,首屏加载一定要快。
  7. 可以 docker 一键部署。
  8. 支持访客统计和评论。

于是我调研了一番,发现现有的没有特别符合要求的,于是干脆自己写了一个,具有以下的特点:

  • 快到极致的响应速度,Lighthouse 接近满分。
  • 独一份的按需全自动 HTTPS,甚至不用填域名。
  • 包括完整的前后台和服务端。
  • 前台和后台都为响应式设计,完美适配移动端和多尺寸设备。
  • 前台和后台都支持黑暗模式,并可自动切换。
  • 前台为静态网页(SSG),并支持秒级的增量渲染,每次改动无需重新构建全部页面。
  • 静态网页,CDN 友好。
  • 基于 React,项目工程化,二次开发友好。
  • SEO 和无障碍友好。
  • 版本号展示和更新提醒。
  • 内置强大的分析功能,可统计访客等数据。并配有精美看板。
  • 内嵌评论系统。
  • 强大的 markdown 编辑器,支持图表和数学公式,一键插入 more 标记,一键剪切板及本地图片上传
  • TOC、草稿、代码复制、访客数、评论数、分类、标签、搜索、加密、友链、打赏、自定义导航栏。
  • 多个布局设置,可自定义页面细节。
  • 内置图床,并支持各种 OSS 图床、github 图床(外部图床基于 picgo)等。
  • 极致轻量化,没有花里胡哨。页面秒切换、图片懒加载。
  • docker 一键部署,支持 ARM
  • 支持 GA、百度分析
  • 简单易用的后台,支持数据的导出与导入。
  • 完善的 API,完全利用本项目后台和服务端,自己写前端或适配其他页面生成器
  • 有较完善的日志记录,后台可直接查看登录日志和 Caddy 日志。

我把它命名为 VanBlog,有兴趣的话可以试一下哦。

项目主页:https://vanblog.mereith.com

开源地址:https://github.com/mereithhh/van-blog

Demo 站: https://blog-demo.mereith.com

部署

可以用 docker-compose 一键部署,新建 docker-compose.yml 文件:

version: "3"

services:
  vanblog:
    image: mereith/van-blog:latest
    restart: always
    environment:
      TZ: "Asia/Shanghai"
      # 图片资源允许的域名,英文逗号分隔。作者 logo 加载不出来请检查此项。
      VAN_BLOG_ALLOW_DOMAINS: "www.mereith.com"
      # CDN URL,包含协议,部署到 cdn 的时候用。在开启 cdn 之前请不要设置此项。
      # VAN_BLOG_CDN_URL: "https://www.mereith.com"
      # mongodb 的地址
      VAN_BLOG_DATABASE_URL: "mongodb://vanBlog:vanBlog@mongo:27017"
      # jwt 密钥,随机字符串即可
      VAN_BLOG_JWT_SECRET: "AnyString"
      # 邮箱地址,用于自动申请 https 证书
      EMAIL: "someone@mereith.com"
      # 内嵌评论系统的 db 名,默认为 waline
      VAN_BLOG_WALINE_DB: "waline"
    volumes:
      # 图床文件的存放地址,按需修改。
      - ${PWD}/data/static:/app/static
      # 日志文件
      - ${PWD}/log:/var/log
      # caddy 配置存储
      - ${PWD}/caddy/config:/root/.config/caddy
      # caddy 证书存储
      - ${PWD}/caddy/data:/root/.local/share/caddy
    ports:
      - 80:80
      - 443:443
  mongo:
    image: mongo
    restart: always
    environment:
      TZ: "Asia/Shanghai"
      # 如果你改了这两个,那上面的数据库连接地址也要同步修改。
      MONGO_INITDB_ROOT_USERNAME: vanBlog
      MONGO_INITDB_ROOT_PASSWORD: vanBlog
    volumes:
      - ${PWD}/data/mongo:/data/db

按注释说明修改docker-compose.yml的配置后:

docker-compose up -d

浏览器打开 http://<your-ip>/admin/init ,并按照提示初始化即可。具体可以参考 项目文档

因为选择艰难症,自己写了一套开源博客系统

预览图

因为选择艰难症,自己写了一套开源博客系统

因为选择艰难症,自己写了一套开源博客系统

因为选择艰难症,自己写了一套开源博客系统

因为选择艰难症,自己写了一套开源博客系统

因为选择艰难症,自己写了一套开源博客系统

相关文章

暂无评论

暂无评论...