vanblog

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

项目主页: vanblog.mereith.com

演示(后台账号密码均为 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错误

docker镜像拉取慢

如何外部访问数据库

如何回滚

如何升级

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

开启了https重定向后关不掉

更多常见问题

关于更新

此项目会持续更新，如果没有严重bug（发现后会紧急修复），一般每周发布一次新版本。

如果遇到问题，可以先尝试更新。

交流群

• VanBlog交流群

说明与文档

请访问项目主页： https://vanblog.mereith.com

更新日志

更新日志

开发指南

• 开发指南

谁在使用

现在可能有不少人在使用了。

如果您想将自己加入此列表，请提交一个issue，我会尽快添加。

• Mereith's Blog
• 前端｜面试进阶之道
• 小柴の BLOG
• handy 的小窝
• GT 的官方博客
• 無糧不聚兵's Blog
• oldmoon
• 手艺橙
• 叶继伟 の blog
• seek.wiki
• Kevin2li's Blog
• joker's blog
• SnailBlog
• Ray's Blog
• 阿明的小博客
• 老咸鱼的池塘
• 谷粒 corn.li
• BARM Blog
• 凌览社
• Peter's blog
• 不可视之线
• 我本无罪的博客
• 还是夸张一点
• XiaFan's Vision
• 青菜的杂货铺
• 笑一个吧
• 花菜的博客
• MrBun's Blog
• 智芯物联的空间
• 敲代码的小盆友
• Tim's Life
• 吾・子风
• LinKinHan'Blog
• 郭郭的博客
• 小橘子

待办事项

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

问题反馈

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

打赏

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

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

捐赠信息

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

Star 趋势图

LightHouse 截图