從 0 建設個人網站
個人網站技術架構怎麼選:為什麼用 Astro + Cloudflare,不用 Next.js 或 WordPress
以文章和作品為主的個人網站,我選 Astro 當框架、Cloudflare Workers 部署:頁面先建成靜態檔,免費方案就夠用,需要登入或後台時再接伺服器端功能。附 Astro、Next.js、WordPress 比較表和實際設定檔。
Kelvin Wang · · 7 分鐘閱讀
個人網站如果主要放文章、作品和自我介紹,我建議用 Astro 當框架、Cloudflare 部署。Astro 會在建置時把頁面做成靜態 HTML,預設不送 JavaScript 到瀏覽器,網站快、主機需求低;Cloudflare 的免費方案個人網站很難用完,直接回傳靜態檔案的請求免費、不限量。之後要加登入、後台這類需要伺服器的功能,同一個 Astro 專案透過官方的 Cloudflare adapter 就能做,不用換框架。我自己的網站 kelvinwang.info 就是這套,2026 年 6 月 10 日第一個 commit 是「scaffold Astro project with Cloudflare and React adapters」,到現在跑了五個月。
選框架之前要先知道一件事:架構可以分成兩層。框架決定網站怎麼建出來(寫什麼語法、怎麼產生頁面),部署平台決定建好的網站放在哪裡、誰來回應訪客的請求。Astro 負責前者,Cloudflare 負責後者。兩層分開看,比較時才不會把「Next.js 好不好」和「Vercel 貴不貴」混在一起。
三種做法比一比
個人網站最常被拿來比的三種做法是 Astro、Next.js、WordPress,三者的定位和主機需求差很多。
| 項目 | Astro + Cloudflare | Next.js | WordPress(自架) |
|---|---|---|---|
| 是什麼 | 以內容為主的網站框架,頁面預設在建置時產生 | React 全端框架,偏向互動多的 web app | PHP 寫的內容管理系統,有後台編輯器 |
| 送到瀏覽器的 JavaScript | 預設不送,只有標記成互動的元件(islands)才載入 | React 執行環境一定會送 | 看佈景主題和外掛 |
| 文章放哪 | repo 裡的 Markdown/MDX 檔,或接資料庫 | 自己決定:檔案、資料庫或 CMS | MySQL/MariaDB 資料庫 |
| 主機需要 | 靜態檔案即可;要伺服器功能時跑在 Workers | 靜態匯出之外需要能跑 Node 或相容環境 | PHP 8.3 以上、MySQL 8.0 或 MariaDB 10.11 以上 |
| 部署到 Cloudflare | 官方 adapter @astrojs/cloudflare | Cloudflare 建議 vinext(beta),既有專案可用 OpenNext | 不能跑在 Workers,要另外租主機 |
| 要自己維護的 | 套件升級 | 套件升級,加上 adapter 跟不跟得上新版 | WordPress 核心、佈景、外掛更新與資安修補 |
| 適合誰 | 文章、作品集、個人品牌網站 | 需要大量互動或已經會 React 的人 | 想用後台點選編輯、不想碰程式的人 |
主機需求來源:WordPress 官方建議 [7];Next.js 在 Cloudflare 的做法:Cloudflare 文件 [4](2026-11-07 查詢)。
如果你還在猶豫要不要自己寫程式,或想把 Wix、Google 協作平台這類架站平台也放進來比,先看架站平台比較那篇再回來。
想深入 架站平台怎麼選:Wix、WordPress、Google 協作平台,還是用 AI 自己寫 不寫程式也能架站的選項,依需求和預算比較。為什麼框架選 Astro?
我以前的網站用 Next.js。2023 年還沒用 AI 輔助寫程式時,為了用新功能,把專案從 Next.js 13 升到 14。部署到 Cloudflare Pages 要靠一個叫 @cloudflare/next-on-pages 的轉接工具,它當時還不支援新版,升級就卡住了。這個工具後來標示棄用,儲存庫在 2026 年 10 月封存。最後升級花了不少力氣,部署方式也得跟著重做。時間一久,部署、merge、CI/CD 輪流出問題,我得到的教訓是:框架選錯,整個系統都會被拖累。
所以這次(第四個網站)我先看框架和部署平台怎麼配合,再看寫起來順不順手。Astro 有官方維護的 Cloudflare adapter,需要伺服器端執行的功能,adapter 會把它接到 Cloudflare 的執行環境。2026 年 1 月 16 日 Cloudflare 收購了 Astro 背後的公司,Astro 維持 MIT 授權開源,也說會繼續支援 Cloudflare 以外的部署平台。
Astro 對個人網站還有兩個實際好處:
- 文章就是檔案。 文章用 Markdown 或 MDX 寫,放在 repo 裡,跟程式碼一起進版本控制。AI 寫程式工具可以直接讀寫這些檔案。
- 需要互動的地方才載入 JavaScript。 我的首頁有兩個 React 元件(作品區和身分切換),用 islands 只在那兩塊載入 React,文章頁維持純 HTML。
為什麼部署選 Cloudflare?
我前幾個網站就放在 Cloudflare,當初選它是成本加技術考量,到這個網站還是一樣划算。免費方案(Workers Free)的額度:
- 每天 100,000 次 Worker 請求,每次 10 毫秒 CPU 時間
- 直接回傳靜態檔案(assets)的請求免費、不限量
- Workers Logs 每天 200,000 筆事件,保留 3 天
個人網站多數頁面是建置好的靜態檔,200k 的事件量個人用很難碰到。這個網站目前還在免費方案,Cloudflare 每月付 US$0;需要更多時,付費方案每個帳號每月最低 US$5。
另一個理由是熟悉。前面幾個網站累積的部署經驗可以直接沿用,開發和部署流程接好之後,每次改完程式推到 GitHub,網站就自動更新。
這套架構實際長什麼樣?
以 kelvinwang.info 的實際設定為例(只留跟架構有關的幾行),照抄前要先懂每一行在做什麼。
1. 建立專案。 官方指令是 npm create astro@latest,需要 Node.js v22.23.4 以上(官方不支援 23 這類奇數版)。建好之後加上 Cloudflare adapter:
npm create astro@latest my-site
cd my-site
npx astro add cloudflare
2. astro.config.mjs。 我的網站有私人後台(/app),所以預設每頁都在伺服器端執行,公開頁面再個別改回建置時產生:
import { defineConfig } from 'astro/config';
import cloudflare from '@astrojs/cloudflare';
export default defineConfig({
// SSR by default so middleware always runs for /app routes.
// Public pages opt back into prerendering with `export const prerender = true`.
output: 'server',
site: 'https://kelvinwang.info',
adapter: cloudflare({ imageService: 'compile' }),
});
只做文章和作品集的話不用 output: 'server',維持 Astro 預設的靜態輸出就好,設定更少。
3. wrangler.jsonc。 Cloudflare 的設定檔,告訴它建好的檔案在 dist、Worker 程式從哪裡進來:
{
"compatibility_date": "2026-06-10",
"name": "personal-website",
"main": "./src/worker.ts",
"assets": { "directory": "./dist", "binding": "ASSETS" }
}
main 指向我自己寫的 Worker 入口(處理舊網域轉址)。新專案不需要這個檔案:沒有 wrangler.jsonc 時 Astro 會自動產生預設設定,自己建的話 main 填官方文件寫的 @astrojs/cloudflare/entrypoints/server。
4. 自動部署。 2026 年 9 月 29 日起,我的網站 push 到 main 就由 Cloudflare Workers Builds 自動建置上線。手動部署只要一行,第一次用要先執行 npx wrangler login 在瀏覽器登入 Cloudflare 帳號:
npm run build && npx wrangler deploy
想深入 Cloudflare Workers 教學 2026:Astro 部署與 wrangler 設定 從零部署、環境變數、自動部署和失敗排查。
我踩過的坑
這套架構順手,但五個月下來還是有幾個坑,老手可以先記下來:
- Astro 6 拿掉了
Astro.locals.runtime.env。 在 Worker 裡讀環境變數要改用import { env } from 'cloudflare:workers'。我的登入檢查在升級後讀不到設定值,就是這個原因(commit75ba367)。 - Workers Builds 建置時 EMFILE。 Rollup 預設同時開最多 1000 個檔案,Workers Builds 的開檔上限比較低,修好之前最近 7 次 push 有 5 次建置失敗。解法是在
astro.config.mjs的vite.build.rollupOptions加上maxParallelFileOps: 64(commit44ec11e),之後再加一個測試防止有人改回去。 - 頁面請求其實會經過 Worker。 我的
wrangler.jsonc設了run_worker_first,讓頁面請求先進 Worker 處理舊網域轉址,這些請求就算進每天 100,000 次的額度,只有/_astro/這類打包檔直接走靜態檔案。加這種設定前先算一下流量。 - Node 內建模組。 有些 npm 套件會 import Node 內建模組,Cloudflare 的執行環境載入不了。我用
twitter-text時就要把punycode指到 npm 上的同名套件。 - 版本會一直往前。 我的網站現在跑 Astro 6.4.5,2026 年 11 月 7 日 npm 上的最新版已經是 7.4.7。大版本升級前先看官方升級指南,不要讓 AI 一次把所有套件升到最新。
AI 工具用哪一家?
這個網站從第一個 commit 開始就是和 AI 一起寫的。Claude Max x20 和 GPT Pro 我兩個都有訂,買好買滿。架構選擇跟用哪家 AI 沒有綁定:Astro、Cloudflare 的官方文件寫得清楚,哪個 AI 寫程式工具都能照著做。各家工具的差別另外寫一篇中立比較。
想深入 AI 寫程式工具比較 2026:Claude Code、Codex、Grok Build 各適合誰 用同一套標準比較誰適合、怎麼用、價格和限制,不選贏家。什麼時候不適合這套?
- 你完全不想碰程式碼、只想在後台點選編輯:WordPress 或架站平台比較適合。
- 網站本身就是一個互動很重的 app,而且團隊已經熟 React 和 Next.js:繼續用 Next.js,部署平台另外評估。
- 你需要大量現成外掛(電商、會員、多語系翻譯外掛)而不想自己做:WordPress 的生態系比較完整。
除了這幾種情況,以文章和作品為主的個人網站,Astro + Cloudflare 起步成本低、維護項目少,是我目前會推薦新手的組合。
資料來源