ibl.ai/os白标化实战:打造完全自有品牌AI agent平台的完整指南
ibl.ai/os白标化实战:打造完全自有品牌AI agent平台的完整指南
ibl.ai/os 是一个开源的 AI agent 平台,支持多 LLM 提供商、实时聊天、语音通话、文档训练、分析、SSO 认证与可嵌入组件。它原生内置了 whitelabeling(白标化) 能力——多租户隔离、自定义品牌、Logo、免责声明和嵌入式组件,让你用自己的品牌运营一套完整的 AI agent 平台,而不必重写代码。
为什么 ibl.ai/os 适合白标部署?
白标化不是"后期贴个 Logo"这么简单。ibl.ai/os 在设计上就把它当一等公民:
| 能力 | 说明 |
|---|---|
| 🏢 多租户隔离 | 完整租户隔离,每个组织独立的品牌与用户管理 |
| 🎨 品牌定制 | 自定义 Logo、免责声明、顶部横幅文案与颜色 |
| 🔐 SSO & RBAC | OAuth / OIDC / SAML 单点登录 + 细粒度角色权限 |
| 🧩 嵌入模式 | iframe 嵌入、自定义域名、API 密钥 |
| 🌍 多语言 | 内置英文、中文、西语、法语翻译 |
| 💳 Stripe 计费 | 订阅、免费试用、按量计费 |
所有配置通过环境变量和租户级设置完成,一份代码库可服务任意数量的品牌。
快速上手:3 步克隆并启动
白标的第一步只是把它跑起来。ibl.ai/os 基于 React 19 + Next.js + Redux Toolkit + Radix UI + Tailwind CSS 构建,部署非常轻:
git clone https://gitcode.com/gh_mirrors/os69/os
cd os
pnpm install
第二步:复制环境变量模板,填入你的租户信息:
cp .env.example .env.local
第三步:启动开发服务器,打开 http://localhost:3000 即可看到平台界面:
pnpm dev
💡 完整的开发指南见 docs/development.md,部署选项见 docs/standalone-deployment.md。
白标六大核心杠杆
1. 租户(Tenant):品牌隔离的根
每个品牌对应一个 Tenant,通过 NEXT_PUBLIC_MAIN_TENANT_KEY 和 NEXT_PUBLIC_TENANT 指定。租户数据结构(组织名、门户地址、LMS 地址等)定义在 features/tenants/types.ts,相关 API 封装在 features/tenants/api-slice.ts。
白标部署时,还可以用编译期变量 IBL_TENANT 把客户端"锁"在指定租户上——同一个代码库可以打包出品牌 A、品牌 B 两套完全不同的产品,且用户看不到租户切换入口。
2. 品牌外观:Logo、横幅与支持信息
打开 .env.example,白标相关的变量一目了然:
NEXT_PUBLIC_MENTOR_SETTINGS_DISCLAIMER—— 自定义全局免责声明文案NEXT_PUBLIC_APP_BANNER_TEXT/NEXT_PUBLIC_APP_BANNER_LINK—— 顶部推广横幅文案与跳转,组件在 components/top-trial-banner/top-trial-banner.tsxNEXT_PUBLIC_SUPPORT_EMAIL/NEXT_PUBLIC_HELP_CENTER_URL—— 把"支持邮箱"和"帮助中心"指向你自己的客服体系NEXT_PUBLIC_ENABLE_ADVERTISING—— 控制登录页广告位开关NEXT_PUBLIC_DEFAULT_EMBED_CSS_URL—— 嵌入组件的默认样式表地址
所有 NEXT_PUBLIC_* 变量在构建时注入;Web/Docker 部署还能在容器启动时通过 entrypoint.sh 写入 public/env.js 做运行时覆盖,同一镜像可服务多个品牌。
3. Agent 级定制:每个智能体都是你的品牌代言
白标不止是"换皮",你还可以逐个定制 agent。在编辑 agent 的设置页中(源码:components/modals/edit-mentor-modal/settings-tab.tsx),可配置身份、头像、描述与外观。
更进一步,嵌入页签(components/modals/edit-mentor-modal/tabs/embed-tab.tsx)提供了 Advanced CSS 和 Advanced JS 两个入口——直接注入自定义样式与脚本,对嵌入的 agent 做像素级定制,无需改源码。
agent 的能力扩展同样丰富:MCP 连接器可以接入 GitHub、Notion、Slack 等外部工具,让你的 agent 拥有独属于你的工作流能力。
4. 记忆与知识库:让 agent 懂你的业务
每个 agent 可独立配置记忆系统——知识缺口、学习目标、用户偏好,实现"越聊越懂你"。记忆配置界面源码位于 components/modals/edit-mentor-modal/tabs/ 目录下。
5. 免责声明与用户协议:品牌合规的最后一环
白标产品面向你自己的用户,合规文案必须自主可控。disclaimers 页签(components/modals/edit-mentor-modal/disclaimers-tab.tsx)支持自定义免责声明与用户协议列表,默认文案来自 constants/disclaimer.ts。
6. 多语言与桌面端品牌
- 多语言:翻译文件位于
messages/目录(zh.json、en.json、es.json、fr.json),配合 i18n 配置 i18n/config.ts 即可输出中文界面。 - 桌面/移动 App:原生应用是 Tauri 的 webview 壳,品牌名、图标、签名身份在 src-tauri/tauri.conf.json 中配置;Android 端品牌化脚本见 scripts/android-branding.sh。用
TAURI_DEV_URL把壳指向你的 Web 部署,即可发布"自己的"桌面应用。
部署到自有域名:一份规则搞定所有平台
无论 Web 还是移动端,白标部署的心智模型只有一条:
先把 Web 应用部署在你的域名下,再用
TAURI_DEV_URL=https://your-domain重新构建各个原生壳。
# Web 独立部署
pnpm build # 输出自包含的 .next/standalone Node 服务
node server-wrapper.js
# 或 Docker(推荐,支持运行时品牌切换)
docker build -t iblos .
docker run -p 5000:5000 --env-file .env iblos
各平台的构建与签名清单(macOS 公证、Windows 签名、iOS/Android 深链与 AASA)在 docs/platform-deployment.md 中有完整表格,按表操作即可。
常见陷阱与排查
- 页面空白 / 卡在加载动画:多为旧进程占用端口或静态资源路径嵌套问题,先
lsof -nP -iTCP:3000 -sTCP:LISTEN清理残留进程。 - 品牌变量不生效:确认变量名带
NEXT_PUBLIC_前缀,且重新执行了pnpm build(构建时注入)。 - 多租户混淆:设置了
IBL_TENANT后客户端会强制锁定该租户,登录其他租户会被自动登出——这正是白标想要的效果。
总结
ibl.ai/os 的白标化路径可以归纳为六步:克隆 → 配租户 → 换品牌 → 定制 agent → 部署自有域名 → 打包原生壳。它把 whitelabeling、多租户、SSO、RBAC、Stripe 计费这些"企业级"能力做成了内置特性而非插件,配合 Advanced CSS/JS 注入与编译期租户锁定,你可以用一份代码库同时运营任意多个 AI agent 品牌。
关键资料速查
- 环境变量模板:.env.example
- 开发指南:docs/development.md
- 平台部署指南:docs/platform-deployment.md
- 租户类型定义:features/tenants/types.ts
- 嵌入与高级 CSS/JS:components/modals/edit-mentor-modal/tabs/embed-tab.tsx
- 免责声明默认文案:constants/disclaimer.ts
- E2E 白标/多租户用例:e2e/journeys/32-multi-tenancy-advertising-and-auth-customization.spec.ts





