跳到主要内容
版本：Dev

组织与环境

组织和环境定义了 AISIX Cloud 控制面的两个主要作用域。组织确定所有权和共享管理边界；环境确定哪些 AISIX 网关会接收投射的配置。

这种划分将账号管理与流量行为分离。成员、团队和模型服务提供方凭证属于组织；模型、调用方 API Key、策略和缓存策略属于承载流量的环境。

对于实时流量，环境通常是最先需要确认的作用域。保存的环境资源只有属于目标 AISIX 网关关联的环境时，才会影响实时流量。

作用域模型​

AISIX Cloud 控制面可以管理多个网关和多组网关资源。组织和环境能清晰表达哪个团队拥有该部署，以及哪个 AISIX 网关接收每个环境级资源。

组织作用域​

组织是 AISIX 控制面中最高层级的所有权边界，也是成员、团队、共享管理和服务提供方凭证的作用域。

On-Premises 控制面启动时只有一个组织 Default，它随首个管理员一同创建，可以在组织设置中重命名。在 On-Premises 控制面上，任何人都无法通过控制台或 API 创建更多组织。从 1.5.x 或更早版本升级的控制面可能仍有多个组织，其控制台在这些组织合并为一个之前会被锁定。不属于任何组织的账号会看到联系管理员的提示，管理员可以把它邀请到某个组织中。

组织作用域适合用来理解账号归属和共享管理。当已保存的网关资源没有影响实时流量时，通常不应首先检查组织作用域。

环境作用域​

环境是聚合网关资源并将其投射到关联的一个或多个 AISIX 网关的单位。

环境作用域会把已保存的控制面状态转化为实时网关行为。如果资源属于另一个环境，即使它存在于控制面中，也不会影响你正在测试的网关。

当资源没有按预期影响流量时，请先确认该资源与目标 AISIX 网关属于同一环境。对于模型服务提供方密钥，还需要确认该密钥允许在该环境中使用。

创建或选择环境​

在控制台中打开 Environments。

要创建环境，请选择 New environment，输入显示名称，然后选择 Create environment。确认页面会显示环境 ID，并提供指向该环境 Data planes 视图的链接。模型服务提供方设置示例使用该 ID 作为 ENV_ID，请将其复制下来。

要使用现有环境，请从环境列表中将其选中。环境 ID 显示在其显示名称下方。

重命名环境​

在环境列表中选择环境旁边的铅笔图标，输入新名称并保存。名称在组织内唯一，因此与其他环境重名会被拒绝。

环境 ID 不会改变，网关当前承载的任何服务也不会改变。关联的 AISIX 网关通过 ID 识别自己所属的环境，因此重命名只是控制面上的标签变更——运行中的数据面不会重新配置，流量也不会中断。引用 ENV_ID 的脚本和设置示例继续有效。

通过环境级角色绑定获得权限的成员无法重命名环境。重命名需要组织级的环境写权限，与创建和删除环境所需的权限相同。

删除环境​

删除环境前，请先将流量从所有已连接的 AISIX 网关迁走，再停止这些网关。删除控制面环境不会排空网关流量。

警告

删除环境不可撤销。该操作会移除环境中的模型、调用方 API Key、策略、网关注册以及其它环境范围记录。

打开 Environments，选择环境的删除操作并查看确认信息。输入环境的显示名称，然后选择 Delete。

AISIX Cloud 会先撤销环境中有效的网关证书，再删除环境记录。如果撤销失败，环境及其资源会保留，以便重试删除操作。

删除环境后，控制面还会随即撤回该环境的配置，因此仍保持连接的网关会停止提供该环境的配置，而不是继续使用最后收到的配置。在较早版本的控制面上删除的环境所遗留的配置，会在控制面升级后自动移除。

控制台语言​

控制台和控制面发出的邮件提供英文和中文两种语言。最多有四项设置可以指定语言，按顺序检查，第一个指定了英文或中文的生效：语言选择器、组织语言、浏览器语言和部署默认语言。

语言选择器​

登录相关页面的右上角都有语言选择器，包括登录、注册、忘记密码、重置密码、设置密码、单点登录相关页面、选择组织、修改密码和组织合并页面。邀请页面上也有语言选择器；登录后，它位于顶栏中组织切换器的左侧。

可选项为 自动、English 和 中文。所选语言只保存在做出选择的浏览器中，不会随账号带到其他浏览器或设备。选择 自动 会清除该选择。

组织语言​

打开 设置，找到 语言 卡片。在 组织语言 中选择以下一项，然后选择 保存更改：

  • 不设置：使用各浏览器自身的语言，否则使用部署默认语言。该选项会显示当前生效的默认语言。
  • English。
  • 中文。

组织所有者和管理员可以更改此设置，其他成员只能查看。

语言的确定方式​

不同类型的页面按各自的顺序检查这些设置：

  • 组织内的页面：语言选择器，然后是当前组织的语言，然后是浏览器语言，最后是部署默认语言。在 SaaS 服务中，切换到另一个组织时，除非语言选择器中已有选择，控制台会切换为该组织的语言。
  • 从邮件链接打开的页面（接受邀请、设置密码、关联单点登录账号）：语言选择器，然后是该链接所属组织的语言，然后是浏览器语言，最后是部署默认语言。
  • 不属于任何组织的页面（登录、注册、密码相关页面、选择组织）：语言选择器，然后是部署中唯一组织的语言（仅 On-Premises），然后是浏览器语言，最后是部署默认语言。
  • 你在自己浏览器中请求的邮件：邮箱验证和忘记密码邮件依次使用语言选择器、唯一组织的语言（仅 On-Premises）、浏览器语言和部署默认语言。单点登录账号认领邮件在语言选择器之后，先检查认领所属组织的语言。
  • 管理员发给他人的邮件（成员邀请，以及设置或重置密码链接）：组织的语言，然后是部署默认语言。发送邮件的管理员的语言选择器和浏览器语言不起作用。

浏览器语言按浏览器的偏好顺序读取。第一个主语言标签为 en 或 zh 的语言生效，因此 zh-CN、zh-TW 和 zh-Hans 都视为中文，en-US 视为英文，其他语言会被跳过。没有任何设置指定英文或中文时，使用英文。

在 On-Premises 部署中，部署默认语言是 Helm 中的 ui.defaultLocale，参见控制台语言。

备注

部署默认语言过去决定整个控制台和所有邮件的语言，现在只作为兜底，且浏览器语言优先于它。因此，设置了 ui.defaultLocale: zh 的部署会对偏好英文的浏览器显示英文，反之亦然。若要让某个组织统一使用一种语言，请在 设置 中设置该组织的语言：组织语言优先于浏览器语言。

组织币种​

组织内的所有金额都使用同一种币种：模型价格、用量费用和预算。打开 设置，找到 币种 卡片。在 组织币种 中选择 美元（USD，$） 或 人民币（CNY，¥），然后选择 保存更改。新组织使用美元。

组织所有者和管理员可以更改此设置，其他成员只能查看。

价格按该币种手动录入，AISIX 不做任何换算。切换币种后，已记录的用量费用、预算上限和价格都保持原数值，此后按新币种解读。models.dev 价格目录以美元计价，因此人民币组织需要自行为在用的每个模型定价。详见模型定价。

删除组织​

组织的 Owner 可以删除该组织及其中的全部内容。删除无法撤销。

警告

删除组织会移除其所有环境以及环境中的模型、调用方 API Key、策略和网关注册，还会移除其成员的组织成员资格、团队、服务提供方密钥、MCP 服务器、A2A Agent、邀请、Admin Token、通知渠道、自定义角色，以及用量和审计记录。连接到其任一环境的每个网关都会被切断：其证书会被吊销，无法再从控制面获取配置。

确认删除后，访问会立即终止：该组织会从每个成员的组织列表中消失，其成员、邀请、Admin Token、单点登录连接及其建立的账号关联，以及（在 SaaS 服务上）其域名都会被移除，其环境会被删除，环境中的网关证书会被吊销。之后，组织存储的数据（如用量记录、审计日志和通知投递记录）会在后台移除，组织较大时可能需要一段时间。在后台移除完成之前，该组织的 slug 会一直被占用，新组织无法使用同一个 slug。

有密码的成员账号会保留。成员只会失去在被删除组织中的成员资格，仍可登录其所属的其他组织。没有密码且不属于其他任何组织的账号会随组织一起删除，与单独移除该成员时相同。这包括直接创建的成员、通过 SCIM 预配的成员，以及首次登录时由单点登录创建的成员，它们的邮箱地址也随之释放。

删除前，请像删除环境前一样，先将流量从该组织的网关迁走并停止这些网关。如果之后可能还需要该组织的配置，请先导出备份。

  1. 以该组织 Owner 的身份登录，打开 Settings。
  2. 在 Delete organization 卡片中查看删除将移除的内容，然后选择 Delete organization。
  3. 输入组织名称进行确认，然后确认删除。

删除后，控制台会切换到你所属的另一个组织；如果你不属于任何组织，会提示你的账号不属于任何组织。

只有 Owner 可以删除组织，其他成员会收到 403。在 On-Premises 控制面上，部署中唯一的组织无法删除：删除按钮会被禁用并显示原因，API 返回 409 LAST_ORGANIZATION。

下一步​

继续阅读 Admin Token，创建模型服务提供方设置示例所使用的组织级凭证。创建 Token 后，请连接 AISIX 网关到应接收该配置的环境。

若要备份、迁移或复现一个已有的组织，请参阅组织备份与恢复。