项目主页: https://vanblog.mereith.com
开源地址: https://github.com/mereithhh/van-blog
Demo 站: https://blog-demo.mereith.com
前因
我大二那年,第一次接触到了个人博客这个东东。看着别人炫酷的个人网站很羡慕,于是第一次买了一台云服务器,在网上到处搜教程,用 hexo
和 next
主题部署了我的第一版博客。
那时候抱着巨大的热情,我折腾了背景,折腾了 live2d
,折腾了鼠标特效,等等。
但用了一阵子觉得有些很不方便。因为 hexo
这类的静态网站生成器本身是没有后台的,所以我必须用自己的方式写 markdown
文件、敲命令行、发布到网上(那时候还不会搞 CI/CD)。
后面我陆续尝试了其他带后台的博客系统,比如 typecho
、wordpress
,后者给我的感觉有些臃肿,前者感觉挺依赖主题的,很多也没有满足我的审美,有些特效加多了还挺卡,而且自带的编辑器和图床也没有很好用。
毕业的时候我用 react
写了一版带前后台的博客,SSR
渲染的博客,但是因为当时没有一个统一的规划,小问题不断,也不支持暗色模式,也没有内置图床,加载速度也并没有很快。
工作后闲暇时间,我又用 gastby
重构了一版博客,加载速度快了很多,但本质上 gastby
也是个静态页面生成器,而且每次发版都要全量构建。
后果
辞职后在家有时间了,我又想折腾一下博客,我的核心要求大概是:
- 最好是静态页面(
SSG
),方便SEO
和CDN
。 - 要带一个方便的后台。
- 要内置图床,支持剪切板上传图片,支持不同的图床。
- 前后台都要支持移动端,都要支持暗色模式且能自动切换。
SSG
的话希望不要每次发版都全量构建。- 不要花里胡哨的特效,首屏加载一定要快。
- 可以
docker
一键部署。 - 支持访客统计和评论。
于是我调研了一番,发现现有的没有特别符合要求的,于是干脆自己写了一个,具有以下的特点:
- 快到极致的响应速度,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
,并按照提示初始化即可。具体可以参考 项目文档