外觀

語言

從 0 建設個人網站

API key 會被推上 GitHub 嗎?2026 用 AI 做網站的金鑰外洩檢查

用 AI 做網站,金鑰常被 commit 進 GitHub 或打包進前端 JavaScript。分清哪些值是機密,附上線前檢查清單和外洩後的處理順序。

Kelvin Wang · · 15 分鐘閱讀

重點整理

  1. Supabase publishable key、Stripe publishable key、Firebase 網頁設定本來就會出現在瀏覽器;安全靠的是 RLS 或 Security Rules,不是把它藏起來。
  2. 上線前查三個地方:git 歷史(包括已經刪掉的檔案)、建置出來的前端檔案、部署平台的環境變數設定。
  3. 金鑰外洩時先到服務商後台撤銷、換新,再處理 git 歷史;刪掉 commit 擋不住已經被複製走的那份。
  4. 不要把金鑰貼進對話;在專案說明檔寫明規則,把 .env 列為 AI 工具不能讀的檔案,能放到專案資料夾外面的就放外面。

網站一接上資料庫、AI 服務或金流,程式就需要金鑰。叫 AI 工具「把這個串起來」的時候,它會把金鑰放在某個地方,你不一定知道是哪裡:可能是 .env,可能直接寫在元件裡,也可能是加了 NEXT_PUBLIC_ 前綴、跟著網頁一起送到每個訪客的瀏覽器。不管你用的是 Claude Code、Cursor、Codex、v0 還是 Lovable,該查的地方都一樣。

我的網站是 Astro,跑在 Cloudflare Workers,資料庫是 Supabase,大部分程式是 Claude Code 寫的。下面幾項檢查(第 2、3、6 項)在這個網站的 repo 和線上頁面跑過,結果寫在對應的段落。

哪些是機密,哪些本來就公開?

先把手上的值分成兩類。分錯了,要嘛把該藏的放進前端,要嘛為了一把本來就公開的 key 緊張半天。

值能放進前端或公開 repo 嗎原因
AI 服務的 API key(OpenAI、Anthropic、Gemini 等)不能別人用你的額度,費用算你的
資料庫連線字串(postgres://帳號:密碼@…)不能等於資料庫的帳號密碼
Supabase secret key(舊版對應 service_role key)不能會略過所有 RLS 規則 [4]
Stripe secret key(sk_)、restricted key(rk_)不能只有 publishable key 可以公開 [5]
OAuth client secret、webhook 簽章密鑰不能能冒用你的應用程式、偽造通知
部署 hook 網址、雲端平台 token不能拿到就能觸發部署或操作帳號
Supabase publishable key(舊版對應 anon key)可以設計上公開;能讀寫什麼由 RLS 決定 [4]
Stripe publishable key(pk_)可以不能收款或讀帳戶資料 [5]
Firebase 網頁設定裡的 apiKey可以只識別專案;資料靠 Security Rules 保護 [6]

「可以公開」有前提。Supabase 文件寫得很清楚,publishable key 任何人都能從你發佈的程式裡讀到,所以要當成公開的值,它能碰到什麼完全看 RLS(Row Level Security,每張資料表上決定誰能讀寫的規則)4。Firebase 文件的說法相同:它的 API key 只用來識別專案,保護資料的是 Security Rules,不要只靠限制或藏起 key6。Firebase 另外提醒一個陷阱:同一把 key 不要拿去開 Gemini API,Gemini 的 key 必須保密6。

公開的 key 加上沒設好的權限,結果就是資料庫對全世界開放。2025 年有研究者掃了 1,645 個用 Lovable 做的專案,其中 170 個、共 303 個端點的 RLS 設定不足,未登入的人就能讀取、甚至寫入使用者名單、交易紀錄這類資料表2。研究者原本以為是 key 外洩,查下去才發現 key 本來就是公開的,問題出在 RLS;外露的端點裡還有一個叫 get_gemini_api_key 的函式3。這件事登記為 CVE-2025-48757,Lovable 對這個 CVE 有異議,認為保護資料是每個使用者自己的責任2。責任怎麼分是另一回事,對你來說結論一樣:前端看得到 publishable key 沒關係,每一張表都要有 RLS。

想深入 Supabase RLS 教學:policy 寫法、using 與 with check、怎麼測 開啟 RLS、四種指令的 policy 怎麼寫,以及怎麼測。

這個網站的登入頁下載的 JavaScript 裡找得到 sb_publishable_ 開頭的 key,這是預期的;找不到 sb_secret_。反過來,.env.example 裡有一個部署 hook 網址,看起來像普通設定,但任何人拿到都能觸發網站重新部署,所以正式環境用 Cloudflare 的 secret 存,本機的值只放在不進 git 的 .env。

金鑰通常怎麼漏出去?

GitGuardian 每年統計公開 GitHub 上的外洩金鑰。2026 年 3 月發佈的報告(涵蓋 2025 年)裡有這幾個數字1:

  • 2,865 萬筆。2025 年新增到公開 GitHub commit 裡的寫死金鑰,比前一年多 34%,是他們紀錄以來最大的單年增幅。
  • AI 服務的金鑰 1,275,105 筆,年增 81%。
  • MCP 設定檔裡 24,008 筆。MCP 是讓 AI 工具連接外部服務的設定。報告指出很多 MCP 安裝教學叫你把 API key 直接寫進設定檔或指令參數。
  • 超過 64% 還能用。2022 年確認有效的金鑰,2026 年 1 月重新測試,仍有超過 64% 沒被撤銷。

具體的路徑,大致是這幾條:

  1. .env 被 commit。.gitignore 沒寫,或寫錯檔名(例如只排除 .env,沒排除 .env.local、.env.production)。
  2. 金鑰被寫死在程式裡。AI 為了「先讓它能跑」,把 key 直接貼進元件或設定檔,之後沒有搬回環境變數。
  3. 加了公開前綴。NEXT_PUBLIC_、VITE_、PUBLIC_ 開頭的變數會在建置時寫進瀏覽器的 JavaScript161718。機密加上這個前綴,功能可以正常運作,金鑰也跟著公開了。
  4. 建置產物被 commit 或公開。dist/、.next/、out/ 這類資料夾被推上 repo,裡面是已經把值替換進去的檔案。
  5. AI 工具把值寫進別的地方。測試檔、除錯用的 console.log、範例設定、說明文件、MCP 設定檔。
  6. 截圖和貼文。在社群、issue 或聊天裡貼錯誤畫面,畫面上剛好有 .env 或後台的 key。
  7. repo 是公開的。用 AI 網站產生器把專案同步或匯出到 GitHub,沒注意 repo 的可見度;或把私人 repo 改成公開時,忘了歷史裡有什麼。

私人 repo 也不代表安全。同一份報告說,內部 repo 含有寫死金鑰的機率大約是公開 repo 的 6 倍1:大家以為沒人看得到,就比較不小心。私人 repo 有一天可能改成公開、加入協作者,或授權給第三方工具讀取。

上線前的金鑰檢查清單

每一步都可以自己跑,也可以把整段貼給你的 AI 工具,要它逐項回報結果(但不要讓它印出金鑰的值)。

  1. 確認 .gitignore 排除了所有 .env 檔。我的網站在建立 repo 的第一天加了這兩行,排除所有 .env 開頭的檔案,只留一個不含真實值的 .env.example:

    .env*
    !.env.example

    用 git check-ignore -v .env.local 可以確認某個檔案真的被排除,並看到是哪一行規則。用 Cloudflare 的 wrangler 開發的話,本機的 .dev.vars 也要排除12。

  2. 查 .env 有沒有曾經被 commit 過。就算現在被排除了,以前 commit 過的版本還在歷史裡:

    git log --all --name-only --format= -- ':(glob)**/.env*' | sort -u

    列出歷史裡出現過的所有 .env 類檔案;只看到 .env.example 就是沒有。在這個網站的 repo 上跑,結果只有 .env.example。

  3. 在整個歷史裡搜尋金鑰的開頭。git log -S 會找出新增或刪除某段文字的 commit20,連已經刪掉的檔案也找得到:

    git log --all -p -S 'sk_live_'

    把 sk_live_ 換成你用到的服務的金鑰開頭,例如 Stripe 的 sk_live_、rk_live_,Supabase 的 sb_secret_,或 service_role、postgresql://、postgres://(資料庫連線字串兩種寫法都有)。在這個網站的 repo 上搜 sb_secret_,找到的都是文章裡說明「secret key 長這樣開頭」的句子,沒有真的金鑰。找到的東西要自己看過,很多是說明文字或範例。

  4. 跑一次掃描工具。手動搜尋只找得到你想得到的開頭,掃描工具內建上百種金鑰的格式。兩個常見的開源工具:gitleaks(gitleaks git -v . 掃整個 git 歷史,gitleaks dir -v . 掃目前的檔案)10;TruffleHog(trufflehog git file://. --results=verified 只列出它實際測試過、確認還能用的金鑰)11。gitleaks 的 README 寫明它的功能已經定版,之後只出安全性修正10。兩個都可以接成 pre-commit hook,每次 commit 前自動掃。

  5. 確認 GitHub 的 secret scanning 和 push protection。公開 repo 的 secret scanning 免費、自動執行,會掃所有分支的完整歷史;私人 repo 要付費的 GitHub Secret Protection(組織帳號的 Team 或 Enterprise 方案)才有。找到合作服務商的金鑰時,GitHub 會直接通知那家服務商,對方可能撤銷那把金鑰7。push protection 會在你推送時擋下含有金鑰的 commit。個人帳號層級的 push protection 預設開啟,但只管推到公開 repo;repo 層級的預設關閉,要自己打開。它只認得特定格式的金鑰,而且有寫入權限的人可以選擇略過8,所以只能當最後一道。

  6. 檢查瀏覽器拿到了什麼。在本機跑一次正式建置,搜尋輸出資料夾:

    npm run build
    grep -rE 'sk_live_|sb_secret_|service_role|postgres(ql)?://' dist/

    輸出資料夾依框架不同,Astro、Vite 是 dist/,Next.js 是 .next/ 或 out/。上線之後,打開網站,用開發者工具(F12)的 Sources 分頁全域搜尋(macOS 是 Cmd+Option+F,Windows 是 Ctrl+Shift+F)同樣的字,Network 分頁看每個請求的標頭有沒有帶不該帶的 key。這個網站的登入頁就是這樣查的:只找得到 publishable key。

  7. 逐一看有公開前綴的環境變數。把專案裡所有 NEXT_PUBLIC_、VITE_、PUBLIC_ 開頭的變數列出來,每一個都問一次:被所有訪客看到可以嗎?不行的話,這個功能要改成從伺服器端呼叫。前綴的細節和建置時寫死的問題,在〈本機正常,部署就失敗?〉那篇有完整的表格。

  8. Supabase 的每一張表都要開 RLS。Supabase 文件說,沒開 RLS 的公開資料表,任何有權限的角色都能讀寫19。後台的 Advisors 裡有 Security Advisor,其中一項檢查(rls_disabled_in_public)專門列出 public schema 裡沒開 RLS 的表21。

  9. 部署平台上,機密用「secret」類型存。Vercel 的環境變數分 Config 和 Secret,Secret 存好後就讀不出來,只能覆寫13;Cloudflare Workers 用 npx wrangler secret put <名稱> 存,存好後在後台和 wrangler 都看不到值12。不要把機密寫進 wrangler.jsonc、vercel.json 這類會進 git 的設定檔。

  10. 確認 repo 的可見度。到 GitHub 的 repo 設定看一眼是 Public 還是 Private,特別是 AI 網站產生器幫你建的 repo。

想深入 本機正常,部署就失敗?2026 網站部署失敗的常見原因與排查順序 NEXT_PUBLIC_、VITE_、PUBLIC_ 前綴的變數什麼時候寫進瀏覽器,以及建置變數和執行變數的差別。

金鑰已經外洩了,要先做什麼?

順序很重要:先讓那把金鑰失效,再處理 git 歷史。GitHub 的文件寫的第一步就是撤銷或輪替金鑰;金鑰失效之後,改寫歷史有時根本不需要9。

  1. 到服務商後台撤銷舊的、建立新的。Stripe 叫 rotate,會撤銷舊 key 並產生新的;輪替時可以讓舊 key 多用幾天方便切換,外洩時到期時間要選 Now,舊的才會立刻失效5。Supabase 的文件寫「修好外洩的原因後馬上輪替」:新的金鑰不要放回原本漏出去的地方,例如前端程式或 repo 裡的檔案,不然會再漏一次。它也建議每個後端元件各用一把,外洩時只需要換那一把4。
  2. 把新金鑰更新到部署平台,重新部署。大部分平台改了變數要重新部署才生效。
  3. 看用量、帳單和請求紀錄。Stripe 每把 key 都可以看請求紀錄5,AI 服務看用量頁。找外洩期間有沒有你不認得的使用;有的話,聯絡服務商。
  4. 確認漏洞堵住了。用上面的清單把整個專案查一次,看還有沒有別的金鑰用同樣的方式放著。
  5. 最後才決定要不要清 git 歷史。

為什麼刪掉 commit 不夠?你在本機刪掉那一行再推上去,舊的 commit 還在歷史裡,任何人往回翻都看得到。就算用工具改寫歷史、強制推送,GitHub 文件列出資料仍會留存的地方9:

  • fork。有人 fork 過,那份 fork 裡還有。
  • 別人的 clone。你沒辦法替別人刪。
  • GitHub 上的快取頁面和 pull request。舊 commit 仍然可以用雜湊值直接打開;要完全移除,得聯絡 GitHub Support,而且他們只在無法靠輪替金鑰解決時才協助。

改寫歷史本身也有代價:所有之後的 commit 雜湊都會變、簽章會被移除、協作者手上的舊 clone 一推就可能把金鑰帶回來9。GitHub 建議用 git-filter-repo(2.47 版以上,加 --sensitive-data-removal)來做9。對大多數個人網站來說,金鑰已經撤銷的話,歷史裡留著一串無效的字,風險已經很小;要不要清,看那段歷史裡還有沒有別的東西(例如真實的使用者資料)。

另一篇〈AI 寫的網站上線後會壞在哪?〉有一份更短的處理順序,和「部署平台被駭時怎麼縮小損失」。平台端外洩的實際案例,可以看 Zeabur 被駭的拆解:

想深入 AI 寫的網站上線後會壞在哪?部署失敗、憑證外洩與資料庫權限 金鑰放哪裡、哪把可以公開,以及平台被打穿時怎麼讓損失變小。 想深入 Zeabur 兩個月被駭兩次後關站(上):從一個 NextChat 漏洞到 AWS root key 攻擊者怎麼從一個使用者部署的應用程式,一路拿到平台上所有專案的環境變數。

怎麼讓 AI 工具不要把金鑰寫進程式?

AI 工具讀得到你專案裡的檔案、看得到你貼給它的內容,也會照它的判斷寫進程式碼。能做的是讓它拿不到,再用規則和檢查補上。

  • 不要把金鑰貼進對話。要 AI 串一個服務時,告訴它變數名稱(「用 STRIPE_SECRET_KEY,值在 .env」),值自己填。貼進對話的東西可能出現在它寫的程式、測試或說明裡。

  • 在專案說明檔寫明規則。Claude Code 的 CLAUDE.md、Codex 的 AGENTS.md,以及設成一律套用的 Cursor rules,每次對話開始都會讀。我的網站在 CLAUDE.md 寫了資料表一律要開 RLS 的規則;repo 裡另一份由 SEO 監控專案維護、同步過來的說明檔,則明寫 SEO 憑證「不能出現在 repo、說明檔、PR、對話或日誌裡」。可以照這個寫法加幾行:

    - 機密只放在 .env(不進 git)和部署平台的 secret,不寫進程式碼、測試或設定檔。
    - 不幫機密加 NEXT_PUBLIC_ / VITE_ / PUBLIC_ 前綴;前端需要的話改成伺服器端呼叫。
    - 不印出、不 log 任何環境變數的值。
    - commit 前跑 gitleaks(或你用的掃描工具),有發現就停下來告訴我。
  • 把 .env 設成 AI 工具不能讀。Claude Code 可以在設定的 permissions.deny 加上 Read(./.env)、Read(./.env.*)14;Cursor 用專案根目錄的 .cursorignore15。兩種設定都不是保證:Cursor 文件自己寫明,Agent 透過終端機或 MCP 工具仍然可能讀到被忽略的檔案15。

  • 能放到專案資料夾外面的,就放外面。我的網站讀 SEO 資料用的憑證,放在這台電腦使用者家目錄下的一個設定資料夾,不在 repo 裡;啟動腳本會先檢查檔案權限是不是只有自己能讀(0600),不是就拒絕執行,而且從不印出值。AI 工具在 repo 裡工作,就不會順手讀到、改到或 commit 它。

  • MCP 設定不要寫死金鑰。改用環境變數,或工具提供的憑證管理方式。上面 GitGuardian 的數字裡,有兩萬多筆就是出在 MCP 設定檔1。

  • commit 前看一次差異。git diff --staged 看這次要送出的東西,或讓 pre-commit hook 自動掃。AI 一次改很多檔案時,這一步最容易被跳過。

  • 一個專案一把金鑰,設用量上限。外洩時只需要換一把,損失也有上限。

我的網站做了哪些?

做法怎麼做
.env 不進 git建 repo 第一天(2026-06-10)就排除所有 .env*,只留不含真實值的範例;除了這個範例檔,整個歷史查不到其他 .env 類檔案
正式環境的機密用 wrangler secret put 存在 Cloudflare,不寫進 wrangler.jsonc
前端只有公開的值瀏覽器拿到的只有 Supabase URL、publishable key 這類 PUBLIC_ 變數
資料庫權限CLAUDE.md 規定每張新表都要開 RLS,並寫明要用的條件
社群帳號的 token用 AES-GCM 加密後才存進資料庫,加密用的金鑰是 Cloudflare 的 secret
測試用的登入狀態端對端測試產生的 session 檔案列在 .gitignore
SEO 憑證放在 repo 外面,權限 0600,腳本不印出值

這些都不需要懂資安。每一條都是一次性的設定,或一行寫進說明檔的規則,之後 AI 工具每次進專案都會照著做。

常見問題

Supabase 的 anon key 被別人看到,要換嗎?

不用。anon key(新版叫 publishable key)本來就會出現在每個訪客的瀏覽器裡4。要檢查的是每一張表的 RLS 有沒有開、policy 寫得對不對。真正要緊張的是 secret key(舊名 service_role),它會略過 RLS。

repo 是私人的,金鑰放進去就沒關係嗎?

風險比較低,但不是沒有。私人 repo 可能改成公開、加入協作者、授權給第三方工具或 AI 網站產生器讀取,而且一 commit 就留在歷史裡。GitGuardian 的統計是內部 repo 含有寫死金鑰的機率大約是公開 repo 的 6 倍1。機密放 .env 和平台的 secret,私人 repo 也一樣。

.env 以前 commit 過,現在已經刪了,還要處理嗎?

要。刪掉的檔案還在 git 歷史裡。如果 repo 曾經公開過,或分享給別人,把裡面的機密當成已經外洩:先輪替,再決定要不要清歷史。只有自己用過的私人 repo,至少確認裡面的金鑰有沒有權限過大,有的話也換掉。

刪掉整個 GitHub repo 重建,可以取代輪替嗎?

不行。別人的 clone、fork 和已經被掃描工具抓走的那份,都不會因為你刪 repo 而消失9。能讓外洩的金鑰失效的,只有到服務商後台撤銷它。

資料來源

  1. 1. The State of Secrets Sprawl 2026 · GitGuardian · 2026-03-17
  2. 2. CVE-2025-48757 · NIST NVD · 2025-05-30
  3. 3. Statement on CVE-2025-48757 · Matt Palmer · 2025-05-29
  4. 4. Understanding API keys · Supabase · 2026-11-16 查詢
  5. 5. API keys · Stripe · 2026-11-16 查詢
  6. 6. Learn about using and managing API keys for Firebase · Firebase · 2026-11-16 查詢
  7. 7. About secret scanning · GitHub · 2026-11-16 查詢
  8. 8. About push protection · GitHub · 2026-11-16 查詢
  9. 9. Removing sensitive data from a repository · GitHub · 2026-11-16 查詢
  10. 10. gitleaks README · gitleaks · 2026-11-16 查詢
  11. 11. TruffleHog README · Truffle Security · 2026-11-16 查詢
  12. 12. Secrets · Cloudflare · 2026-11-16 查詢
  13. 13. Config and Secret environment variables · Vercel · 2026-11-16 查詢
  14. 14. Settings files and precedence · Anthropic · 2026-11-16 查詢
  15. 15. Ignore files · Cursor · 2026-11-16 查詢
  16. 16. How to use environment variables in Next.js · Next.js · 2026-11-16 查詢
  17. 17. Env Variables and Modes · Vite · 2026-11-16 查詢
  18. 18. Using environment variables · Astro · 2026-11-16 查詢
  19. 19. Row Level Security · Supabase · 2026-11-16 查詢
  20. 20. git-log · Git · 2026-11-16 查詢
  21. 21. Advisors · Supabase · 2026-11-16 查詢

關於作者

Kelvin Wang

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

更多關於我