ToolJet 企业版白标White Label配置指南替换 Logo、Favicon 与页面标题【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJetToolJet 的企业版提供了 White Label白标功能允许你彻底移除 ToolJet 平台自带的品牌标识替换为自己的 Logo、Favicon 与页面标题从而掌控 ToolJet 应用的可视化品牌形象。本文基于 ToolJet 2.50.0-LTS 版本文档并结合仓库中的前后端源码带你完整掌握白标功能的配置入口、参数规范、底层实现原理与适用版本边界。什么是白标White LabelWhite Label 是一个面向企业版Enterprise / Paid用户的品牌定制能力。启用后你可以将 ToolJet 平台中出现的 ToolJet 品牌元素整体替换为自有品牌包括应用 LogoApplication Logo显示在登录页、仪表盘Dashboard以及应用编辑器app-editor中的 LogoFavicon显示在浏览器标签页上的小图标页面标题Page Title显示在浏览器标签页上的文字。通过这三个要素的组合你可以让最终用户在使用内部工具、仪表盘或业务应用时看到的是完全属于自己企业的视觉标识实现无缝且个性化的用户体验。配置方式从仪表盘进入白标设置无论你是自托管self-hosted部署还是使用 ToolJet Cloud配置入口都是一致的登录 ToolJet 后点击仪表盘左下角的齿轮图标选择Settings设置在设置页面中切换到White labelling白标标签页在该页面中依次配置以下三项内容。参数明细与推荐尺寸配置项说明推荐规格Application Logo填写你想要作为应用 Logo 的图片 URL宽度130px高度26pxFavicon填写你想要作为站点 Favicon 的图片 URL宽度32px、高度32px或宽度16px、高度16pxPage Title填写应用标题文字推荐长度 50–60 个字符ToolJet Cloud 用户注意事项如果你使用的是ToolJet Cloud进入白标页面的路径完全相同齿轮图标 →Settings→White labelling。Cloud 版本同样支持上述三个配置项其配置顺序为Application LogoURL推荐130px × 26pxPage Title文本推荐 50–60 个字符FaviconURL推荐32px × 32px或16px × 16px。说明文档中 Cloud 页面展示的配置项顺序略有不同Logo → 标题 → Favicon但三项配置均可配置功能与自托管版本一致。底层实现从数据模型到前端渲染白标功能在仓库中有完整的前后端实现了解这些实现可以帮助你更好地理解该功能的边界与行为。服务端数据模型白标配置在数据库中由white_labelling表承载实体定义见 white_labelling.entity.ts。核心字段包括logovarchar 255应用 Logo 地址textvarchar 50白标文字即页面标题/品牌名faviconvarchar 255Favicon 地址banner_imagevarchar 1024可空横幅图地址organization_id唯一约束指向所属组织null 值唯一用于表示实例级instance-level白标配置这一设计在实体注释中有明确说明。从实体注释//null values are unique, handle in migration to only allow a single row with null orgId (AddUniqueConstraintForNullOrganizationId)可以推断实例级白标与工作区级白标共用同一张表通过organization_id是否为空来区分。服务端模块与接口服务端白标模块位于 server/src/modules/white-labelling由 NestJS 组织包括 controller、service、repository、dto、ability 权限校验等子模块。控制器controller.ts 暴露了GET /white-labelling、PUT /white-labelling、GET /white-labelling/:organizationId、PUT /white-labelling/:organizationId四个路由分别对应实例级与工作区级的读取/更新。DTO 校验dto/index.ts 中UpdateWhiteLabellingDto定义了white_label_logo、white_label_text、white_label_favicon、white_label_banner四个可选的字符串字段并统一通过sanitizeInput做输入清洗防止注入风险。默认值constant/index.ts 定义了DEFAULT_WHITE_LABELLING_SETTINGS默认 Logo 为assets/images/tj-logo.svg默认文字为ToolJet默认 Favicon 为assets/images/logo.svg。同时定义了GET、UPDATE、GET_ORGANIZATION_WHITE_LABELS、UPDATE_ORGANIZATION_WHITE_LABELS四个功能点FEATURE_KEY与InitFeature装饰器配合做能力开关。值得注意的是当前仓库中 service.ts 的getProcessedSettings仅返回默认配置并将is_default置为true而updateSettings及控制器中的写操作路由目前直接抛出异常。从源码结构看白标能力的完整读写逻辑在 2.50.0-LTS 版本中主要由企业版ee代码或后续版本承载社区版CE代码保留了模块骨架与默认值。前端如何应用白标前端侧的白标逻辑集中在 whiteLabelling.jssetFaviconAndTitle(location)动态替换head中link[relicon]的href并按路由登录、仪表盘、设置等拼接页面标题格式为页面名 | 白标文字applyWhiteLabelling()在拉取到白标设置后立即更新document.title与 FaviconfetchWhiteLabelDetails(organizationId)通过 whiteLabellingStore.js 中的 Zustand store 拉取并缓存配置同时同步到 AppBuilder 的whiteLabellingSlicecheckWhiteLabelsDefaultState()用于判断当前配置是否仍为默认值即文字是否为ToolJet、Logo 是否为assets/images/tj-logo.svg等。前端通过 white-labelling.service.js 发起请求其行为与版本强相关Cloud 版且携带工作区 ID 时请求/white-labelling/:organizationId工作区级接口CE、EE 或未携带工作区 ID 时请求/white-labelling实例级接口。也就是说白标配置既可以是实例级整个部署统一生效也可以是工作区级按组织区分具体取决于你的部署版本与请求路径。邮件模板中的白标应用白标文字还被用于系统邮件模板。在 server/src/mails 目录下invite_user.hbs、otp_verify.hbs、reset_password.hbs、password_expired.hbs等模板均引用了whiteLabelText与whiteLabelLogo变量。例如header.hbs 中若whiteLabelText不等于ToolJet则使用自定义 Logo 渲染邮件头部base_template.hbs 中根据whiteLabelText是否为ToolJet决定是否展示 ToolJet 品牌信息。可以推断白标配置不仅影响浏览器端界面还会同步作用于邀请、OTP 验证、密码重置等系统邮件的品牌展示。使用前提与版本边界白标属于Paid feature付费功能文档头部明确标注了该标签。自托管社区版CE与未授权的实例无法获得完整的白标写入能力仓库中的服务端写路由当前直接抛出NotFoundException即为佐证。本文描述的 UI 配置入口适用于ToolJet 2.50.0-LTS文档所覆盖的自托管与 Cloud 场景。若你的部署是较新版本白标相关实现可能已迁移至独立的WhiteLabelsEntity如数据迁移 1736921797727-MoveInstanceWhiteLabelsToWhiteLabelsEntity.ts 所示建议以对应版本文档为准。小结白标功能让企业能够将 ToolJet 平台完全定制为自己的品牌形象——从登录页 Logo、浏览器 Favicon 到页面标题再到系统邮件中的品牌展示。通过仪表盘左下角齿轮图标 →Settings→White labelling即可完成全部配置底层则由white_labelling表、NestJS 模块与前端 Zustand store 动态 DOM 操作共同支撑并区分实例级与工作区级两种作用域。对于计划将 ToolJet 作为交付方案对外提供服务或希望统一内部品牌形象的企业这是一个低成本、高价值的能力。【免费下载链接】ToolJetOpen-source foundation of ToolJet AI - the enterprise app generation platform for internal tools, dashboards, business applications, workflows and AI agents. Build visually, from a prompt, or from Claude Code, Codex and Cursor over MCP 项目地址: https://gitcode.com/GitHub_Trending/to/ToolJet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
