Codex 在公司內網或代理下報證書校驗失敗(TLS / SELF_SIGNED_CERT_IN_CHAIN)怎麼辦:CA 證書與代理放行

在公司內網或企業代理下用 Codex 報 SELF_SIGNED_CERT_IN_CHAIN 或 TLS 校驗失敗?本文說明企業 CA 根證書配置(CODEX_CA_CERTIFICATE / NODE_EXTRA_CA_CERTS)與代理放行邊界。

NNathaniel bigo··原創首發·AI 輔助撰寫
13 分鐘讀完
資料核對於 2026-11-19 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

  1. 報錯根因是企業安全網關做了 HTTPS 解密重籤,而 CLI 運行時沒信任公司的私有根證書。瀏覽器之所以正常,是因為公司 IT 已把私有根證書預裝進了系統證書庫;但 Codex CLI 及其關聯的 Node、Python、OpenSSL 組件預設只認自帶的公共 CA 列表,遇到私有證書鏈便會拒連。
  2. 正確修法是把公司根證書(.pem 格式)顯式注入環境變量,絕不要粗暴關閉證書校驗。Codex CLI 優先讀取 CODEX_CA_CERTIFICATE(未設時回退讀取 SSL_CERT_FILE);Node 運行層、IDE 插件或 MCP 工具讀取 NODE_EXTRA_CA_CERTS(新版本 Node 也可啟用 NODE_USE_SYSTEM_CA=1)。
  3. 顯式代理務必配好 HTTPS_PROXY 與 NO_PROXY。Codex CLI 常規兼容標準 HTTP / HTTPS 代理,很多版本不兼容 SOCKS5;同時必須把 localhost,127.0.0.1 寫進 NO_PROXY,防止本地 OAuth 登入回調或桌面端輔助通信被誤發給公司代理。
  4. 若證書通過了卻頻繁斷流,需找 IT 對 OpenAI 域名免除緩衝式 TLS 檢查。部分企業網關會整包緩衝 HTTPS 響應,破壞 Codex 依賴的流式傳輸(SSE / WebSocket),按官方網絡建議放行直連最穩妥。
  5. 在辦公環境打通合規網絡後,研發團隊建議配合穩定的高配額訂閱使用。國內缺少外幣卡的個人或企業用戶,可在本站開通 ChatGPT Plus、ChatGPT Pro 或支持統一席位管理的 ChatGPT Business 團隊定製。

公司內網 TLS 證書校驗失敗分流診斷

圖:本站根據 OpenAI 幫助中心:Network recommendations 與企業排障經驗整理的示意圖

本文根據 OpenAI 幫助中心《Network recommendations for ChatGPT errors on web and apps》、Codex 官方文檔《Environment variables》《Troubleshooting》《Codex CLI》及官方 GitHub 倉庫討論整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。

適用於誰

  • 在公司內網、金融/國企辦公網或安裝了企業零信任客戶端(如 Zscaler、Netskope 等)的電腦上使用 Codex 時,報 SELF_SIGNED_CERT_IN_CHAIN、UNABLE_TO_VERIFY_LEAF_SIGNATURE、unknown issuer 或 certificate verify failed 的開發者;
  • 瀏覽器訪問 ChatGPT 網頁正常,但 Codex CLI、IDE 擴展或桌面端一直卡在 TLS 握手或登入回調失敗的用戶;
  • 需要向公司 IT 提交合規證書與代理放行配置說明的技術負責人。

一、先導出公司根證書並認清幾個關鍵環境變量

不要隨便從網上下載不明證書,直接向公司 IT 部門索取企業根證書鏈的 Base64 編碼 X.509(.pem 或 .crt)文件;如果是自帶管理員權限的辦公機,也可從 Windows「證書管理器(certmgr.msc)→ 受信任的根證書頒發機構」或 macOS「鑰匙串訪問 → 系統根證書」導出對應網關的根證書並儲存為 .pem(本站建議)。

不同組件讀取的證書與代理變量名稱不同,對照下表一次配全:

常見 CA 證書與代理環境變量對照

圖:本站根據 OpenAI Codex 官方文檔:Environment variables 整理的示意圖

環境變量生效對象典型寫法注意事項
CODEX_CA_CERTIFICATECodex CLI 核心網絡請求/path/to/corp-ca.pem優先級高於 SSL_CERT_FILE,需指向完整根證書鏈 PEM
SSL_CERT_FILERust/OpenSSL/Python 通用回退/path/to/corp-ca.pem未設定 CODEX_CA_CERTIFICATE 時 Codex 會回退讀取
NODE_EXTRA_CA_CERTSNode 包裝層、IDE 插件、MCP/path/to/corp-ca.pem在自帶公共 CA 之外追加企業 CA,最適合 Node 生態
HTTPS_PROXY顯式企業代理出口http://proxy.corp:8080優先使用標準 http:// 協議頭,避免填 SOCKS5
NO_PROXY繞過代理的本機與內網地址localhost,127.0.0.1,::1防止本地 OAuth 回調端口與內網鏡像源被錯送代理

二、macOS / Linux 與 Windows 實操配置示例

拿到 .pem 證書文件後(假設儲存在 ~/.certs/corp-root-ca.pem 或 C:\certs\corp-root-ca.pem),按操作系統寫入終端環境並測試 codex login:

macOS / Linux(寫入 ~/.zshrc 或 ~/.bashrc)

bash
export CODEX_CA_CERTIFICATE="$HOME/.certs/corp-root-ca.pem"
export SSL_CERT_FILE="$HOME/.certs/corp-root-ca.pem"
export NODE_EXTRA_CA_CERTS="$HOME/.certs/corp-root-ca.pem"

# 僅當公司要求顯式代理地址時取消下方註釋並替換為真實地址
# export HTTPS_PROXY="http://proxy.yourcompany.com:8080"
# export HTTP_PROXY="http://proxy.yourcompany.com:8080"
export NO_PROXY="localhost,127.0.0.1,::1"

儲存後執行 source ~/.zshrc 重新加載,再運行 codex login 驗證握手是否通過。

Windows PowerShell(設定用戶級持久化變量)

powershell
[Environment]::SetEnvironmentVariable("CODEX_CA_CERTIFICATE", "C:\certs\corp-root-ca.pem", "User")
[Environment]::SetEnvironmentVariable("SSL_CERT_FILE", "C:\certs\corp-root-ca.pem", "User")
[Environment]::SetEnvironmentVariable("NODE_EXTRA_CA_CERTS", "C:\certs\corp-root-ca.pem", "User")
[Environment]::SetEnvironmentVariable("NO_PROXY", "localhost,127.0.0.1,::1", "User")

設定完畢後必須關閉並重開所有終端窗口與 Codex 桌面端,新環境變量才會生效。另外,如果你讓 Codex 在沙箱裏執行 npm install、pip 或 curl 訪問公司私有制品庫同樣報證書錯,需同時檢查兩處:一是沙箱是否已按 /guides/codex-sandbox-network-access-disabled-fix 放行網絡;二是在 config.toml 中確認 NODE_EXTRA_CA_CERTS / SSL_CERT_FILE 已按 /guides/codex-missing-environment-variable 正常透傳給子進程。

排障與訂閱提示:企業內網開發者通常項目體量大、單日重構次數多,普通套餐較快觸及限額。個人重度開發可按需選擇 ChatGPT Pro 5x iOS 可覆蓋檔;團隊統一合規採購與開票可看 ChatGPT Business 團隊定製,新號手機驗證受阻也可參考 Codex 註冊手機驗證服務。

三、企業 IT 放行建議與安全底線

  1. 嚴禁長期設定 NODE_TLS_REJECT_UNAUTHORIZED=0:網上的臨時偏方常教人直接關閉 TLS 證書驗證,這會讓整台開發機的所有 Node 請求暴露在中間人篡改風險中,且無法修復非 Node 原生二進制組件的報錯,在公司合規審計下也屬於嚴重違規。
  2. 配合 IT 放行流式傳輸域名:如果注入根證書後登入成功了,但問答中途總報 stream disconnected before completion 或 502 / 503,說明企業安全網關雖然允許連接,卻截斷或緩衝了長連接流。建議將 OpenAI 官方網絡文檔中列出的核心域名提交給 IT,申請免除深度內容緩衝檢查,同時可聯動排查 /guides/codex-stream-disconnected-before-completion 與 /guides/codex-token-exchange-failed-login-error。

常見問題

問:公司給我的證書是 .cer 或 .der 格式,直接填給 CODEX_CA_CERTIFICATE 能識別嗎?

答:如果是二進制 DER 編碼的 .cer / .der,很多工具無法直接解析。建議先用 openssl x509 -inform der -in corp.cer -out corp.pem 轉成文本格式的 PEM(用記事本打開應能看到 -----BEGIN CERTIFICATE----- 開頭),如果存在中間證書,把中間證書和根證書按順序合併到同一個 .pem 文件裏效果最穩。

問:設定好 HTTPS_PROXY 後,連上去了卻報 407 Proxy Authentication Required 怎麼辦?

答:說明公司代理開啟了帳號鑑權(Basic / NTLM / Kerberos)。切勿把明文密碼硬編碼寫進倉庫腳本,優先使用公司 IT 提供的本地認證代理助手(如 CNTLM / Px)在 127.0.0.1 暴露免密本地代理端口,再將 HTTPS_PROXY 指向該本地端口。

問:國內沒有外幣卡,或者公司研發團隊需要增值稅發票,怎麼開通 Plus / Pro / 團隊版?

答:可通過本站 AI 會員充值總覽 按需選購 ChatGPT Plus(含 Plus iOS 可覆蓋版)或高配額 ChatGPT Pro,團隊多人研發亦可選擇企業定製方案。支持支付寶、微信支付與 AlipayHK,提供免交密碼卡密自助兌換與增值稅發票服務,價格以商品頁實時展示為準;售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍的說明。

相關教學

參考資料

  • OpenAI 幫助中心:Network recommendations for ChatGPT errors on web and apps — https://help.openai.com/en/articles/9247338-network-recommendations-for-chatgpt-errors-on-web-and-apps
  • OpenAI ChatGPT Learn:Environment variables — https://learn.chatgpt.com/docs/config-file/environment-variables
  • OpenAI ChatGPT Learn:Troubleshooting — https://learn.chatgpt.com/docs/reference/troubleshooting
  • OpenAI Codex 官方文檔:Codex CLI — https://developers.openai.com/codex/cli
  • OpenAI Codex 官方 GitHub 倉庫 — https://github.com/openai/codex

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 整理家庭裝修預算明細、隱蔽工程驗收清單與主材優缺點對比表實戰

    第一次裝修面對幾十頁施工報價單、密密麻麻的水電防水隱蔽項目與五花八門的主材參數,極易踩坑增項。本文梳理用 ChatGPT 審查裝修報價漏項、生成帶公式的預算明細表、定製工地隱蔽工程驗收單與主材對比表的實戰提示詞。

    ChatGPT0
  2. 02

    用 ChatGPT 做費曼學習法讀書共讀:反向追問檢驗自己是否真讀懂專業書籍與整理書單筆記

    讀完一本專業硬書常感覺「合上書就忘」,直接讓 AI 概括全書又容易產生懂了的錯覺。本文介紹用 ChatGPT 結合 Study Mode 與費曼學習法做反向追問共讀,通過通俗複述、挑刺盲區到沉澱書單卡片的完整流程與提示詞。

    ChatGPT0
  3. 03

    用 ChatGPT 做外貿產品多語種目錄、展會邀約與客戶跟進節奏表(附脫敏與本地化提示詞)

    做外貿展會與海外推廣時,手工翻譯十幾款產品目錄費時且容易留下一堆中式英文,展後客戶跟進也常缺節奏。本文梳理用 ChatGPT 先脫敏建術語庫、再批量產出多語種目錄、展前邀約函與展後 21 天跟進節奏表的實戰流程與提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫高質素技術專欄文章、開源項目 Release Notes 與版本更新日誌實戰

    讓 AI 直接憑空寫技術文章容易滿篇空洞套話,直接甩 Git 記錄寫更新日誌又常常漏掉破壞性變更。本文整理用 ChatGPT 結合真實代碼片段、壓測數據與 PR 摘要,高效產出深度技術專欄、GitHub Release Notes 與 CHANGELOG 的實戰工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做產品用戶訪談紀要編碼、提煉高頻痛點需求池與 RICE 優先級打分實戰

    手頭攢了十幾份用戶訪談逐字稿,手工貼便利貼歸納痛點耗時又容易帶入主觀偏見。本文分享用 ChatGPT 完成脫敏檢查、逐份開放式編碼、跨樣本聚類高頻痛點並搭建 RICE 優先級打分表的 5 步實戰流,附可直接複製的三段核心提示詞。

    ChatGPT0
  6. 06

    ChatGPT 網頁版上載超過 10 個文件或回形針附件按鈕變灰怎麼辦:打包合併與配額限制排查

    在 ChatGPT 網頁版批量分析文檔時,常遇到一次選超 10 個文件被攔截或輸入框回形針按鈕變灰。本文依據 OpenAI 文件上載與存儲說明,梳理 6 類常見報錯的分流排查法,提供 ZIP 打包、本地合併與 Projects 複用方案及可直接複製的解包提示詞。

    ChatGPT0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~