SuperAPI AI 工具集

iblai-env

部署与运维

查看项目

更新于 10-15 22:16

技能介绍

用途:为 ibl.ai 应用初始化并管理环境变量,把项目根目录下简单的 .env.example 扩展为可用的 .env.local。

前提条件:需要可用的 iblai CLI(可用 iblai --version 检查);若不可用,先运行 /iblai-install。

基本用法:先把示例文件复制到应用根目录:cp .env.example .env.local;然后设置平台 Key:iblai config set NEXT_PUBLIC_MAIN_TENANT_KEY your-actual-key。通过 npx 也可执行:npx @iblai/cli config set NEXT_PUBLIC_MAIN_TENANT_KEY your-actual-key。最后验证:iblai config show(或 npx @iblai/cli config show)。

变量映射:.env.example 中只有两个值——DOMAIN(默认 iblai.app,所有 ibl.ai 服务的基础域名)和 PLATFORM(你的租户/平台 Key)。它们映射为应用所需环境变量:NEXT_PUBLIC_API_BASE_URL 为 https://api.{DOMAIN};NEXT_PUBLIC_AUTH_URL 为 https://login.{DOMAIN};NEXT_PUBLIC_BASE_WS_URL 为 wss://asgi.data.{DOMAIN};NEXT_PUBLIC_PLATFORM_BASE_DOMAIN 为 {DOMAIN};NEXT_PUBLIC_MAIN_TENANT_KEY 为 {PLATFORM}。

使用 CLI 管理:iblai config 命令可直接管理 .env.local。查看当前配置(含各变量取值与来源):iblai config show;设置平台 Key:iblai config set NEXT_PUBLIC_MAIN_TENANT_KEY my-org;若为自定义部署,可覆盖默认域名,分别设置 NEXT_PUBLIC_API_BASE_URL、NEXT_PUBLIC_AUTH_URL、NEXT_PUBLIC_BASE_WS_URL、NEXT_PUBLIC_PLATFORM_BASE_DOMAIN。

默认与自定义域名:使用默认免费租户时,只需设置平台 Key,其余自动指向 iblai.app 端点。自定义域名(如 my-company.com)时,需设置 DOMAIN=my-company.com、PLATFORM=my-company,并逐个用 iblai config set 把 NEXT_PUBLIC_* 变量中的 iblai.app 替换为自有域名。

获取租户 Key:开发可默认使用免费租户 iblai;如需自有品牌租户,可在 https://iblai.app 注册,租户 Key 显示在 iblai.app 仪表板的 Settings 中。

限制:资料未说明支持的操作系统、版本要求、权限范围及收费情况,暂未提供。