更换 Logo 与水印

需要把平台界面替换成自有品牌(Logo、网页标题、水印)并重新构建前端镜像时阅读

二次开发 / 前端定制
logoLogo水印watermark品牌定制换标白标OEMfavicon网页标题title前端镜像frontendkubeflow-dashboard-frontendbuild.sh

更换 Logo 与水印

前端品牌定制(Logo、favicon、网页标题、版权水印)通过仓库根目录下的 dev/common/ 完成:替换素材 → 运行构建脚本生成前端镜像并推送 → 更新 K8s 前端 deployment 镜像。

准备素材

dev/common/ 目录下已有占位素材,替换为你自己的即可:

  • logo.ico:favicon 图标
  • logo.png:主 Logo
  • logo.svg:矢量 Logo

构建步骤

  1. 替换素材:替换 dev/common/ 下的 logo.icologo.pnglogo.svg
  2. 登录镜像仓库:本地 docker login 到你的镜像仓库。若没有,可在腾讯云申请个人免费版镜像仓库。
  3. 改目标镜像名与标题:编辑 dev/common/build.sh,替换其中的前端目标镜像名和网页标题名。
    • 脚本默认把网页标题从 cube-studio 改成 智能AI平台,把 Cube Studio 字样替换成 AI Studio(即水印 / 版权文案),可按需修改。
    • 脚本默认构建并推送的镜像名为 ccr.ccs.tencentyun.com/cube-studio/kubeflow-dashboard-frontend-enterprise:common(使用 docker buildx build 构建 linux/amd64,linux/arm64 多架构镜像,Dockerfile 为 install/docker/dockerFrontend/Dockerfile)。记得替换为你自己仓库的名称。
  4. 执行构建:在 CubeStudio 项目根目录下执行:
    sh dev/common/build.sh
    
    脚本会自动替换 Logo、水印、标题,构建目标前端镜像并推送到你的仓库。

    脚本中区分了 mac 与 windows/linux 的 sed 写法(mac 用 sed -i "",linux 用 sed -i)。当前默认启用的是 mac 版,linux 下需把对应行注释切换一下。

  5. 更新 K8s deployment:推送成功后,在 K8s 的 infra 命名空间下,把名为 kubeflow-dashboard-frontend 的 deployment 的镜像名改成你新构建的镜像,K8s 会自动重启前端 Pod。

    deployment 名称见 install/kubernetes/cube/base/deploy-frontend.yamlname: kubeflow-dashboard-frontend,默认镜像 ccr.ccs.tencentyun.com/cube-studio/kubeflow-dashboard-frontend)。注意基础 deployment 镜像名与 build.sh 构建的镜像名(带 -enterprise:common 后缀)不同,更新 deployment 时填你实际构建推送的那个。

  6. 刷新页面:前端 Pod 重启后,强制刷新浏览器页面(Ctrl/Cmd + Shift + R)即可看到新 Logo 与标题。

相关

最后更新 2026-07-04完整文档以官方仓库为准:GitHub Wiki