Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mereithhh/vanblog

一款简洁实用优雅的个人博客系统
https://github.com/mereithhh/vanblog

blog nextjs nodejs typescript

Last synced: 5 days ago
JSON representation

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

Awesome Lists containing this project

README 

        


	





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





  

  

  

  

  

  





	项目主页:   vanblog.mereith.com





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




## 预览图



![前台-白色](/img/合并.png)



## 特性



- [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) ，如无特殊情况会在一天内解决。



## 打赏



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



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





  打赏-微信

  打赏-支付宝




## 捐赠信息



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](https://api.star-history.com/svg?repos=mereithhh/van-blog&type=Date)](https://star-history.com/#mereithhh/van-blog&Date)



## LightHouse 截图



 

  




## 多说一句

> 很抱歉有段时间断更了，陆陆续续会慢慢继续更新的。  2024-09-01