/vanblog

一款简洁实用优雅的个人博客系统

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

VanBlog是一款简洁、实用、优雅的个人博客系统,支持全自动按需申请HTTPS证书、黑暗模式、移动端自适应和评论功能。它内置了流量统计和图床,并集成了评论系统。此外,VanBlog还具有无限的可扩展性,提供完备的后台管理面板,支持黑暗模式、移动端、一键上传剪贴板图片到图床,并带有强大的编辑器。

项目主页: vanblog.mereith.com

Demo(后台账号密码均为 demo): blog-demo.mereith.com

预览图

前台-白色

特性

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

快速上手/部署教程

一键脚本部署

curl -L https://vanblog.mereith.com/vanblog.sh -o vanblog.sh && chmod +x vanblog.sh && ./vanblog.sh

将来如果需要再次运行脚本,可以运行:

./vanblog.sh

其他部署方式

具体请移步项目文档:快速上手

反代

请参考: 反代

常见问题

备份与迁移

作者 logo 无法加载

http error

docker 镜像拉取慢

如何外部访问数据库

如何回滚

如何升级

更新后后台报错||一直加载中

开启了 https 重定向后关不掉

更多常见问题

关于更新

此项目会持续更新的,如果没有恶性 bug(有的话看到了会紧急修复),一般每周发一次新版本。

如果遇到了问题,可以先更新试试看。

交流群

说明与文档

请移步项目主页: https://vanblog.mereith.com

CHANGELOG

CHANGELOG

开发指南

谁在使用

现在可能用的人有一些了吧 - -

如果您想把自己加进来,请提一个 issue,我会尽快添加的。

TODO

  • 精简前台 js 体积,优化性能
  • 精简打包体积
  • 集成 HTTPS 和自动证书申请续期
  • 后台增加登录日志
  • 内嵌评论系统
  • 支持 ARM64
  • 支持 mermaid 语法
  • 替换编辑器为 bytemd(掘金同款)(老的编辑器有些臃肿,复制偶尔会有格式会错乱的问题)
  • 导入 md 创建文章/草稿功能
  • 标签管理
  • 黑暗模式图标样式优化
  • 内嵌评论的邮件通知和 webhook
  • 自定义 css
  • 添加自定义 script 标签
  • 添加自定义 html 代码
  • 可添加具有自定义权限的协作者
  • 自定义页面
  • RSS 订阅
  • 自定义高亮块语法支持
  • Emoji 表情选择器
  • 自定义导航栏
  • 后端性能优化一期(减少不必要的查询, ISR 防抖等)
  • Token 管理
  • picgo 插件安装
  • 忘记密码
  • 分类加密
  • 自定义文字路径
  • 系统日志查看
  • 快捷分享按钮
  • 完善可自定义上传文件的自定义页面功能(现在的自定义页面有潜在的 css 污染问题)
  • 图片上传自动添加水印
  • 迁移到 pnpm,使用 workspace
  • 增加在特定事件后触发执行自定义代码或 webhook 的扩展能力
  • 上传图片自动压缩功能
  • 批量操作文章草稿
  • 插件系统
  • 自定义主题(前端渲染器)系统
  • 浏览器消息通知
  • 文章/草稿的历史版本管理
  • 精简配置项,尽可能移动到运行时配置
  • 增加 ORM 层,适配更多数据库
  • 增加一些 e2e 测试,集成到 CI
  • 国际化

问题反馈

请提 issue ,如无特殊情况会在一天内解决。

打赏

如果觉得项目不错的话可以打赏哦。您的支持就是我最大的动力!

打赏时您可以备注名称,我会将您添加至打赏列表中。

打赏-微信 打赏-支付宝

捐赠信息

PS:如果打赏时请备注捐赠者,如有遗漏请联系我添加(有时候消息多可能会漏掉,十分抱歉)

捐赠者 捐赠金额 捐赠日期
Sirit 6.66 元 2022-09-01
jingcheng 100 元 2022-09-06
mosuzi 100 元 2022-09-08
ym679 20 元 2022-09-08
wangcw 100 元 2022-09-13
ziva 8.80 元 2022-09-15
Velen 50 元 2022-09-18
pcz 50 元 2022-10-19

Star 趋势图

Star History Chart

LightHouse 截图