evend

不用构建和服务器,把 GitHub 变成复古主题个人主页

  •  1
     
  •   evend · 7h 23m ago · 492 views

    读取你 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。

    怎么个性化配置

    1. Fork Dnevend/classy-github,仓库名保持 classy-github。
    2. 打开 https://classygit.dev/setup 生成配置,粘到根目录 classy.config.json,把 owner 改成你的 GitHub 用户名。
    3. 打开 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 更省事。

    链接

    功能和边界都还比较早期,如果试了觉得哪里别扭,欢迎在帖子里说,或者直接提 issue,欢迎 Star 支持。

    5 replies  •  2026-11-18 17:48:13 +08:00
    zziheng
    zziheng
    7h 13m ago❤️1
    1
    蛮有意思的项目。
    2460392754
    2460392754
    7h 11m ago❤️1
    2
    不错不错,有创意
    zziheng
    zziheng
    7h 6m ago
    3
    @zziheng classy.config.json 里改 owner 之后,“最多 5 分钟生效”是靠轮询仓库 raw 文件吗?如果我 fork 时把仓库改名(不叫 classy-github),是报错还是静默不生效?

    另外想确认自建这条路:fork 到自己 CF 账号,Workers 免费额度 + Durable Object 存访客数,会不会撞到免费计划的限制?
    SamRol
    SamRol
    6h 30m ago❤️1
    4
    挺有意思,很喜欢这种复古风格
    evend
    evend
    OP
    5h 48m ago
    5
    @zziheng
    不是轮询,是按需读取 + 边缘缓存 5 分钟;
    fork 改名:静默不生效,不报错;
    Durable Object 本身在免费计划里能用,访客计数很难把它跑满;
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1951 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 235ms · UTC 15:36 · PVG 23:36 · LAX 07:36 · JFK 10:36
    ♥ Do have faith in what you're doing.