[Github] 2025-blog-public – 基于 GitHub App 的开源博客

项目介绍

2025-blog-public 是一个开源博客平台，旨在让用户无需编写代码即可快速创建和管理个人博客内容。它通过 GitHub App 与仓库交互，实现内容编辑、发布和部署，减少自建服务器维护需求，但仍依赖 GitHub、托管平台及其免费额度。项目特别适合非技术背景的博主，强调简单易用，项目采用 MIT 许可证，仓库热度和维护状态应以 GitHub 为准。

项目状态（截至 2026-07-13）：仓库 YYsuni/2025-blog-public 当前约有 1,586 Stars、840 Forks，默认分支为 main，许可证/授权说明为 MIT，最近一次推送日期为 2026-07-03，仓库未归档。数据会持续变化，使用前请查看 README、Releases、提交记录和 LICENSE 原文。

• Github项目地址：https://github.com/YYsuni/2025-blog-public
• 项目Demo预览：https://www.yysuni.com/

核心功能

• 内容编辑与管理：在前端页面点击“编辑”按钮，即可增删改博客文章、图片和配置，使用 GitHub App 的私钥安全操作，支持富文本编辑和批量删除。
• 图片上传：编辑界面点击“+”添加图片（建议压缩至宽度 ≤1200px），然后拖入编辑区插入。
• 首页自定义：通过“配置”按钮修改站点标题、描述等；代码层面可调整首页 Card 组件或删除特定视觉效果（如 LiquidGrass）。
• 全局导航：统一显示自定义 Card 组件，便于跨页面管理。

关键特点

• 托管平台部署：无需服务器，利用 Vercel 一键导入仓库（约 60 秒完成），自动生成域名（如 https://<project>.vercel.app/）。
• 免费开源：基于 GitHub 仓库读写，无额外费用；用户需创建 GitHub App（设置仓库写权限、生成私钥），并配置环境变量（如 APP_ID、OWNER、REPO）。
• 技术栈简洁：前端采用 Next.js 框架，依赖管理用 pnpm；后端依赖 GitHub App，无需 Webhook。
• 灵活扩展：支持代码自定义（如修改 src/app/(home) 目录），但核心设计避免复杂开发。
• 维护友好：不发布正式 Release 或 Package，最新引导文档见 https://www.yysuni.com/blog/readme

为什么选择它？

1. 真正的“无后端”与数据自治

在这个项目中，GitHub 就是你的数据库。 不同于传统的 WordPress 需要服务器和数据库，也不同于 NotionNext 需要依赖 Notion API，2025-blog-public 采用了一种更为极客的方式：所有的文章、配置、甚至评论数据（推测）都直接存储在 GitHub 仓库中。

• 优势：你的数据永远属于你，内容保存在 GitHub 仓库中，便于版本追踪和迁移；站点可用性与成本仍取决于 GitHub、Vercel、域名和流量额度。

2. 前台嵌入式管理入口

项目 README 中透露了一个非常迷人的细节：

“首页有一个不显眼的配置按钮，点击就能看到现在可以配置的内容。”

这意味它抛弃了传统笨重的 /admin 后台，而是采用了所见即所得（WYSIWYG）或前台嵌入式配置的思路。

• 体验：你不需要在代码编辑器和浏览器之间来回切换，直接在网页端点点按钮，即可完成网站标题、关于信息等基础配置。

3. 智能化的 Git-Ops 工作流

观察项目的 Commit 记录，你会发现一个名为 2025-blog-public-app[bot] 的机器人频繁活跃。 这意味着该项目引入了 GitHub App 集成。

• 工作流特点：当你通过网页端（前台）写文章或修改配置时，你不需要手动 git add, git commit, git push。后台的机器人会自动帮你将更改提交到仓库。

• 意义：这让非技术背景的用户，或者想在手机上快速更新博客的开发者，也能享受到 Git 版本控制的红利，而无须触碰复杂的命令行。

4. 部署体验

项目设计之初就考虑到了“开箱即用”。

• 配置：大部分繁琐的配置被封装，用户只需 Fork 仓库，进行简单的 Environment Variables（环境变量）设置，即可触发自动化构建。

• 更新：Bot 的存在意味着系统的自我更新和维护变得异常简单。

适合谁？

• 追求极致掌控欲的开发者：希望每一行文字都存放在 Git 里，且能追溯历史。

• 极简主义者：厌倦了 WordPress 的臃肿和 Notion 的偶尔加载缓慢。

• 内容创作者：需要一个独立、快速、且能随时随地（通过 Web UI）更新的自有领地。

如何开始？

虽然项目名为“2025”，但你现在就可以抢先体验未来：

1. Fork 项目：访问 GitHub地址：https://github.com/YYsuni/2025-blog-public  并 Fork 到你的仓库。

2. 配置环境：在 Settings 中配置必要的 Token（用于 Bot 权限）。

3. 部署：连接 Vercel 或 Netlify，一键上线。

4. 开始写作：点击首页那个“不显眼的按钮”，开始你的创作之旅。

总结

总体而言，这个项目将博客管理从命令行拉回浏览器，结合 GitHub 和 Vercel 的生态，实现高效、免费的静态博客解决方案，特别适合 2025 年追求简约数字生活的创作者。