Agentic Research

Proxy(代理伺服器)

又稱:代理伺服器 · proxy server · forward proxy · 反向代理 · 公司網路代理

擋在你與目標之間的中轉站:你的請求先給它,它再替你去問,然後把結果轉回來。

你會在什麼時候遇到它

在公司或學校的網路裡,你的 API 呼叫常常不是直接出去,而是經過一道代理。同一個腳本在家跑得通、進了辦公室就 timeout 或 407,十之八九是代理在中間擋著、或要求額外認證。

打個比方

像公司總機:你不能直接打外線,得先撥總機,由它幫你接出去。總機可以記錄你打了哪裡、可以擋掉某些號碼,也可能要你報身分才肯接。

最小範例

# 很多工具會讀這些環境變數來決定要不要走代理
echo "$HTTPS_PROXY"        # 例如 http://proxy.corp.example:8080

# 407 Proxy Authentication Required = 代理要求身分認證
# 解法通常是設好代理的帳號密碼,或在該網路下允許直連

重點:代理是環境造成的,不是你的程式或金鑰錯了。同一份程式碼換個網路就正常,幾乎可以確定是代理。遇到這種「只在公司壞掉」的狀況,先問 IT 這裡的代理怎麼設,比自己亂試快得多。

最常搞錯的地方

  • 在公司網路裡一直重設金鑰、重裝套件,卻沒發現是代理在擋。判斷方法:換個網路(例如手機熱點)跑一次,如果就好了,那問題是網路環境,不是你的設定。
  • 把「代理」和「反向代理/API 閘道」混為一談。你電腦設定的 forward proxy 是替你出門;而像 LiteLLM 那種放在伺服器前面、統一轉發與計費的是反向代理,角色相反。

相關詞條

下一步