從 0 建設個人網站
API key 會被推上 GitHub 嗎?2026 用 AI 做網站的金鑰外洩檢查
用 AI 做網站,金鑰常被 commit 進 GitHub 或打包進前端 JavaScript。分清哪些值是機密,附上線前檢查清單和外洩後的處理順序。
Kelvin Wang · · 15 分鐘閱讀
重點整理
- Supabase publishable key、Stripe publishable key、Firebase 網頁設定本來就會出現在瀏覽器;安全靠的是 RLS 或 Security Rules,不是把它藏起來。
- 上線前查三個地方:git 歷史(包括已經刪掉的檔案)、建置出來的前端檔案、部署平台的環境變數設定。
- 金鑰外洩時先到服務商後台撤銷、換新,再處理 git 歷史;刪掉 commit 擋不住已經被複製走的那份。
- 不要把金鑰貼進對話;在專案說明檔寫明規則,把 .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。
這個網站的登入頁下載的 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% 沒被撤銷。
具體的路徑,大致是這幾條:
.env被 commit。.gitignore沒寫,或寫錯檔名(例如只排除.env,沒排除.env.local、.env.production)。- 金鑰被寫死在程式裡。AI 為了「先讓它能跑」,把 key 直接貼進元件或設定檔,之後沒有搬回環境變數。
- 加了公開前綴。
NEXT_PUBLIC_、VITE_、PUBLIC_開頭的變數會在建置時寫進瀏覽器的 JavaScript161718。機密加上這個前綴,功能可以正常運作,金鑰也跟著公開了。 - 建置產物被 commit 或公開。
dist/、.next/、out/這類資料夾被推上 repo,裡面是已經把值替換進去的檔案。 - AI 工具把值寫進別的地方。測試檔、除錯用的
console.log、範例設定、說明文件、MCP 設定檔。 - 截圖和貼文。在社群、issue 或聊天裡貼錯誤畫面,畫面上剛好有
.env或後台的 key。 - repo 是公開的。用 AI 網站產生器把專案同步或匯出到 GitHub,沒注意 repo 的可見度;或把私人 repo 改成公開時,忘了歷史裡有什麼。
私人 repo 也不代表安全。同一份報告說,內部 repo 含有寫死金鑰的機率大約是公開 repo 的 6 倍1:大家以為沒人看得到,就比較不小心。私人 repo 有一天可能改成公開、加入協作者,或授權給第三方工具讀取。
上線前的金鑰檢查清單
每一步都可以自己跑,也可以把整段貼給你的 AI 工具,要它逐項回報結果(但不要讓它印出金鑰的值)。
-
確認
.gitignore排除了所有.env檔。我的網站在建立 repo 的第一天加了這兩行,排除所有.env開頭的檔案,只留一個不含真實值的.env.example:.env* !.env.example用
git check-ignore -v .env.local可以確認某個檔案真的被排除,並看到是哪一行規則。用 Cloudflare 的 wrangler 開發的話,本機的.dev.vars也要排除12。 -
查
.env有沒有曾經被 commit 過。就算現在被排除了,以前 commit 過的版本還在歷史裡:git log --all --name-only --format= -- ':(glob)**/.env*' | sort -u列出歷史裡出現過的所有 .env 類檔案;只看到
.env.example就是沒有。在這個網站的 repo 上跑,結果只有.env.example。 -
在整個歷史裡搜尋金鑰的開頭。
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 長這樣開頭」的句子,沒有真的金鑰。找到的東西要自己看過,很多是說明文字或範例。 -
跑一次掃描工具。手動搜尋只找得到你想得到的開頭,掃描工具內建上百種金鑰的格式。兩個常見的開源工具:gitleaks(
gitleaks git -v .掃整個 git 歷史,gitleaks dir -v .掃目前的檔案)10;TruffleHog(trufflehog git file://. --results=verified只列出它實際測試過、確認還能用的金鑰)11。gitleaks 的 README 寫明它的功能已經定版,之後只出安全性修正10。兩個都可以接成 pre-commit hook,每次 commit 前自動掃。 -
確認 GitHub 的 secret scanning 和 push protection。公開 repo 的 secret scanning 免費、自動執行,會掃所有分支的完整歷史;私人 repo 要付費的 GitHub Secret Protection(組織帳號的 Team 或 Enterprise 方案)才有。找到合作服務商的金鑰時,GitHub 會直接通知那家服務商,對方可能撤銷那把金鑰7。push protection 會在你推送時擋下含有金鑰的 commit。個人帳號層級的 push protection 預設開啟,但只管推到公開 repo;repo 層級的預設關閉,要自己打開。它只認得特定格式的金鑰,而且有寫入權限的人可以選擇略過8,所以只能當最後一道。
-
檢查瀏覽器拿到了什麼。在本機跑一次正式建置,搜尋輸出資料夾:
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。 -
逐一看有公開前綴的環境變數。把專案裡所有
NEXT_PUBLIC_、VITE_、PUBLIC_開頭的變數列出來,每一個都問一次:被所有訪客看到可以嗎?不行的話,這個功能要改成從伺服器端呼叫。前綴的細節和建置時寫死的問題,在〈本機正常,部署就失敗?〉那篇有完整的表格。 -
Supabase 的每一張表都要開 RLS。Supabase 文件說,沒開 RLS 的公開資料表,任何有權限的角色都能讀寫19。後台的 Advisors 裡有 Security Advisor,其中一項檢查(
rls_disabled_in_public)專門列出 public schema 裡沒開 RLS 的表21。 -
部署平台上,機密用「secret」類型存。Vercel 的環境變數分 Config 和 Secret,Secret 存好後就讀不出來,只能覆寫13;Cloudflare Workers 用
npx wrangler secret put <名稱>存,存好後在後台和 wrangler 都看不到值12。不要把機密寫進wrangler.jsonc、vercel.json這類會進 git 的設定檔。 -
確認 repo 的可見度。到 GitHub 的 repo 設定看一眼是 Public 還是 Private,特別是 AI 網站產生器幫你建的 repo。
金鑰已經外洩了,要先做什麼?
順序很重要:先讓那把金鑰失效,再處理 git 歷史。GitHub 的文件寫的第一步就是撤銷或輪替金鑰;金鑰失效之後,改寫歷史有時根本不需要9。
- 到服務商後台撤銷舊的、建立新的。Stripe 叫 rotate,會撤銷舊 key 並產生新的;輪替時可以讓舊 key 多用幾天方便切換,外洩時到期時間要選 Now,舊的才會立刻失效5。Supabase 的文件寫「修好外洩的原因後馬上輪替」:新的金鑰不要放回原本漏出去的地方,例如前端程式或 repo 裡的檔案,不然會再漏一次。它也建議每個後端元件各用一把,外洩時只需要換那一把4。
- 把新金鑰更新到部署平台,重新部署。大部分平台改了變數要重新部署才生效。
- 看用量、帳單和請求紀錄。Stripe 每把 key 都可以看請求紀錄5,AI 服務看用量頁。找外洩期間有沒有你不認得的使用;有的話,聯絡服務商。
- 確認漏洞堵住了。用上面的清單把整個專案查一次,看還有沒有別的金鑰用同樣的方式放著。
- 最後才決定要不要清 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. The State of Secrets Sprawl 2026
- 2. CVE-2025-48757
- 3. Statement on CVE-2025-48757
- 4. Understanding API keys
- 5. API keys
- 6. Learn about using and managing API keys for Firebase
- 7. About secret scanning
- 8. About push protection
- 9. Removing sensitive data from a repository
- 10. gitleaks README
- 11. TruffleHog README
- 12. Secrets
- 13. Config and Secret environment variables
- 14. Settings files and precedence
- 15. Ignore files
- 16. How to use environment variables in Next.js
- 17. Env Variables and Modes
- 18. Using environment variables
- 19. Row Level Security
- 20. git-log
- 21. Advisors