內容不搬家、建置流程整個拿掉:ClassyGit 把 GitHub 帳號直接變成復古風個人網頁
想在網路上有個個人主頁或部落格的人,多半卡在同一關:租伺服器、挑靜態網站生成器、設定 CI,寫完文章還要建置一次。11 月 17 日,開發者 evend 在 V2EX 分享了一個名為 ClassyGit 的開源專案,思路是把這些步驟全部繞過去:你的 GitHub 資料已經在那裡了,直接拿來當網站用就好。
它實際上做了什麼
ClassyGit 讀取一個 GitHub 帳號的四種公開資料:個人檔案的 profile README、公開倉庫、公開 Gist,以及 Gist 留言,把它們渲染成「個人主頁加部落格」的完整頁面。想看效果,把示範網址裡的使用者名稱換成任何公開的 GitHub 帳號就能生成頁面,不必 fork、不必註冊。
視覺上提供四種主題:System 6、8-bit、Windows 98、DOS,全部走老系統介面路線。原始碼以 MIT 授權公開,自建、換網域、改主題都可以。
這裡的關鍵差異在於「內容不搬家」。README 就是主頁,Gist 就是文章,舊內容不必匯入任何新系統。把 Gist 變成文章的方法也簡單:在描述欄寫上特定格式的標題與標籤,分類、標題、標籤就自動齊了。RSS、按月歸檔、閱讀時長、多檔案 Gist、服務端程式碼高亮,這些常見的部落格功能也都具備。
架構上值得注意的三個設計
用一個比喻來說,這套系統像一家不囤貨的商店:貨(內容)一直在供應商(GitHub)的倉庫裡,店面上架多少全看顧客要什麼,店面燒掉了重新開門就恢復原狀。
第一,整個執行環境只有兩個外部依賴。GitHub 提供內容與身分,Cloudflare 提供運算、快取與計數。Astro SSR 跑在 Cloudflare Workers 上,用 KV 儲存網站環境與可索引使用者,Durable Object 存訪客計數。
第二,沒有內容資料庫。作者明言,Cloudflare 端的資料全部遺失也無所謂,內容一直在 GitHub 上,重新訪問一次就能重建整個站。這對維運成本的意義很直接:沒有 VPS、沒有資料庫、沒有物件儲存要照顧。
第三,快取按「主題加語言」分鍵。使用者主頁快取五分鐘、文章快取一小時,系統不會把 NES 主題的頁面發給選了 mac 主題的訪客。四種主題的 CSS 各自獨立打包,看 mac 主題的人不必下載 NES 那 279KB。伺服器直接輸出 HTML,OG 分享圖也跟著當前主題走。
刻意不做的事,比做了的事更能看出定位
專案的取捨清單顯示作者想得很清楚。只讀公開資料,私有倉庫與 secret Gist 不會顯示。不存訪客 IP、沒有分析腳本,只有主題與語言兩個功能性 cookie。
比較少見的是 SEO 處理:使用者頁面預設 noindex。理由是這類工具能對任意帳號即時生成頁面,對搜尋引擎來說等於無限產出的薄內容;想被收錄的使用者得自己打開設定。留言簿直接用 Gist 留言機制,刪留言就去 GitHub 刪,沒有審核後臺,但留言需要 GitHub 帳號。
適合誰,以及一個實際問題
按作者自己的定位,這是給「想要主頁或部落格、但一直不想碰伺服器和建置流程的人,以及喜歡老系統介面的人」。自建流程也壓得很低:fork 倉庫、改一個設定檔裡的 owner 欄位,五分鐘內生效。
不過討論串裡也出現了兩類務實的回饋。一類是品味之爭,有使用者直言對古早介面沒有點擊慾望,也有人懷疑會喜歡這種介面的人有一定年紀;作者的回應是風格如同裝修與摩託車的復古派,是時代的印記。另一類更實際:作者自己補充,目前訪問頁面時可能遇到 GitHub API 暫時限流,團隊正在優化限流方案。這也點出了這類「內容全靠別人 API」架構的先天風險,架構再輕,上遊的流量控制仍是繞不開的變數。
對一般使用者的啟示在於:個人網站的成本重心正在從「伺服器與建置」移向「上遊平臺的 API 額度與內容託管權」。內容放在哪裡、誰能隨時讀取,比選哪套生成器更值得先想清楚。