ibl.ai/os白标化实战:打造完全自有品牌AI agent平台的完整指南

原创2026-10-27 14:59:391,722 阅读

ibl.ai/os白标化实战:打造完全自有品牌AI agent平台的完整指南

ibl.ai/os 是一个开源的 AI agent 平台,支持多 LLM 提供商、实时聊天、语音通话、文档训练、分析、SSO 认证与可嵌入组件。它原生内置了 whitelabeling(白标化) 能力——多租户隔离、自定义品牌、Logo、免责声明和嵌入式组件,让你用自己的品牌运营一套完整的 AI agent 平台,而不必重写代码。

ibl.ai/os 白标 AI agent 平台界面: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.ai/os agent 发现与访问权限配置界面

白标部署时,还可以用编译期变量 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.tsx
  • NEXT_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 做运行时覆盖,同一镜像可服务多个品牌。

ibl.ai/os agent 配置面板:LLM、提示词与安全过滤器

3. Agent 级定制:每个智能体都是你的品牌代言

白标不止是"换皮",你还可以逐个定制 agent。在编辑 agent 的设置页中(源码:components/modals/edit-mentor-modal/settings-tab.tsx),可配置身份、头像、描述与外观。

ibl.ai/os agent 基础设置:身份、描述与外观

更进一步,嵌入页签(components/modals/edit-mentor-modal/tabs/embed-tab.tsx)提供了 Advanced CSS 和 Advanced JS 两个入口——直接注入自定义样式与脚本,对嵌入的 agent 做像素级定制,无需改源码。

agent 的能力扩展同样丰富:MCP 连接器可以接入 GitHub、Notion、Slack 等外部工具,让你的 agent 拥有独属于你的工作流能力。

ibl.ai/os MCP 连接器:接入 GitHub、Notion、Slack 等外部工具

4. 记忆与知识库:让 agent 懂你的业务

每个 agent 可独立配置记忆系统——知识缺口、学习目标、用户偏好,实现"越聊越懂你"。记忆配置界面源码位于 components/modals/edit-mentor-modal/tabs/ 目录下。

ibl.ai/os agent 记忆设置:知识缺口、学习目标与偏好

5. 免责声明与用户协议:品牌合规的最后一环

白标产品面向你自己的用户,合规文案必须自主可控。disclaimers 页签(components/modals/edit-mentor-modal/disclaimers-tab.tsx)支持自定义免责声明与用户协议列表,默认文案来自 constants/disclaimer.ts。

6. 多语言与桌面端品牌

部署到自有域名:一份规则搞定所有平台

无论 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 品牌。

关键资料速查

登录后查看全文
os