---
title: "限制大模型 API 密钥只能从你的服务器 IP 调用 | BroadRouter"
description: "用 IP 白名单保护 BroadNet Inference 密钥，把推理密钥和控制台凭证分开，并在几秒内吊销泄露的密钥。附 curl 示例。"
url: https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。[阅读英文原文](https://broadrouter.com/guides/api-keys-ip-allow-lists/)（2026-11-16 更新）。

# 用 IP 白名单把 API 密钥锁定到你的服务器

更新于 2026-11-16

把服务器的出站 IPv4 或 IPv6 地址或 CIDR 网段加入账户白名单，最多 32 条。新建密钥会继承这个列表，除非创建时传入 allowed\_ips。来自其他地址的请求会收到 403，白名单变更或吊销会在五秒内生效。

密钥泄露是 API 账单失控最常见的原因。BroadNet Inference 提供两种控制手段：IP 白名单和快速吊销。

## 两种凭证

| 凭证 | 用途 | 应视为 |
| --- | --- | --- |
| 推理密钥 | 向 `/v1/*` 发送模型请求 | 一个应用或智能体专用的机密 |
| 控制台凭证 | 账户自动化：密钥、允许的 IP、购买 | 完整的账户权限 |

两者都只显示一次。控制台只保存 SHA-256 哈希，因此无法再次显示密钥。按量付费推理密钥自创建起有效一年，一个账户最多可持有十个有效密钥。

## 设置白名单

在账户页面每行添加一个 IPv4 或 IPv6 地址或 CIDR 网段，最多 32 条。空列表表示不做 IP 限制。新建密钥会继承这个账户列表。对每个 API 请求，边缘节点都会检查 Cloudflare 报告的客户端 IP。

如果要用脚本管理账户列表，`PUT /portal/allowed_ips` 一次调用即可整体替换它（需要控制台凭证）。

用控制台凭证创建密钥时，可以给这个密钥单独指定列表：

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

单个密钥的 `allowed_ips` 会替换该密钥继承的账户列表。响应中只包含一次原始密钥，请立即保存。

## 快速吊销泄露的密钥

`DELETE /portal/keys/{alias}` 吊销按量付费密钥，`DELETE /portal/keys/hourly/{alias}` 吊销按小时密钥（原购买费用不退）。吊销或白名单变更后，新请求会在五秒内被拒绝。

```bash
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
```

把 `KEY_ALIAS` 设为账户页面或 `GET /portal/keys` 中显示的该密钥别名。别名不是密钥本身。如果控制台凭证泄露，用 `DELETE /portal/credentials/{id}` 吊销它：它能做你的账户能做的一切。

## 故障排查

-   **已列入白名单的服务器收到 403。** 边缘节点看到的是你的公网出站地址，而不是服务器的内网 IP。位于 NAT 网关、代理或负载均衡器后面的服务器，出站时用的是该设备的地址。启用了 IPv6 的服务器即使你只列了它的 IPv4 地址，也可能走 IPv6 出站。请列出请求实际出站的地址，或覆盖它的 CIDR 网段。
-   **新密钥忽略了账户列表。** 单个密钥的 `allowed_ips` 数组会替换该密钥继承的账户列表。检查创建时传入了什么。
-   **409 `key_limit_reached`。** 账户已有十个有效密钥。吊销一个不再使用的。
-   **吊销后几秒内请求仍然成功。** 在缓存同步的最多五秒内，这是正常的。

来自不在列表中的地址的请求会收到 403。参见 [BroadNet 全部错误码及何时重试](https://broadrouter.com/zh/guides/errors-and-retries/)。要用新密钥发出第一个请求，请按照 [OpenAI Python SDK 指南](https://broadrouter.com/zh/guides/openai-python-sdk/)操作。[IP 白名单术语条目](https://broadrouter.com/zh/glossary/ip-allow-list/)从一般角度解释了这个概念。

_[image: A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."]_

## 本指南涉及的术语

[IP 白名单（IP allow list）](https://broadrouter.com/zh/glossary/ip-allow-list/)

IP 白名单是一种安全控制：只接受来自列出的 IP 地址或 CIDR 网段的请求，拒绝其他所有请求。用在 API 上，它能限制密钥泄露造成的损失，因为密钥在不在列表中的网络上无法使用。

[API 密钥（API key）](https://broadrouter.com/zh/glossary/api-key/)

API 密钥是一串用于识别和授权 API 调用方的秘密字符串。大模型 API 通常要求把它放在 Authorization: Bearer 请求头里，任何持有该密钥的人都能发起请求，费用记在拥有该密钥的账户上。

[AI 智能体（AI agent）](https://broadrouter.com/zh/glossary/agent/)

AI 智能体是由语言模型自主决定步骤、朝目标推进的系统：它决定调用哪些工具、读取结果，然后重复，直到给出最终回答或触及上限。在固定位置调用模型的固定脚本，通常称为工作流（workflow）。

## 常见问题

### 怎么让大模型 API 密钥只能从我服务器的 IP 调用？

在 BroadNet 账户页面把服务器的公网出站地址或 CIDR 网段加入账户白名单，或者通过 POST /portal/keys 创建密钥时传入 allowed\_ips。来自其他任何地址的请求都会被拒绝并返回 403。

### 白名单为空会拦截所有请求吗？

不会。空列表表示不做 IP 限制，密钥可以从任何地址使用。至少添加一条，限制才会生效。

### 可以用推理密钥创建其他密钥吗？

不可以。推理密钥只能调用 /v1/\* 模型路由。创建和吊销密钥、修改允许的 IP 以及购买按小时密钥都需要控制台凭证，它拥有完整的账户权限。

### 吊销泄露的密钥多快生效？

BroadNet 的文档说，吊销或白名单变更后五秒内新请求就会被拒绝，因为授权结果可能会在复制缓存中保留这么久。

## 相关指南

-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/)

用你的真实业务负载试一试。新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-api-keys-ip-allow-lists&utm_content=page-cta) ·

**来源**

-   [BroadNet Inference API 参考文档：IP 白名单（核对于 2026-11-16）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-api-keys-ip-allow-lists&utm_content=sources#ip-allow-lists)
-   [BroadNet Inference API 参考文档：按小时密钥与门户凭证（核对于 2026-11-16）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-api-keys-ip-allow-lists&utm_content=sources#hourly-keys)
-   [BroadNet Inference API 参考文档：限制（密钥有效期与有效密钥数）（核对于 2026-11-16）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-api-keys-ip-allow-lists&utm_content=sources#limits)
