外觀

語言

從 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 + CloudflareNext.jsWordPress(自架)
是什麼以內容為主的網站框架,頁面預設在建置時產生React 全端框架,偏向互動多的 web appPHP 寫的內容管理系統,有後台編輯器
送到瀏覽器的 JavaScript預設不送,只有標記成互動的元件(islands)才載入React 執行環境一定會送看佈景主題和外掛
文章放哪repo 裡的 Markdown/MDX 檔,或接資料庫自己決定:檔案、資料庫或 CMSMySQL/MariaDB 資料庫
主機需要靜態檔案即可;要伺服器功能時跑在 Workers靜態匯出之外需要能跑 Node 或相容環境PHP 8.3 以上、MySQL 8.0 或 MariaDB 10.11 以上
部署到 Cloudflare官方 adapter @astrojs/cloudflareCloudflare 建議 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'。我的登入檢查在升級後讀不到設定值,就是這個原因(commit 75ba367)。
  • Workers Builds 建置時 EMFILE。 Rollup 預設同時開最多 1000 個檔案,Workers Builds 的開檔上限比較低,修好之前最近 7 次 push 有 5 次建置失敗。解法是在 astro.config.mjs 的 vite.build.rollupOptions 加上 maxParallelFileOps: 64(commit 44ec11e),之後再加一個測試防止有人改回去。
  • 頁面請求其實會經過 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 起步成本低、維護項目少,是我目前會推薦新手的組合。

資料來源

  1. 1. Astro Cloudflare adapter · Astro
  2. 2. Install Astro · Astro · 2026-11-07
  3. 3. Workers pricing · Cloudflare · 2026-11-07
  4. 4. Next.js on Cloudflare Workers · Cloudflare · 2026-11-07
  5. 5. next-on-pages(已棄用) · GitHub
  6. 6. Cloudflare Acquires Astro · Business Wire · 2026-01-16
  7. 7. WordPress requirements · WordPress.org · 2026-11-07

關於作者

Kelvin Wang

電機工程師,和 AI Agent 做工具,分享工程與投資的實作筆記。

更多關於我