VanBlog：简洁实用优雅的个人博客系统
VanBlog 是一款开源的简洁、实用、优雅的个人博客系统，包含完整前台、后台与服务端，支持按需全自动 HTTPS 证书申请、黑暗模式、移动端自适应、内嵌评论、内置图床与流量统计，前台为支持秒级增量渲染的静态网页（SSG），可一键脚本部署并支持 ARM 平台。
社区作者 · zZz
它解决什么问题
VanBlog 是一个个人博客系统开源项目，项目主页为 vanblog.mereith.com，演示站为 blog-demo.mereith.com（后台账号密码均为 demo）。
【项目定位】 VanBlog 简洁、实用、优雅，支持全自动按需申请 HTTPS 证书、黑暗模式、移动端自适应和评论功能；内置流量统计和图床，并集成评论系统；同时具备较强的可扩展性，提供完备的后台管理面板，支持一键上传剪贴板图片到图床，并带有强大的编辑器。
【维护方式】 据来源说明，该项目现在由 AI 全自动维护：可复现的代码问题会复现、补测试并开 PR，changelog 与官网文档会同步更新。合并到 master 以及打发布 tag（v* 部署产品、doc* 部署官网）仍由作者完成。演示站和官网会停留在最近一次已打 tag 的版本。项目欢迎继续提 issue 和 PR。
【核心特性】
- 性能：响应速度极快，Lighthouse 接近满分（可见配图 6 的 Lighthouse 截图）；前台为静态网页（SSG）并支持秒级增量渲染，每次改动无需重新构建全部页面；页面秒切换、图片懒加载。
- 部署与安全：独一份的按需全自动 HTTPS，甚至不用填域名；静态网页，CDN 友好；脚本一键部署，多种部署方式，支持 ARM 平台。
- 完整度：包括完整的前后台和服务端；前台和后台均为响应式设计，完美适配移动端和多尺寸设备，且都支持黑暗模式并可自动切换。
- 内容与 SEO：SEO 和无障碍友好，支持自定义文章路径；支持 TOC、草稿、代码复制、访客数、评论数、分类、标签、搜索、加密、友链、打赏、自定义导航栏；支持 RSS 订阅；支持 GA、百度分析。
- 编辑器：强大的 Markdown 编辑器，支持图表和数学公式，一键插入 more 标记，一键剪切板及本地图片上传，支持自定义高亮块语法，支持 Emoji 表情选取。
- 图床：内置图床，并支持各种 OSS 图床、GitHub 图床（外部图床基于 picgo）等；支持上传图片自动添加水印与自动压缩，无论何种图床。
- 定制与协作：多个布局设置，可自定义页面细节；高度定制化，可添加自定义 CSS、HTML 和 JS 代码；支持自定义页面；可添加具有指定权限的协作者。
- 后台与接口：简单易用的后台，支持数据的导出与导入；完善的 API，可完全利用本项目后台和服务端自写前端或适配其他页面生成器；有较完善的日志记录，后台可直接查看登录日志和 Caddy 日志；支持版本号展示和更新提醒。
- 技术栈与二次开发：基于 React，项目工程化，二次开发友好；极致轻量化。
【项目状态与反馈】 来源列出了较长的 TODO 清单（例如精简前台 js 体积与打包体积、批量操作文章草稿、插件系统、自定义主题（前端渲染器）系统、文章/草稿历史版本管理、国际化、增加 e2e 测试并集成到 CI 等），说明部分功能仍在规划或演进中。问题反馈请提 issue，可复现的代码问题会进入 AI 全自动排查和修复流程并开出 PR，「样例提交」仍由作者处理，合并与发版由作者完成。若遇到问题，可以先更新到已发布版本试试看。
【界面与截图】 配图 1 为项目 logo；配图 2 为前台白色主题界面；配图 5 为 Star 趋势图；配图 6 为 Lighthouse 截图。来源还包含打赏用的微信（配图 3）与支付宝（配图 4）收款码，以及一份捐赠信息列表。项目中还列出了一批「谁在使用」的站点（如 Mereith's Blog、GT 的官方博客等）。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
来源给出的部署方式如下，按顺序执行即可。
一、准备环境
- 一台可运行该脚本的服务器（来源说明支持 ARM 平台）。
- 能够访问外网以下载脚本；若文档站不可达，改从 GitHub raw 下载（见第二步的备用命令）。
- 需要具备执行脚本的权限（脚本需要 chmod +x 赋予可执行权限）。
二、一键脚本部署（推荐） 将脚本下载到本地并赋予可执行权限后立即运行：
curl -L https://vanblog.mereith.com/vanblog.sh -o vanblog.sh && chmod +x vanblog.sh && ./vanblog.sh如果文档站不可达，使用 GitHub raw 作为备用下载源，命令为：
curl -L https://raw.githubusercontent.com/Mereithhh/vanblog/master/scripts/vanblog.sh -o vanblog.sh && chmod +x vanblog.sh && ./vanblog.sh将来如果需要再次运行脚本，可以运行：
./vanblog.sh三、其他部署方式 来源未在正文中展开，只说明「具体请移步项目文档：快速上手」。因此其他部署方式的详细步骤需查阅项目主页文档 vanblog.mereith.com。反代配置请参考文档中的「反代」章节。
四、首次运行与访问
- 部署完成后访问博客前台与后台；后台为完备的管理面板，支持黑暗模式与移动端。
- 可参考演示站体验：blog-demo.mereith.com，后台账号密码均为 demo。
五、常见问题（来源列出的 FAQ 条目） 备份与迁移、作者 logo 无法加载、http error、docker 镜像拉取慢、如何外部访问数据库、如何回滚、如何升级、更新后后台报错/一直加载中、开启了 https 重定向后关不掉等。来源提示更多常见问题与详细排查办法请移步文档站。
六、更新说明 来源指出：正式发版仍由作者打 tag（v* 部署产品，doc* 部署官网）；演示站和官网会停留在最近一次已打 tag 的版本，直到作者发版。如果遇到了问题，可以先更新到已发布版本试试看。
