從 0 建設個人網站
Next.js + Vercel 架個人網站教學 2026:從零到上線、費用,跟 Astro + Cloudflare 怎麼選
用 create-next-app 建專案、加 MDX 部落格、部署到 Vercel、綁網域並送 sitemap,附新手常卡的地方,再和 Astro + Cloudflare 比費用與適用情況。
Kelvin Wang · · 16 分鐘閱讀
重點整理
- Vercel Hobby 免費,但只能個人、非商業使用;放廣告、收款或接案代管都要 Pro(每月 US$20)。
- 網域在 Cloudflare 管的話,Vercel 那幾筆記錄要設成 DNS only(灰色雲朵);開代理又把 SSL 設成 Flexible,會無限轉址。
- App Router 沒有內建多語系路由,靜態匯出又不能用 redirects 和 Proxy,做雙語靜態站要先想好語言導向放在哪。
- 內容為主、要省錢、雙語,Astro + Cloudflare 比較順;網站本質是有登入和後台的 React app,Next.js + Vercel 比較順。
我以前的網站用過 Next.js,2023 年從 13 升到 14,部署在 Cloudflare Pages(升級經過寫在〈Next.js 部署到 Cloudflare 2026〉);現在的網站是 Astro 跑在 Cloudflare Workers 上,Vercel 沒有正式用過。
這篇是照 Next.js 和 Vercel 的官方文件整理的,所有數字和設定都在 2026 年 11 月 16 日重新查過;create-next-app 的預設值,是同一天在空資料夾實際跑一次確認的。寫這篇時 Next.js 最新穩定版是 16.4.6(2026-11-09 發佈)22。
- Vercel Hobby 月費,限個人、非商業使用
- US$0
- Vercel Hobby Plan
- Vercel Pro 月費,含 US$20 用量額度
- US$20
- Vercel Pro Plan
- Next.js 要求的最低 Node.js 版本
- 20.9
- Next.js Installation
開始前要準備什麼?
- Node.js 20.9 以上。Next.js 16 的最低需求1。終端機打
node -v確認,太舊就到 nodejs.org 裝 LTS 版。 - Git 和 GitHub 帳號。Vercel 從 GitHub repo 拉程式碼來建置。
- Vercel 帳號。用 GitHub 登入最省事,之後匯入 repo 不用另外授權一次。
- 一個網域(選用)。沒有也能先用 Vercel 給的
vercel.app網址上線。
第一步:用 create-next-app 建專案
npx create-next-app@latest my-site
cd my-site
npm run dev
它會先問要不要用推薦的預設值,選 Yes 就好。預設是 TypeScript、ESLint、Tailwind CSS、App Router、Cache Components,外加一份 AGENTS.md1。想跳過所有問題,可以在指令後面加 --yes。瀏覽器打開 http://localhost:3000,看得到範例頁就成功了。
2026-11-16 用 16.4.6 照預設建出來的專案,package.json 裡是 Next.js 16.4.6、React 19.3.0,next.config.ts 已經開了 cacheComponents: true 和 partialPrefetching: true。網路上很多 2024 年以前的教學還在講 Pages Router、getStaticProps,或用 middleware.ts(16 改名為 proxy.ts),照著做會對不上。
App Router 還是 Pages Router?
新專案用 App Router。create-next-app 預設就是它,官方文件和新功能(metadata、sitemap、多語系範例)也都以 App Router 寫。Pages Router 只在沿用舊專案時才需要。
第二步:加上 MDX 部落格
Next.js 官方的做法是 @next/mdx,文章就是 repo 裡的 .mdx 檔3:
npm install @next/mdx @mdx-js/loader @mdx-js/react @types/mdx
把 create-next-app 產生的 next.config.ts 包一層 withMDX,原本的設定留著:
import type { NextConfig } from 'next'
import createMDX from '@next/mdx'
const nextConfig: NextConfig = {
pageExtensions: ['js', 'jsx', 'md', 'mdx', 'ts', 'tsx'],
// create-next-app 原本產生的設定留在這裡
}
const withMDX = createMDX({})
export default withMDX(nextConfig)
專案根目錄(跟 app 同一層)一定要有 mdx-components.tsx,App Router 少了它 MDX 就不會動3:
import type { MDXComponents } from 'mdx/types'
const components: MDXComponents = {}
export function useMDXComponents(): MDXComponents {
return components
}
文章頁用動態路由載入對應的 .mdx 檔,generateStaticParams 列出所有文章,建置時就會產生成靜態頁:
// app/blog/[slug]/page.tsx
import { notFound } from 'next/navigation'
export const ensureStatic = 'navigation'
export default async function Page({
params,
}: {
params: Promise<{ slug: string }>
}) {
const { slug } = await params
try {
const { default: Post } = await import(`@/content/${slug}.mdx`)
return <Post />
} catch {
notFound()
}
}
export function generateStaticParams() {
return [{ slug: 'hello-world' }]
}
create-next-app 預設開了 Cache Components,舊教學的 dynamicParams = false 會讓建置失敗,不存在的文章改用 notFound() 處理23。Next.js 自己的 MDX 文件範例還留著這一行,照抄一樣會失敗。
ensureStatic = 'navigation' 這一行(16.4 起可用)也別省。少了它,不在 generateStaticParams 清單裡的網址第一次被打開時,Next.js 會先送出頁面外框,狀態碼這時已經定成 200,notFound() 只能再補一個 noindex 標籤31。noindex 會讓這頁不進搜尋結果,但有些爬蟲會把「200 加上找不到頁面」記成軟 404(soft 404),分析和監控工具看狀態碼也會以為頁面正常31。加了 ensureStatic,Next.js 會等整頁產生完才回應30,不存在的文章第一次就回 404。代價是這一頁不能讀 cookies、headers 或沒有快取的資料,不然建置會失敗30;純文章頁本來就用不到。上面這段 2026-11-16 用 16.4.6 建置後,用 next start 實際測過有沒有這一行的狀態碼。
接著在專案根目錄建 content/hello-world.mdx,寫幾行 Markdown,npm run dev 後打開 localhost:3000/blog/hello-world 就看得到。@/ 是 create-next-app 預設設好的路徑別名,指向專案根目錄。之後每加一篇,把它的 slug 加進 generateStaticParams 的清單,建置時才會先產生好。
照上面的程式碼跑 npm run dev,終端機會印出一則 params 在 <Suspense> 外面讀取的提示。這是開發模式才有的效能建議,不會讓建置失敗32,可以先不管。另外,文章標題看起來跟內文一樣大是正常的:Tailwind 會清掉 h1、h2 的預設樣式,官方建議裝 @tailwindcss/typography,在文章外層加 prose class3。
寫部落格時最常卡的兩件事:
@next/mdx預設不讀 frontmatter。文章開頭寫---的標題、日期,不會自動變成資料。官方建議用export const metadata = …寫在 MDX 裡,或另外加 remark-frontmatter、gray-matter 這類套件3。- Turbopack 下的 remark/rehype 外掛要用字串寫名稱,例如
'remark-gfm',選項也只能是可序列化的值3。Next.js 16 起 Turbopack 是預設的打包工具,舊教學先import remarkGfm from 'remark-gfm'再塞進陣列,這樣傳進去的是 JavaScript 函式;官方文件寫,函式沒辦法傳給 Rust 寫的 Turbopack,這種寫法暫時不能用3。
第三步:推上 GitHub、匯入 Vercel
到 GitHub 開一個空的 repo,把專案推上去:
git add -A
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/<你的帳號>/my-site.git
git push -u origin main
接著到 Vercel 後台 Add New → Project,選這個 repo,Import。Vercel 會自己認出是 Next.js,建置指令和輸出資料夾都不用改,按 Deploy 就會拿到一個 專案名.vercel.app 網址。之後每次 push,Vercel 都會自動建置、部署4。
匯入畫面看不到 repo,官方列的原因依序是4:
- 左上角選錯帳號。清單一次只列一個 GitHub 帳號或組織的 repo。
- Vercel 的 GitHub App 沒有這個 repo 的權限。安裝時選了 Only select repositories,之後新建的 repo 就看不到;點 Adjust GitHub App Permissions 把它加進去。
- repo 屬於組織,但組織沒裝 Vercel 的 GitHub App。不是組織 Owner 的話,安裝要求會送給 Owner 審核。
- 你在 repo 上的權限不夠。個人帳號的 repo 只有 Owner 能匯入,協作者不行;組織的 repo 要是組織 Owner,或有 Write 以上權限的成員,Outside Collaborator 不行。
環境變數和預覽部署怎麼設?
環境變數
Project → Settings → Environment Variables。每個變數可以勾三種環境5:
- Production:push 到正式分支(通常是
main)時用。 - Preview:push 到其他分支、開 PR 時用。
- Development:本機開發用,
vercel env pull會把它下載成.env.local。
NEXT_PUBLIC_ 開頭的變數會進到瀏覽器,任何人都看得到,API 金鑰這類機密不要加這個前綴。改了變數沒生效、預覽網址讀到錯的值、NEXT_PUBLIC_ 變數在瀏覽器是 undefined,這幾種狀況的排查順序在部署失敗那篇。
預覽部署
push 到 main 以外的分支,或在 PR 上 push,Vercel 都會產生一個獨立的預覽網址,並在 PR 留言附上連結4。合併前可以先在真的網址上看改動,改壞了也不會影響正式站。Hobby 也有 Vercel Authentication,可以把預覽網址鎖起來,只有登入的人看得到13。
第四步:綁自己的網域
Project → Settings → Domains → Add Existing,輸入網域。之後要到管 DNS 的地方加記錄6:
- 根網域(
example.com)用 A 記錄。 - 子網域(
www.example.com、blog.example.com)用 CNAME。每個專案的 CNAME 值都不一樣,例如d1d4fc829fe7bc7c.vercel-dns-017.com。
值一律抄 Vercel 後台顯示給你的。官方疑難排解寫的是「用你專案顯示的值,不要抄別的專案的記錄」6。網路上舊教學寫的固定 IP 和 CNAME,不一定是你專案現在要的值。加根網域時,Vercel 會建議你一起加 www,再選一個轉址到另一個。
網域在別家買的、DNS 在 Cloudflare
網域買在哪裡都可以,只要在管 DNS 的那一家加上面的記錄。兩種做法:
- DNS 留在原本那家,只加 A/CNAME。這樣其他記錄(例如收信用的 MX)都不用動6。
- 把 nameserver 換成 Vercel 的。換之前要先把原本所有記錄搬過去,包含 MX 和各種驗證用的 TXT,不然信會收不到6。
DNS 放在 Cloudflare 的人,要多注意一件事:
記錄生效、Vercel 驗證通過後,HTTPS 憑證由 Vercel 自動處理,不用自己申請;設定和憑證狀態都在專案的 Domains 頁看6。DNS 改動要一段時間才會生效,剛加完顯示無效不一定是設錯。
想深入 2026 網域怎麼買、DNS 怎麼設:用 Cloudflare 綁網站、設自訂網域信箱轉寄 註冊商怎麼選、nameserver 怎麼換、自訂網域收信。第五步:sitemap、metadata 和 Search Console
Next.js 不會自己產生 sitemap,要在 app/ 加一個 sitemap.ts8:
// app/sitemap.ts
import type { MetadataRoute } from 'next'
export default function sitemap(): MetadataRoute.Sitemap {
return [
{ url: 'https://example.com', lastModified: '2026-11-16' },
{ url: 'https://example.com/blog/hello-world', lastModified: '2026-11-16' },
]
}
部署後打開 /sitemap.xml 確認看得到。lastModified 寫文章的更新日期;寫成 new Date() 的話,每次建置所有網址都會變成「剛更新」。文章多了以後,把清單改成讀 content/ 資料夾自動產生。雙語網站可以在每一筆加 alternates.languages,sitemap 裡就會有 hreflang8。同一套檔案慣例還有 robots.ts、opengraph-image.tsx,每頁的標題和說明用 metadata 或 generateMetadata 輸出。
Search Console 這一段跟框架無關:用網域資源、在 DNS 加 TXT 記錄驗證,再送出 https://你的網域/sitemap.xml。
新手最常卡在哪裡?
| 卡住的地方 | 為什麼 | 怎麼處理 |
|---|---|---|
create-next-app 或 npm run dev 一開始就報錯 | Node.js 太舊,Next.js 16 最低要 20.9 [1] | node -v 確認,裝新的 LTS 版 |
| 照教學寫的程式碼跑不起來 | 教學是 Pages Router 或舊版寫法;15 起 params 是 Promise、16 拿掉同步寫法 [27],middleware.ts 也改名 proxy.ts | 先看教學寫的是哪一版;用官方文件的 App Router 寫法 |
| Vercel 匯入畫面看不到 repo | 選錯帳號、GitHub App 沒有這個 repo 的權限,或你在 repo 上的角色不夠 [4] | 換帳號、Adjust GitHub App Permissions,或請 Owner 調整權限 |
| 本機正常,預覽網址壞掉 | 常見的是環境變數只設在 Production [5] | 把變數也勾到 Preview,重新部署;其他原因照部署失敗排查那篇的順序查 |
| 網域一直轉址打不開 | Cloudflare 開了代理,SSL 又是 Flexible [7] | 改成 DNS only,或 SSL 改 Full (strict) |
| 網域顯示設定無效 | 抄了別人的 A/CNAME 值,或同一個名稱有衝突的記錄 [6] | 照專案 Domains 頁顯示的值重設 |
| 換 nameserver 後收不到信 | MX 記錄沒搬 [6] | 把信箱服務的記錄補回去 |
| 雙語網站不知道怎麼做語言路由 | App Router 沒有內建 i18n 路由 [9] | app/[lang]/ 資料夾加 proxy.ts,或用 next-intl 這類套件 |
加了 output: 'export' 之後 redirects、Proxy、圖片最佳化都失效 | 靜態匯出不支援這些功能 [10] | 轉址交給主機設定;圖片改用 custom loader |
| 有登入的頁面在台灣很慢 | Vercel Functions 預設跑在美東 iad1 [11] | 把 function region 改到香港 hkg1 或東京 hnd1,跟資料庫放同一區 |
做雙語靜態站時,最直覺的做法是用 proxy.ts 依瀏覽器語言把 / 導到 /zh-hant/,但 Proxy 需要伺服器,開了靜態匯出就不能用;next.config 的 redirects 也一樣10。網站放在 Vercel、不開靜態匯出,Proxy 可以照常用;要靜態匯出放到別的主機,語言導向就得交給主機的轉址設定。Astro 在 astro.config 的 i18n 列出語言就能產生各語言路由,但依瀏覽器語言導向一樣需要伺服器:讀訪客偏好語言的 Astro.preferredLocale 只能用在隨請求產生的頁面21。我的網站是中英雙語,這段放在 Worker 入口處理,所以每個頁面請求都會經過 Worker。
用 AI 工具寫 Next.js 要注意什麼?
Claude Code、Cursor、Codex 這類在本機改 repo 的工具,和 v0 這種在瀏覽器裡對話產生網站的工具,都能做出 Next.js 網站、部署到 Vercel。這幾點跟用哪一家無關:
- AI 學到的 Next.js 可能是舊版。Next.js 每個大版本都有破壞性變更,
create-next-app從 16.2 起預設附一份AGENTS.md,要 AI 動手前先讀裝在node_modules/next/dist/docs/裡、跟你的版本對得上的文件;官方部落格直接寫「你的訓練資料過時了,文件才是準的」2。這份檔案不要刪。 - 各家工具讀的說明檔不一樣。Cursor、Codex 直接讀
AGENTS.md28;Claude Code 讀的是CLAUDE.md,Next.js 官方部落格建議在CLAUDE.md寫一行@AGENTS.md把它帶進來2。create-next-app只產生AGENTS.md。 - AI 常常重複開 dev server。16.2 起第二個
next dev會直接報錯,並印出已經在跑的那個的 PID 和網址2,AI 照著處理就好。 - 讓 AI 自己看部署 log。Vercel 有官方的 MCP 伺服器
https://mcp.vercel.com,所有方案都能用,可以查文件、管專案和部署、讀部署 log12。部署失敗時,AI 可以直接讀錯誤,不用你複製貼上。 - v0 是 Vercel 自己的對話式產生工具,可以直接部署到 Vercel、同步到 GitHub。它和 Lovable、Bolt 的費用比較在架站平台那篇。
不管用哪一個,部署前自己看過 diff、看一次預覽網址,再合併到 main。
Next.js + Vercel 要花多少錢?
個人網站會用到的是 Hobby 和 Pro:
- Hobby,US$0。每月含 100 GB 流量、100 萬次 CDN 請求、100 萬次 Function 呼叫、5,000 次圖片轉換13。超過上限不會收錢,但多數情況要等 30 天才能再用13;被暫停時訪客看到
503 DEPLOYMENT_PAUSED,不會自己恢復17。 - Pro,每月 US$20。含 US$20 用量額度(當月沒用完就歸零),加上 Flat Rate CDN 最低一級(新的 Pro 團隊預設開啟29):每月 100 萬次 CDN 請求、1 TB 流量14。官方說偶發的單日尖峰不會讓帳單變多,整個帳期的總用量超過容量,下一期才升級距15。
Hobby 只能用在個人或非商業用途,這是服務條款寫的16;放廣告、向訪客收款、收錢幫人做網站或代管都算商用,界線不清楚時官方建議部署前先問客服17。
想深入 Vercel 免費方案可以商用嗎?2026 Hobby 限制、撞到上限會怎樣 哪些情況算商用、每月額度、超過之後怎麼恢復。一年下來:Hobby US$0,Pro US$240。網域、資料庫另計,各平台爆量時的帳單算法在網站費用那篇。
想深入 架設網站費用 2026:個人網站一年預算多少(網域、主機、AI 工具逐項) Vercel Hobby/Pro、Flat Rate CDN 和一天湧進 50 萬人的帳單試算。Next.js + Vercel 和 Astro + Cloudflare 差在哪?
兩套都能做個人網站,差別在費用的形狀、離台灣多近,和多語系、靜態網站做起來順不順。
Vercel Pro 每月 US$20、Workers Paid 每月最低 US$5,一般個人網站的用量都在內含額度裡。
資料來源:vercel.com、cloudflare.com
| 面向 | Next.js + Vercel | Astro + Cloudflare Workers |
|---|---|---|
| 免費方案能不能商用 | Hobby 限個人、非商業 [16] | 沒有像 Hobby 那樣寫明限非商業;這篇沒有逐條查服務條款,請自行確認 |
| 平常流量的費用 | Hobby US$0;Pro US$20/月 [14] | 靜態檔請求免費、不限量;Free 每天 10 萬次 Worker 請求;Paid 每月最低 US$5 [18] |
| 某天爆紅 | Hobby 超過上限可能整個暫停;Pro 開著 Flat Rate CDN,單日尖峰不改帳單 [13][15] | 靜態頁不經過 Worker,不收流量費 [18];經過 Worker 的頁面(例如用 Worker 做語言導向)Free 每天 10 萬次、超過就失敗,Paid 照用量計費 [24][18] |
| 離台灣多近 | 離台灣近的運算區域有香港 hkg1、大阪 kix1、東京 hnd1;Functions 預設在美東 iad1 [11] | 機房有台北、高雄 [19];Worker 在最近的機房執行 |
| 被綁住的程度 | 框架可攜:16.2 起有公開的 Adapter API [20];綁住你的是 Blob、Analytics 這類平台服務 | Astro 可以輸出純靜態檔;用了 KV、D1 才會綁住 |
| Next.js 支援 | 原生支援,新功能第一天就能用 | Next.js 官方 2026-03 寫 Cloudflare、Netlify 的 adapter 開發中 [20];目前在 Cloudflare 上走 vinext(beta)或 OpenNext [25](見〈Next.js 部署到 Cloudflare〉) |
| 多語系 | App Router 沒有內建 i18n 路由,用 app/[lang]/+proxy.ts 或套件 [9] | astro.config 內建 i18n 路由;依瀏覽器語言導向一樣要伺服器(例如 Worker) [21] |
| 純靜態輸出 | output: 'export' 可以,但 redirects、Proxy、ISR、預設的圖片最佳化、Server Actions 都不能用 [10] | 預設就是建置時產生靜態頁 |
| 開發體驗 | push 就有預覽網址、PR 自動留言;React 生態的元件庫直接用 [4] | Workers Builds 會在 PR 留言回報建置狀態,Worker 有開 Previews 時附上預覽網址 [26];互動元件要用 islands 另外標記 |
Vercel 和 Cloudflare 數字皆為 2026-11-16 查詢的官方文件;Cloudflare 的「不收流量費」指 Workers 本身,不含 Containers。
台灣的實際延遲這篇沒有量。我推測靜態頁兩邊差距不大:兩邊都從 CDN 送出,Vercel 的 PoP 收到請求後轉到最近的 Vercel 區域,由區域處理 TLS11。有登入、後台這類動態頁面時,Vercel 要記得把 function region 改到亞洲,不然每次請求都要繞到美國。
想深入 Next.js 部署到 Cloudflare 2026:next-on-pages 停止維護後,升級該怎麼走 想要 Next.js 但放在 Cloudflare,要走 vinext 或 OpenNext。什麼情況選 Next.js + Vercel、什麼情況選 Astro + Cloudflare?
兩邊都不是另一邊的升級版,要看網站是什麼樣子。
比較適合 Next.js + Vercel:
- 網站本質是一個 app。有登入、會員頁、後台、儀表板,很多互動元件,想直接用 React 生態的元件庫。
- 你或團隊已經熟 React,或先用 v0 做出原型,想接著改。
- 想要零設定的預覽網址和 PR 留言,而且網站有任何商用成分、本來就要付 Pro。
比較適合 Astro + Cloudflare:
- 內容為主。文章、作品集、個人品牌頁,沒有登入或只有一小塊需要伺服器。
- 想讓主機費維持 US$0,又會放廣告或推薦連結。Cloudflare 的免費方案沒有像 Hobby 那樣寫明限非商業(條款請自行確認)。
- 雙語、以靜態頁為主,想讓框架內建的 i18n 產生語言路由;依瀏覽器語言導向的那一小段交給 Worker。
常見問題
Next.js 一定要放在 Vercel 嗎?
不用。Next.js 官方部落格寫,很多 Next.js 網站就是一台跑 next start 的 Node.js 伺服器20;開 output: 'export' 的話,輸出的靜態檔放在任何靜態主機都可以10。要在 Cloudflare、Netlify 上跑完整功能,就靠各家的 adapter20。
已經有 Astro 網站,要不要換成 Next.js?
網站還是以內容為主的話,換框架的成本大多換不到東西。要加的功能是登入、後台這種 app 型的東西時,也可以只在需要的部分用伺服器端功能,不一定要整站換掉。
資料來源
- 1. Installation
- 2. Next.js 16.2: AI Improvements
- 3. How to use markdown and MDX in Next.js
- 4. Deploying GitHub Projects with Vercel
- 5. Environment variables
- 6. Adding & Configuring a Custom Domain
- 7. Using Cloudflare and other reverse proxies with Vercel
- 8. sitemap.xml
- 9. Internationalization
- 10. How to create a static export of your Next.js application
- 11. Global network and regions
- 12. Vercel MCP
- 13. Vercel Hobby Plan
- 14. Vercel Pro Plan
- 15. Flat Rate CDN
- 16. Terms of Service(第 4 條 Hobby Plan)
- 17. Why has my account or deployment been paused?
- 18. Workers pricing
- 19. Cloudflare global network
- 20. Next.js Across Platforms: Adapters, OpenNext, and Our Commitments
- 21. Internationalization (i18n) Routing
- 22. next
- 23. Migrating to Cache Components
- 24. Workers limits
- 25. Next.js on Cloudflare Workers
- 26. Workers Builds GitHub integration
- 27. How to upgrade to version 16
- 28. AGENTS.md
- 29. Flat Rate CDN is now GA for Pro teams
- 30. ensureStatic
- 31. loading.js(Status codes)
- 32. Adopting Partial Prefetching