vanblog

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（有的話看到了會緊急修復），一般每週發一次新版本。

如果遇到了問題，可以先更新試試看。

交流群

• VanBlog 交流群

說明與文檔

請移步項目主頁： https://vanblog.mereith.com

CHANGELOG

CHANGELOG

開髮指南

• 開髮指南

誰在使用

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

如果您想把自己加進來，請提一個issue，我會盡快添加的。

• Mereith's Blog
• handy 的小窩
• GT 的官方博客
• 無糧不聚兵's Blog
• oldmoon
• seek.wiki
• joker's blog
• SnailBlog
• 穀粒corn.li
• BARM Blog
• 凌覽社
• Peter's blog
• 我本無罪的博客
• 還是誇張一點
• 青菜的雜貨舖
• 花菜的博客
• 智芯物聯的空間
• 郭郭的博客
• Done
• SpaceX
• 沒想好的個人博客
• 春天運維之旅
• 編程小客棧
• Newhand
• Jerome's Blog
• 寧騎播客

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 趨勢圖

LightHouse 截圖

多說一句

很抱歉有段時間斷更了，陸陸續續會慢慢繼續更新的。 2024-09-01