# 決定哪些客戶端能接入你的模型

> 用請求標頭准入規則限制誰能呼叫你的 AI 閘道器:按 User-Agent 或任意 header 放行/拒絕,全域 / 組 / key 三級作用域、白名單模式、ReDoS-safe 正則。

規範連結: https://www.gatellm.io/zh-TW/use-cases/client-admission-control/

按請求標頭做放行/拒絕的准入規則——可匹配 User-Agent、來源或任意 header,作用域為全域 / 某個 key 組 / 某個 key。

## 社群真正在抱怨什麼
「key 一洩露,誰拿著都能燒我們的額度」「我們想把全公司的 coding agent 都放進白名單,但要攔掉裸 curl 和爬蟲」「廠商控制台只有 IP 白名單,可我們流量是動態的、還前置了代理,根本套不上」。
管控必須落在請求真正到達的地方——閘道器——而不是開發隨手就能關掉的客戶端設定上。

## GateLLM 怎麼做
GateLLM 對每個請求按 HTTP 頭做准入判定:6 種匹配型別(exact / prefix / regex / exists / absent / any)、3 級作用域(全域 / key 組 / key),按 sort_order 升序、first-match-wins 逐條求值。
「只放行認可的客戶端」走白名單模式:把該組的預設動作設為拒絕,再加一條匹配客戶端特徵的 allow 規則——其餘請求在到達模型前就被拒掉。

## 落地的 5 個手段
- 6 種匹配型別:exact / prefix / regex / exists / absent / any——一條規則可用正則交替表達「A 或 B 或 C」
- 3 級作用域:全域、按 key 組、按 key——first-match-wins,同 order 下全域優先
- 白名單模式:預設拒絕 + 單條顯式 allow——新出現的未知客戶端預設被拒
- 規則同樣作用於模型列表路由(/v1/models),被拒客戶端端到端鎖死
- ReDoS-safe 線性時間正則引擎——病態 pattern 在載入期就被拒,而非請求期

## FAQ
### 客戶端能偽造 X-Forwarded-For 繞過規則嗎?
能。X-Forwarded-For 是客戶端可偽造的頭,只有前面有可信反向代理覆寫它才可靠;否則惡意客戶端可任意填。真正的 IP 准入應優先用閘道器直接看到的源 IP,配 TRUSTED_PROXIES。

### key 是對的,為什麼還是 403?
准入規則同樣作用於模型列表路由。被拒的客戶端可能在第一次 /v1/models 呼叫時就被攔。檢查是否有 Header ACL 規則命中;且預設拒絕模式下,匹配不到任何 allow 規則的客戶端一律被拒。

### 能寫「header 不含 X 才放行」嗎?
單條正則表達不了——引擎不支援 lookahead。反向編排:把預設動作設為拒絕,再加一條「含 X 則 allow」的規則,未命中的請求自然落到預設拒絕。

- [完整教程:設定 Header ACL(docs 站)](https://docs.gatellm.io/zh-CN/howto/configure-header-acl)

## 相關頁面
- [首頁](https://www.gatellm.io/zh-TW/index.md)
- [定價](https://www.gatellm.io/zh-TW/pricing.md)
- [成本計算器](https://www.gatellm.io/zh-TW/calculator.md)
- [關於](https://www.gatellm.io/zh-TW/about.md)
- [預約示範](https://www.gatellm.io/zh-TW/demo.md)
- [常見問題](https://www.gatellm.io/zh-TW/faq.md)
- [比較 AI 閘道](https://www.gatellm.io/zh-TW/compare.md)
- [比較 LiteLLM](https://www.gatellm.io/zh-TW/compare/litellm.md)
- [比較 OpenRouter](https://www.gatellm.io/zh-TW/compare/openrouter.md)
- [比較 Alibaba Cloud AI Gateway](https://www.gatellm.io/zh-TW/compare/alibaba-cloud.md)
- [比較 Azure API Management](https://www.gatellm.io/zh-TW/compare/azure-apim.md)
- [比較 Apigee](https://www.gatellm.io/zh-TW/compare/apigee.md)
- [比較 Cloudflare AI Gateway](https://www.gatellm.io/zh-TW/compare/cloudflare.md)
- [比較 Kong AI Gateway](https://www.gatellm.io/zh-TW/compare/kong.md)
- [比較 Portkey](https://www.gatellm.io/zh-TW/compare/portkey.md)
- [LiteLLM vs Kong AI Gateway 比較](https://www.gatellm.io/zh-TW/compare/litellm-vs-kong.md)
- [LiteLLM vs OpenRouter 比較](https://www.gatellm.io/zh-TW/compare/litellm-vs-openrouter.md)
- [LiteLLM vs Portkey 比較](https://www.gatellm.io/zh-TW/compare/litellm-vs-portkey.md)
- [場景方案](https://www.gatellm.io/zh-TW/use-cases.md)
- [降低呼叫成本](https://www.gatellm.io/zh-TW/use-cases/reduce-cost.md)
- [達成高可用](https://www.gatellm.io/zh-TW/use-cases/high-availability.md)
- [多租戶隔離](https://www.gatellm.io/zh-TW/use-cases/multi-tenant.md)
- [合規與稽核](https://www.gatellm.io/zh-TW/use-cases/compliance-audit.md)
- [從症狀排障](https://www.gatellm.io/zh-TW/use-cases/troubleshooting.md)
- [混合多供應商模型堆疊](https://www.gatellm.io/zh-TW/use-cases/mixed-model-stack.md)
- [在 Office 內自架 AI](https://www.gatellm.io/zh-TW/use-cases/self-hosted-office-ai.md)
- [Token 用量可見性與歸因](https://www.gatellm.io/zh-TW/use-cases/token-ops.md)
- [Token FinOps: AI 支出分攤與管控](https://www.gatellm.io/zh-TW/use-cases/token-finops.md)
- [MCP 工具治理](https://www.gatellm.io/zh-TW/use-cases/mcp-tool-governance.md)
- [為所有模型統一加入網路搜尋](https://www.gatellm.io/zh-TW/use-cases/web-search-grounding.md)
- [多 Key 輪替與備援](https://www.gatellm.io/zh-TW/use-cases/multi-key-pooling.md)
- [強制模型使用政策](https://www.gatellm.io/zh-TW/use-cases/enforce-model-policy.md)
- [用戶端不暴露模型選擇](https://www.gatellm.io/zh-TW/use-cases/automatic-model-tiering.md)
- [一種協定,任何模型](https://www.gatellm.io/zh-TW/use-cases/one-protocol-any-model.md)
- [Office / Microsoft 365 增益集](https://www.gatellm.io/zh-TW/office-addin.md)
- [術語表](https://www.gatellm.io/zh-TW/glossary.md)
- [模型目錄](https://www.gatellm.io/zh-TW/models.md)
- [SDK 與框架整合](https://www.gatellm.io/zh-TW/integrations.md)
- [AI Coding Agent 與 Harness](https://www.gatellm.io/zh-TW/coding-agents.md)
- [安全性與合規](https://www.gatellm.io/zh-TW/security.md)