读取你 GitHub 上的公开数据,渲染成多种复古风格的个人主页 + 博客,并且可进行个性化配置。内容不迁移,不建数据库,不买服务器,

前言
我想有个自己的主页和博客,但不想把文章搬到新平台、换图片链接、接评论系统、维护构建和部署。GitHub 上已经有 profile README、公开仓库和一些 Gist,直接拿来当内容源就够了。
ClassyGit 就是这个思路:GitHub 是内容源,站点只是渲染层。内容一直在 GitHub,换一个实例或自建都能继续。

是什么,不是什么
是:读取 GitHub 公开数据的渲染层,提供主页、仓库页、Gist 博客、归档、留言簿和 RSS。
不是:静态博客生成器,不托管内容,不需要构建发布;也不是通用建站工具,不能随便写页面。要完全自定义,Astro / Hexo 更合适。
和 GitHub 自带 profile README 的区别:README 只有一页,ClassyGit 是多页站点,仓库列表、仓库 README、Gist 文章、归档、标签、留言簿都在。
能做什么
- README 直接当主页:保留 Markdown、代码高亮和相对图片;自动生成资料卡、贡献墙、最近仓库、最近 Gist、近况。
- Gist 就是博客:描述写
classy.blog.标题 #标签,自动解析分类、标题、标签;支持多文件、阅读时间、按月归档、标签筛选、搜索、Atom。 - 留言簿:用一条公开 Gist 的评论当留言板,站点只读展示;这条 Gist 必须是你的公开 Gist,删留言直接在 Gist 里删。留言需要 GitHub 账号。
- 复古社区件:网站环(满 3 人出现上一站/随机/下一站)、随机推荐、88×31 徽章。
- 分享件:主题分享卡带二维码、1200×630 OG 图、sitemap。
- 多页:主页、仓库列表、仓库 README、Gist 列表、文章、归档、留言簿、RSS。
怎么个性化配置
- Fork
Dnevend/classy-github,仓库名保持classy-github。 - 打开
https://classygit.dev/setup生成配置,粘到根目录classy.config.json,把owner改成你的 GitHub 用户名。 - 打开
https://classygit.dev/你的用户名,配置最多 5 分钟生效。
不用构建、不用 CI、不用 Cloudflare 账号、不用域名。配置生成器只生成 JSON,不请求 GitHub 授权,也不用给 ClassyGit 任何 token。想先看效果,任何公开 GitHub 账号都能直接打开 https://classygit.dev/<用户名>,不用 fork。
技术实现
- Astro SSR 跑在 Cloudflare Workers,服务端直出 HTML,边缘缓存。
- 没有内容数据库;KV 只存网站环、随机推荐、可索引用户,Durable Object 只存访客数。这些丢了也能从 GitHub 重建。
- GitHub GraphQL 限流时回退 REST;配额耗尽时优先返回 24 小时内的旧页面(
x-classy-stale),而不是错误页。 - README、Gist、留言走白名单清洗,
javascript:链接会被丢弃;不存 IP,只有主题和语言两个功能性 cookie。
已知限制
- 只读公开数据,私有仓库和 secret Gist 不显示。
- Gist 最多 100 条;README、仓库、Gist 列表最多缓存 30 分钟。
- 默认
noindex,要搜索引擎收录得设seo.index: true。
和 GitHub Pages / Hexo 的区别
GitHub Pages + Hexo 自由度高,但内容要搬、要构建、要挑主题。ClassyGit 是内容零迁移、配置即数据、多页现成,代价是定制空间小、依赖公共实例和 GitHub API。如果你要的是完全静态、深度定制,前者更合适;如果你只是想让已有的 GitHub 内容有个门面,ClassyGit 更省事。
链接
- 在线体验:https://classygit.dev
- 我的主页:https://classygit.dev/Dnevend
- 源码(MIT):https://github.com/Dnevend/classy-github
功能和边界都还比较早期,如果试了觉得哪里别扭,欢迎在帖子里说,或者直接提 issue,欢迎 Star 支持。
