# VanBlog **Repository Path**: mereith/van-blog ## Basic Information - **Project Name**: VanBlog - **Description**: VanBlog 是一款简洁实用的个人博客系统。支持全自动 HTTPS、黑暗模式、支持移动端自适应和评论、内置流量统计与图床,配有完备的、支持黑暗模式、支持移动端、支持一键上传剪切板图片到图床、带有强大的编辑器的后台管理面板。 - **Primary Language**: TypeScript - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: https://vanblog.mereith.com - **GVP Project**: No ## Statistics - **Stars**: 18 - **Forks**: 8 - **Created**: 2022-08-22 - **Last Updated**: 2025-05-22 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
VanBlog是一款简洁、实用、优雅的个人博客系统,支持全自动按需申请HTTPS证书、黑暗模式、移动端自适应和评论功能。它内置了流量统计和图床,并集成了评论系统。此外,VanBlog还具有无限的可扩展性,提供完备的后台管理面板,支持黑暗模式、移动端、一键上传剪贴板图片到图床,并带有强大的编辑器。
项目主页: vanblog.mereith.com
Demo(后台账号密码均为 demo): blog-demo.mereith.com
## 预览图  ## 特性 - [x] 快到极致的响应速度,Lighthouse 接近满分。 - [x] 独一份的按需全自动 HTTPS,甚至不用填域名。 - [x] 包括完整的前后台和服务端。 - [x] 前台和后台都为响应式设计,完美适配移动端和多尺寸设备。 - [x] 前台和后台都支持黑暗模式,并可自动切换。 - [x] 前台为静态网页(SSG),并支持秒级的增量渲染,每次改动无需重新构建全部页面。 - [x] SEO 和无障碍友好,支持自定义文章路径。 - [x] 静态网页,CDN 友好。 - [x] 版本号展示和更新提醒。 - [x] 基于 React,项目工程化,二次开发友好。 - [x] 内置强大的分析功能,可统计访客等数据。并配有精美看板。 - [x] 内嵌评论系统。 - [x] 强大的 Markdown 编辑器,支持图表和数学公式,一键插入 more 标记,一键剪切板及本地图片上传,支持自定义高亮块语法,支持 Emoji 表情选取。 - [x] TOC、草稿、代码复制、访客数、评论数、分类、标签、搜索、加密、友链、打赏、自定义导航栏。 - [x] 多个布局设置,可自定义页面细节。 - [x] 高度定制化,可添加自定义 CSS、HTML 和 JS 代码。 - [x] 支持自定义页面。 - [x] 可添加具有指定权限的协作者。 - [x] 内置图床,并支持各种 OSS 图床、github 图床(外部图床基于 picgo)等 - [x] 支持上传图片自动添加水印,无论何种图床 - [x] 支持上传图片自动压缩,无论何种图床 - [x] 极致轻量化,没有花里胡哨。页面秒切换、图片懒加载。 - [x] 脚本一键部署,多种部署方式,支持 ARM 平台。 - [x] 支持 GA、百度分析 - [x] 简单易用的后台,支持数据的导出与导入。 - [x] 支持 RSS 订阅 - [x] 完善的 API,完全利用本项目后台和服务端,自己写前端或适配其他页面生成器 - [x] 有较完善的日志记录,后台可直接查看登录日志和 Caddy 日志。 ## 快速上手/部署教程 ### 一键脚本部署 ```bash curl -L https://vanblog.mereith.com/vanblog.sh -o vanblog.sh && chmod +x vanblog.sh && ./vanblog.sh ``` 将来如果需要再次运行脚本,可以运行: ```bash ./vanblog.sh ``` ### 其他部署方式 具体请移步项目文档:[快速上手](https://vanblog.mereith.com/guide/get-started.html) ## 反代 请参考: [反代](https://vanblog.mereith.com/reference/reverse-proxy.html) ## 常见问题 > [备份与迁移](https://vanblog.mereith.com/guide/backup.html) > > [作者 logo 无法加载](https://vanblog.mereith.com/faq/usage.html#图片-作者-logo-加载不出来) > > [http error](https://vanblog.mereith.com/faq/deploy.html#部署后-http-error) > > [docker 镜像拉取慢](https://vanblog.mereith.com/faq/deploy.html#docker-镜像拉取慢) > > [如何外部访问数据库](https://vanblog.mereith.com/faq/deploy.html#如何在外部访问数据库) > > [如何回滚](https://vanblog.mereith.com/faq/update.html#如何回滚) > > [如何升级](https://vanblog.mereith.com/guide/update.html) > > [更新后后台报错||一直加载中](https://vanblog.mereith.com/faq/update.html#升级后后台报错或持续加载) > > [开启了 https 重定向后关不掉](https://vanblog.mereith.com/faq/usage.html#开启了-https-重定向后关不掉) > > [更多常见问题](https://vanblog.mereith.com/faq/) ## 关于更新 此项目会持续更新的,如果没有恶性 bug(有的话看到了会紧急修复),一般每周发一次新版本。 如果遇到了问题,可以先更新试试看。 ## 交流群 - [VanBlog 交流群](https://jq.qq.com/?_wv=1027&k=5NRyK2Sw) ## 说明与文档 请移步项目主页: [https://vanblog.mereith.com](https://vanblog.mereith.com) ## CHANGELOG [CHANGELOG](CHANGELOG.md) ## 开发指南 - [开发指南](https://vanblog.mereith.com/contribution.html) ## 谁在使用 现在可能用的人有一些了吧 - - 如果您想把自己加进来,请提一个 [issue](https://github.com/Mereithhh/van-blog/issues/new/choose),我会尽快添加的。 - [Mereith's Blog](https://www.mereith.com) - [handy 的小窝](https://www.handyzyg.cn) - [GT 的官方博客](https://gt-it.net) - [無糧不聚兵‘s Blog](https://www.wongcw.cn) - [oldmoon](https://oldmoon.top) - [seek.wiki](https://seek.wiki) - [joker's blog](https://jingjianqian.top) - [SnailBlog](https://blog.mldd521.com) - [谷粒 corn.li](https://corn.li) - [BARM Blog](https://blog.ccz.life) - [凌览社](http://www.linglan01.cn) - [Peter's blog](https://niuery.com) - [我本无罪的博客](https://blog.rnaan.com/) - [还是夸张一点](https://blog.ynsites.com/) - [青菜的杂货铺](https://211222.xyz) - [花菜的博客](https://blog.huacai.one) - [智芯物联的空间](https://www.tingshuo.online) - [郭郭的博客](https://blog.warmplace.cn) - [Done](https://www.dong-blog.fun/) - [SpaceX](https://tech.twjblog.top/) - [没想好的个人博客](https://blog.shizhuoran.top/) - [春天运维之旅](https://blog.tenchuntian.cn/) - [编程小客栈](http://mystyouth.com/) - [Newhand](https://newhand.top/) - [Jerome's Blog](https://www.blog-jerome.top/) - [宁骑播客](https://blog.xintianyuehui.cn/) ## TODO - [x] 精简前台 js 体积,优化性能 - [x] 精简打包体积 - [x] 集成 HTTPS 和自动证书申请续期 - [x] 后台增加登录日志 - [x] 内嵌评论系统 - [x] 支持 ARM64 - [x] 支持 mermaid 语法 - [x] 替换编辑器为 bytemd(掘金同款)(老的编辑器有些臃肿,复制偶尔会有格式会错乱的问题) - [x] 导入 md 创建文章/草稿功能 - [x] 标签管理 - [x] 黑暗模式图标样式优化 - [x] 内嵌评论的邮件通知和 webhook - [x] 自定义 css - [x] 添加自定义 script 标签 - [x] 添加自定义 html 代码 - [x] 可添加具有自定义权限的协作者 - [x] 自定义页面 - [x] RSS 订阅 - [x] 自定义高亮块语法支持 - [x] Emoji 表情选择器 - [x] 自定义导航栏 - [x] 后端性能优化一期(减少不必要的查询, ISR 防抖等) - [x] Token 管理 - [x] picgo 插件安装 - [x] 忘记密码 - [x] 分类加密 - [x] 自定义文字路径 - [x] 系统日志查看 - [ ] 快捷分享按钮 - [x] 完善可自定义上传文件的自定义页面功能(现在的自定义页面有潜在的 css 污染问题) - [x] 图片上传自动添加水印 - [x] 迁移到 pnpm,使用 workspace - [x] 增加在特定事件后触发执行自定义代码或 webhook 的扩展能力 - [x] 上传图片自动压缩功能 - [x] 批量操作文章草稿 - [ ] 插件系统 - [ ] 自定义主题(前端渲染器)系统 - [ ] 浏览器消息通知 - [ ] 文章/草稿的历史版本管理 - [ ] 精简配置项,尽可能移动到运行时配置 - [ ] 增加 ORM 层,适配更多数据库 - [ ] 增加一些 e2e 测试,集成到 CI - [ ] 国际化 ## 问题反馈 请提 [issue](https://github.com/Mereithhh/van-blog/issues/new/choose) ,如无特殊情况会在一天内解决。 ## 打赏 如果觉得项目不错的话可以打赏哦。您的支持就是我最大的动力! 打赏时您可以备注名称,我会将您添加至打赏列表中。