外觀

語言

從 0 建設個人網站

2026 AI 寫的網站上線後會壞在哪?部署失敗、憑證外洩與資料庫權限

網站上線後最常出事的是部署失敗、金鑰外洩和資料庫權限設錯。附實際事故、檢查指令、平台關站時的搬家順序,和一份維護檢查清單。

Kelvin Wang · · 14 分鐘閱讀

重點整理

  1. 建置失敗時網站會停在舊版本,每次推送後要看建置結果,並確認線上真的是新內容。
  2. 金鑰不進 repo、不進前端;外洩時先到服務商撤銷換新,再找原因。
  3. Supabase 新資料表先開 RLS、寫規則,訪客用不到就收回 anon 權限。
  4. 網域和 DNS 自己管、內容是 repo 裡的檔案、資料庫匯出過一次,主機收掉時才搬得走。

部署失敗時,你以為改好了,線上其實還是舊版;API 金鑰外洩,會被別人拿去刷你的帳單或讀你的資料;資料庫權限設錯,任何人都能讀寫你的資料表,或反過來,功能因為權限太嚴而壞掉。這三件事都不會在畫面上跳出紅色警告,要自己去檢查。這個網站(Astro+Cloudflare Workers+Supabase,用 Claude Code 寫)三種都遇過,每一種都附上實際紀錄和可以照做的檢查方法。

部署失敗:程式推上去了,網站沒有更新

大部分現代架站方式的部署流程是這樣:你把程式碼推到 GitHub,部署平台收到通知,在它的機器上跑一次建置(npm run build),建置成功才把新版本換上線。這個網站用 Cloudflare 的 Workers Builds,推到 main 分支就會自動部署。

問題出在建置失敗時網站不會壞,只會停在上一個版本。推送那一步顯示成功、網站也打得開,所以很容易以為已經上線了。

實際發生過:7 次推送有 5 次沒上線

  • 造成損害
  • 正面進展
  1. 造成損害: 2026-11-05 之前

    最近 7 次推送有 5 次在 Workers Builds 建置失敗

    錯誤訊息是 EMFILE: too many open files。在自己電腦上建置都正常,只有在 Cloudflare 的建置機器上失敗。

  2. 正面進展: 2026-11-05

    找到原因並修好(commit 44ec11e)

    Rollup(Astro 底層用來打包的工具)預設最多同時開 1,000 個檔案,Workers Builds 允許開啟的檔案數比較低。在本機用 ulimit -Hn 512 把上限調低就重現了;把 maxParallelFileOps 設成 64 之後,上限 512 和 256 都能建置成功。

  3. 正面進展: 2026-11-06

    加測試防止有人把設定改回去(commit 30044f1)

    測試讀 astro.config.mjs,這個值不見或大於 128 就失敗。

修正只有一行,加在 astro.config.mjs 的 vite 設定裡:

// astro.config.mjs(節錄)
export default defineConfig({
  vite: {
    // Rollup 預設同時開 1000 個檔案,超過 Workers Builds 的開檔上限會 EMFILE
    build: { rollupOptions: { maxParallelFileOps: 64 } },
  },
});

測試在 tests/build-config.test.ts:

const config = readFileSync(new URL('../astro.config.mjs', import.meta.url), 'utf8');
const m = config.match(/maxParallelFileOps:\s*(\d+)/);
expect(m, 'vite.build.rollupOptions.maxParallelFileOps must stay set').not.toBeNull();
expect(Number(m![1])).toBeLessThanOrEqual(128);

本機建置成功不代表部署成功:建置機器的環境和你的電腦不一樣。

每次推送後怎麼確認真的上線

  1. 看建置結果:Cloudflare 後台 → Workers & Pages → 選你的 Worker → Deployments,看最新一次是成功還是失敗,失敗的點進去看建置紀錄。
  2. 看線上頁面:打開剛改的那一頁,或在終端機用 curl 抓下來,確認新內容真的在上面。這個網站有一個自動測試專門做這件事:去線上的後台程式裡找一個這次版本才有的標記,找到才算部署成功(commit b13f2b9)。
  3. 新版本壞了就先退回:後台的 Deployments 頁面,在想退回的版本右邊點三個點的選單,選 Rollback;或在終端機用 wrangler:
npx wrangler deployments list   # 看最近的部署和版本
npx wrangler rollback           # 退回上一個版本,也可以指定版本 ID

退回有兩個限制:只能退回最近 100 個版本;資料庫、KV 這些連著的資源不會跟著退回,如果新版本改過資料結構,舊程式可能讀不懂新資料1。

想深入 Cloudflare Workers 教學 2026:Astro 部署與 wrangler 設定 從零設定部署,以及建置失敗時怎麼排查。

憑證外洩:金鑰被別人拿走

網站要連資料庫、呼叫 AI 或寄信,都需要一串金鑰(API key、密碼、token)。拿到金鑰的人,就能用你的身分使用那個服務,費用算你的。金鑰外洩通常走三條路:

  1. 寫進程式碼被推上 GitHub。之後就算刪掉檔案,git 歷史裡還找得到。
  2. 放進前端程式。瀏覽器下載的 JavaScript,任何訪客按 F12 都看得到。
  3. 放在部署平台上,平台被駭。這條你自己控制不了,只能縮小損失。

第一條:不要讓金鑰進 repo

把金鑰放在 .env 檔案,並在 .gitignore 裡排除它。這個網站在建立 repo 的第一天(2026-06-10)就加了這條規則,只留一個不含真實值的 .env.example 給人參考:

# 排除所有 .env 檔,只留範例
.env*
!.env.example

用 wrangler 在本機開發時,金鑰也可以放在 .dev.vars,Cloudflare 文件說 .dev.vars 和 .env 都不應該進 git,兩種都要寫進 .gitignore2。正式環境的金鑰用指令存到 Cloudflare,不要寫進 wrangler.jsonc:

npx wrangler secret put SUPABASE_SECRET_KEY

GitHub 也會幫忙擋:每個帳號預設開啟個人層級的 push protection,你要把金鑰推到公開 repository 時會被擋下來;repository 層級的 push protection 則預設關閉,要自己到設定裡打開3。它不保證每一種金鑰都認得出來,不能當成唯一的防線。

第二條:分清楚哪把金鑰可以公開

Supabase 有兩種金鑰,差別非常大4:

  • publishable key(舊名 anon key):可以放在前端、公開也沒關係。它能拿到什麼,完全由資料庫權限(RLS,下一節)決定。
  • secret key(舊名 service_role key):會略過所有 RLS 規則,等於資料庫的萬能鑰匙。只能放在伺服器端。

Supabase 會擋下從瀏覽器送出、帶 secret key 的請求,回傳 401。但外洩的 secret key 仍然可以用其他工具直接呼叫,所以官方建議:先修好外洩的原因,再輪替那把金鑰;並且每個後端元件各用一把,外洩時只需要換那一把。

第三條:假設平台有一天會被打穿

台灣開發者常用的部署平台 Zeabur,2026 年兩個月內發生兩起資安事件,10 月宣布關站,官方把這兩起事件列為原因之一9。8 月第一次,攻擊者從一位使用者部署的 NextChat 漏洞進入,一路拿到 AWS root 金鑰,讀走平台上的專案環境變數7。10 月第二次,攻擊者用了一把 2024 年 1 月建立、沒有設期限也從沒輪替的叢集管理 token(怎麼拿到的,初步報告還沒確認),讀走 3,218,965 筆環境變數和 321,810 個帳號資料8。

你填在部署平台「環境變數」頁面的金鑰,安全程度就等於那個平台。能做的是讓損失變小:

  • 一個專案一把金鑰,能單獨撤銷。
  • AI、雲端這類會燒錢的金鑰,設用量上限和帳單告警。
  • 外洩時,除了換掉那把金鑰,還要換它讀得到的所有東西。
想深入 API key 會被推上 GitHub 嗎?2026 用 AI 做網站的金鑰外洩檢查 上線前查 git 歷史、前端檔案和部署平台,以及外洩後先撤銷再清歷史。

資料庫權限:任何人都能讀寫你的資料表

Supabase 讓網頁直接從瀏覽器讀寫資料庫,帶的是可以公開的 publishable key。擋住陌生人的是 Row Level Security(RLS,列層級安全):每張資料表上的規則,決定誰可以讀、寫哪幾列資料。

權限出錯有兩個方向。

方向一:太鬆,資料被所有人看到

Supabase 文件寫得很直接:放在公開 schema、沒有開 RLS 的資料表,任何有權限的角色都能讀寫;而在現有專案裡,public schema 新建的資料表預設就把權限授予了包含未登入訪客(anon)在內的角色5。也就是說,建了一張表卻忘了開 RLS,知道你專案網址的人就能讀、改、刪裡面的資料。

這個網站遇過兩次:

  • 2026-09-26:新加的幾張後台資料表,migration 裡從沒授權給 anon,建好後卻帶著 anon 的權限,原因是 Supabase 的預設權限。當時 RLS 規則都只開給登入的人,訪客實際讀不到任何一列,但還是另外寫了一個 migration 把 anon 的權限全部收回。
  • 2026-10-24:交易所優惠資料表開放給訪客讀取,暫停的優惠在後台留著舊代碼和連結,但公開 API 也照樣把它們送出去。修法是讓公開規則只回傳啟用中的資料:using (active)(commit 1650aa8)。

方向二:太嚴,功能壞掉

2026-09-28,上傳圖片的功能用了 upsert(有就更新、沒有就新增),但那個儲存 bucket 沒有 SELECT 規則,upsert 被 RLS 擋下來。最後改成每次都用新的檔名上傳、不用 upsert(commit 20e8391)。RLS 擋住請求時,前端常常只看到「沒有資料」或一個不清楚的錯誤,很容易誤以為是程式寫錯。

新增資料表時照這個順序做

-- 1. 開 RLS:開了之後,沒有規則就什麼都讀不到
alter table public.notes enable row level security;

-- 2. 寫規則:只讓登入的人讀寫自己的資料
create policy "own notes" on public.notes
  for all to authenticated
  using ((select auth.uid()) = user_id)
  with check ((select auth.uid()) = user_id);

-- 3. 訪客完全用不到的表,把預設權限收回
revoke all on public.notes from anon;

-- 4. 驗證:應該是 false
select has_table_privilege('anon', 'public.notes', 'select');

using 決定能讀、能改哪些既有的列,with check 決定能寫入什麼樣的新資料,兩個都要寫。

讓 AI 寫資料表時要多看一眼規則本身對不對。這個網站的 CLAUDE.md 裡就寫了一條:後台是多人共用的工作區,新資料表的規則要用工作區成員的判斷,不能寫成 owner_id = auth.uid(),不然其他成員會看不到資料。規則語法正確、但意思錯了,測試不一定抓得到。

Supabase 後台的 Advisors → Security 也會列出沒開 RLS 的公開資料表(0013_rls_disabled_in_public,等級 ERROR)6。新增資料表後打開看一次。

想深入 Supabase RLS 教學:policy 寫法、using 與 with check、怎麼測 規則怎麼寫、怎麼用不同身分測試。

平台收掉或改方向,個人網站要怎麼準備搬家?

前面三種是自己的設定出錯。這一種是你什麼都沒做錯,網站所在的平台卻變了:被收購、不再投資某個產品,或直接關站。這四個例子都有官方公告:

  • 造成損害
  • 警示或服務縮減
  1. 警示或服務縮減: 2023-09-07

    Google Domains 的網域轉給 Squarespace

    帳號轉到 Squarespace Domains([11]);用 Google Domains 當 DNS 的網域,要先換掉 DNS 供應商才能再改紀錄([12])。

  2. 警示或服務縮減: 2025-04-08

    Cloudflare 把新專案導向 Workers

    Cloudflare 宣布 Pages 會繼續支援,但之後的投資、最佳化和新功能都放在 Workers,新專案建議從 Workers 開始([13])。Pages 文件現在也寫著「Start new projects with Workers」([14])。

  3. 造成損害: 2025-07-08

    Glitch 停止專案託管

    Glitch 在 2025-05-22 公告,7 月 8 日關閉專案託管和個人頁面;後台開到 2025 年底,可以下載程式碼、設定把專案網址轉到新地方([10])。

  4. 造成損害: 2026-12-31

    Zeabur 停止所有服務、刪除資料

    Zeabur 在 2026-10-17 公告停止營運:建議 11 月 30 日前搬完;12 月 1 日起共享叢集暫停運行中的服務(可手動恢復來備份),專用伺服器到期就關;12 月 31 日所有服務停止、資料刪除([9][15])。

都有提前公告,但時間不一定長:Glitch 從公告到停止託管只有一個半月。Pages 這種沒有關站,新功能都做在 Workers,影響來得慢,但之後的官方教學也會以 Workers 為主。我以前的網站用 Next.js,其中一個專案部署到 Cloudflare Pages 要靠轉接工具 next-on-pages。我們 2023 年把那個專案從 Next.js 13 升到 14 時,這個工具還不支援新版,部署方式也得一起改。這個工具現在已經標示棄用,repo 在 2026 年 10 月封存。有了這次經驗,這個網站一開始就選 Astro 部署到 Workers。

想深入 Next.js 部署到 Cloudflare 2026:next-on-pages 停止維護後,升級該怎麼走 轉接工具停止維護時,部署要怎麼換。

平時就讓網站可以搬走

  • 網域不要跟主機綁在一起。網域在獨立的註冊商買,帳號、付款方式和續約日自己管。主機收掉時,你只要改 DNS 指向新地方,網址不變;新網站的路徑也維持原樣的話,搜尋排名和別人的連結都還在。路徑有改,就把舊網址用 301 轉到新網址(做法見上線 SEO 檢查清單)。
  • DNS 放在你能自己修改的地方。Google Domains 的例子說明,DNS 被凍結時你連指向新主機都做不到。換主機前先確認自己登得進 DNS 的後台。
  • 內容是 repo 裡的純文字檔。文章用 Markdown/MDX 放在自己的 git repo,換任何平台都能直接帶走。這個網站的文章原本存在 Supabase 的資料表裡,2026-11-05 全部改成 repo 裡的檔案,現在搬家不用另外匯出文章。
  • 知道自己用了哪些平台專屬功能。平台的表單、圖片處理、排程、KV、邊緣函式,換平台時都要找替代品。不一定要避開,但要列出來,搬家時才不會漏。
  • 環境變數有一份清單。只記名稱和用途,值放在密碼管理工具,不寫進 repo。平台關掉時,後台的環境變數頁面也跟著消失。
  • 資料庫有備份,也知道怎麼匯出。PostgreSQL 用 pg_dump;Supabase CLI 的 supabase db dump 預設只匯出結構,資料要加 --data-only 再跑一次(自訂角色用 --role-only),而且預設匯出的是本機資料庫,要加 --remote 指定已連結的雲端專案16。Storage 裡上傳的檔案不在資料庫匯出裡,要另外下載。至少實際匯出一次,確認可以還原。
  • 能輸出靜態檔就輸出靜態檔。建置結果是一包 HTML、CSS、JS 的話,任何主機都能放;伺服器端功能越多,能搬去的地方越少。

如果主機明天宣布關站,照這個順序搬

  1. 盤點。列出網域、DNS 在哪、程式碼在哪、環境變數、資料庫、上傳的檔案、排程和 webhook、第三方登入的回呼網址。
  2. 先調低 DNS 的 TTL。把要改的紀錄 TTL 調到 300 秒左右,等原本的 TTL 過完,之後切換時舊紀錄很快就會失效。Cloudflare 開了代理(橘色雲朵)的紀錄,TTL 固定 300 秒、不能改17;如果搬家要連 nameserver 一起換,那層的快取時間由網域的上層(例如 .com)決定,自己調不了;Cloudflare 的設定文件也提醒,註冊商更新 nameserver 最多要等 24 小時18,所以要提早換。
  3. 在新平台平行部署。搬資料庫和檔案,重新設環境變數:在服務商另外建一把新金鑰給新平台用,舊的那把到第 6 步才撤銷。例外是舊平台外洩過金鑰,那就現在立刻輪替。先掛在測試子網域上跑。
  4. 測完再切換。登入、表單、付款、排程都在測試網址上試過,再把正式網域的 DNS 指到新平台。網站會寫入資料(會員、表單、留言)的話,切換前先暫停寫入,或在切換時再同步一次資料庫,不然第 3 步之後寫進舊平台的資料會留在舊平台。
  5. 驗證。用 curl 或瀏覽器的無痕視窗確認回應來自新平台,HTTPS 憑證正常,搜尋工具(如 Search Console)沒有出現大量錯誤。
  6. 最後才取消舊平台。舊的先留著幾天當退路,確認沒有流量再進去,再匯出最後一次資料、撤銷舊金鑰、取消方案。

Zeabur 為什麼關站、兩次入侵怎麼發生,寫在上篇和下篇;網域要轉到別家註冊商,轉入價和步驟見網域續約價。

想深入 Zeabur 遷移指南:搬到 Supabase 與 Cloudflare Workers(附 AI 提示詞) 資料庫、檔案、網站、API、排程和網域,一步步搬。 想深入 2026 網域怎麼買、DNS 怎麼設:用 Cloudflare 綁網站、設自訂網域信箱轉寄 網域和 DNS 分開管,換主機只要改紀錄。

網站維護檢查清單

什麼時候檢查什麼怎麼查
每次推送後建置有沒有成功Cloudflare 後台 Deployments,或 npx wrangler deployments list
每次推送後線上真的是新版本打開改過的頁面,或用 curl 找新內容
新版本出問題先退回再修後台 Rollback,或 npx wrangler rollback
每次新增資料表RLS 有沒有開、規則對不對Supabase Advisors → Security;用訪客和登入身分各試一次
每次新增資料表訪客權限是不是需要has_table_privilege('anon', ...)
每次加新金鑰沒有寫進程式碼或前端.gitignore 有排除;用 wrangler secret put 存
每月帳單和用量有沒有異常各服務的帳單頁;會燒錢的金鑰設用量上限
每月免費方案有沒有被暫停或接近上限Supabase 專案狀態、儲存用量
懷疑外洩時撤銷、換新、查帳單、找原因照上面「金鑰外洩時的處理順序」
每半年網站搬得走登得進網域註冊商和 DNS 後台;環境變數清單是最新的;資料庫實際匯出一次

資料來源

  1. 1. Rollbacks · Cloudflare · 2026-11-07 查詢
  2. 2. Secrets · Cloudflare · 2026-11-07 查詢
  3. 3. About push protection · GitHub · 2026-11-07 查詢
  4. 4. Understanding API keys · Supabase · 2026-11-07 查詢
  5. 5. Row Level Security · Supabase · 2026-11-07 查詢
  6. 6. Database Advisors · Supabase · 2026-11-07 查詢
  7. 7. Zeabur August 2026 security incident · Zeabur · 2026-09-07
  8. 8. Zeabur 2026 年十月資安事件(初步報告) · Zeabur · 2026-10-19
  9. 9. Zeabur 停止營運公告與服務遷移安排 · Zeabur · 2026-10-17
  10. 10. Changes are coming to Glitch · Glitch · 2026-11-16 查詢
  11. 11. Squarespace Completes Acquisition of Google Domains Assets · Squarespace · 2026-11-16 查詢
  12. 12. Export domains / Google Domains migration to Squarespace · Google Cloud · 2026-11-16 查詢
  13. 13. Your frontend, backend, and database — now in one Cloudflare Worker · Cloudflare · 2026-11-16 查詢
  14. 14. Cloudflare Pages · Cloudflare · 2026-11-16 查詢
  15. 15. Service migration, refunds, and security incident claims · Zeabur · 2026-10-22
  16. 16. supabase db dump · Supabase · 2026-11-16 查詢
  17. 17. Time to Live (TTL) · Cloudflare · 2026-11-16 查詢
  18. 18. Change your nameservers (Full setup) · Cloudflare · 2026-11-16 查詢

關於作者

Kelvin Wang

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

更多關於我