知識 · IT・資料・DX

環境變數

Environment Variables

📂IT·數據·DX⏱閱讀 2 分鐘📊實務🔗相關 4

什麼是環境變數?

一句話定義
存放在程式碼之外的設定值(尤其是 API 金鑰與密碼)。因為不直接寫在程式碼裡而較為安全,且可依不同環境更換數值。
將此主題改為企業內訓📚 相關課程💬 教育諮詢
⚡ 3 行重點摘要
  • 存放在程式碼之外的設定值
  • 安全保管 API 金鑰與密碼
  • 依環境更換數值

開始使用環境變數後,程式碼的性質本身就會改變。移除金鑰的程式碼,就能成為可以對外公開的資產;開發、測試與正式的伺服器,即使上傳同一份程式碼,各伺服器也會讀取自身環境的數值來運作。每次部署時不必再打開檔案,手動修改伺服器位址或密碼,因此測試用設定原封不動被帶上正式伺服器的意外也會隨之減少。

環境變數裡存放的值,性質分為兩類。一類是 API 金鑰、資料庫密碼、權杖(Token)這類,一旦外洩就會連帶損失金錢與客戶資料的機密值;另一類則是伺服器位址、日誌等級、功能開關(on/off)等依環境而異的設定值。前者需要提高保管等級。一個人使用的階段用 .env 檔案就夠了,但團隊加入後,通常會改用 GitHub Actions Secrets 或部署平台的環境變數介面;若涉及客戶資料,則會進一步採用 AWS Secrets Manager 等專用保險箱,並規定每季更換一次金鑰的規則。

有一個需要留意的界線。.env 不是加密。它只是記錄名稱與值的純文字檔,任何能存取該伺服器或該筆電的人都能打開。因此實務上會將檔案分離與誰能進入該伺服器同等看待管理,並為每把金鑰設定每月用量上限與呼叫通知,讓即使外洩,損失也能控制在上限之內。

現場最常出錯的地方,就是'建立了 .env 檔,現在就安全了'這種想法。即使之後才加上 gitignore,已經上傳的金鑰會留在提交紀錄裡,即使把儲存庫設為私人,翻閱過去的紀錄仍能找到。瀏覽器端使用的前端變數(如 NEXT_PUBLIC_ 系列),名稱雖是環境變數,但對所有使用者都是公開的,這點也常被忽略;另外,把錯誤紀錄整段貼進 AI 對話視窗的那一刻,金鑰也會一併送出。外洩的金鑰不是刪除就好,唯一的解法是廢棄並重新發行。

會出現此術語的課程 · AI・DX
推薦課程 · 推薦講師 · 迷你報價
🧮 迷你報價 · 講師費基準
約 KRW 1,200,000 (≈ US$900)專題講座 2 小時 · 20 人以下 · 韓語
依此條件取得正式報價 →
💡 簡單來說
將密碼另外存放在保險箱中——不直接寫進程式碼,可防止外洩。
為什麼在實務上很重要
若把 API 金鑰、密碼直接寫在程式碼裡,就會發生外洩事故。環境變數是防止此事的第一個資安好習慣。
由來與出處

這是作業系統向程式傳遞設定的古老方式,後來演變為將程式碼與設定、機密值分離的實務原則。

透過案例理解

以下以虛構案例說明。員工約 140 人規模的化妝品通路商 A 公司,沒有開發人員的行銷團隊,邊問 AI 邊在兩週內做出了商品諮詢聊天機器人。為了讓團隊成員互相試用,他們把程式碼上傳到 GitHub 公開儲存庫。十天後,原本每月約 KRW 180,000 (≈ US$135) 的 AI API 使用費,被收取了 KRW 4,700,000 (≈ US$3,520)。

  1. 行銷團隊的朴代理看到付款通知後回報:'我們的聊天機器人,試用過的人不到 300 人吧?',IT 團隊則在日誌中確認了來自海外 IP 約 4 萬次的呼叫。
  2. IT 營運部金副理在30分鐘內就廢棄了舊金鑰並重新發行新金鑰,但為了清除仍留在提交紀錄(commit history)中的金鑰,最後不得不整個重建儲存庫。
  3. 之後團隊將金鑰移到 .env 檔案並加入 gitignore,同時在儲存庫中保留只列出變數名稱的 .env.example,讓新成員 15 分鐘內就能完成設定。
  4. 金次長將開發用與正式用的金鑰分開,並為每個帳號設定每月 KRW 300,000 (≈ US$225) 的上限與用量通知,讓超過上限時呼叫自動停止。
  5. 對 26 名非開發人員進行 40 分鐘的內部教育後,六個月內金鑰外洩為 0 件,API 費用也從每月 KRW 4,700,000 (≈ US$3,520) 降至 KRW 210,000 (≈ US$155)。
相關術語
與此術語相關的課程
📚數位轉型Nanum 經營顧問 企業內訓 · 面授/線上查看課程 →
是否需要針對此主題進行企業內訓?
立即取得負責人為您量身打造的課程規劃與報價。
教育洽詢
最後修訂 2026年9月13日 · 監修 金鍾赫

常見問題

因為一旦分享或公開程式碼,其中的 API 金鑰與密碼也會一併外露,可能遭到濫用。
是的。進行 vibe coding 時,'不要把 API 金鑰放進程式碼,改用環境變數'是必須遵守的安全守則。
因為程式碼一旦被分享或外洩,金鑰與密碼也會一併外洩。必須以環境變數分開管理才安全。
即使不會直接處理,也應該知道'不把 API 金鑰貼進程式碼或對話中'這項原則。