WebUI界面背景图修改

1,请问Web访问BMC的登录界面背景图是否可以直接通过“图片替换”的方式修改?或者说有没有一些其它简易的方法

尝试过的解决方案

尝试直接替换以下路径的login.jpg文件,重新构建后发现并未生效

/home/zhao/mycode/openubmc/manifest/temp/build_openUBMC_debug_stable/conan_install/webui/opt/bmc/web/htdocs/image/login.jpg

答案内容由AI生成,仅供参考:

:white_check_mark: 总结

项目 是否支持 说明
直接替换文件修改背景图 :cross_mark: 不推荐 构建系统不会保留临时路径修改
使用白牌包替换 login.png :white_check_mark: 推荐 官方支持方式,持久生效
图片格式要求 .png 不支持 .jpg
建议尺寸 1920×1080 或 1920×1920 避免拉伸失真
打包工具 bingo 必须使用官方工具生成 .opkg

:wrench: 结论:您应使用 白牌包定制机制 替换 login.png 文件,而非手动替换构建路径下的文件。这是 openUBMC 官方推荐且唯一保证生效的方式。

点击此处查看详细分析解答

WebUI 登录界面背景图修改方法说明

根据您的问题,您希望修改 BMC WebUI 登录界面的背景图,并尝试了直接替换文件路径中的 login.jpg,但重新构建后未生效。下面将结合现有资料,为您详细解答:


:white_check_mark: 1. 是否可以通过“图片替换”方式修改登录背景图?

可以,但必须遵循白牌包(Whitelabel Package)定制规范进行修改,而不是直接手动替换文件路径下的图片。

:cross_mark: :warning: 直接替换文件系统路径(如 /home/.../webui/opt/bmc/web/htdocs/image/login.jpg不会生效,因为该路径是构建过程中的临时目录,最终构建系统不会将其纳入镜像。


:white_check_mark: 2. 正确修改登录界面背景图的方法:使用“白牌包定制”

推荐使用 openUBMC 官方支持的白牌包定制机制(Whitelabel Customization)来安全、持久地替换登录背景图。

:white_check_mark: 支持的定制图片包括:
定制项 文件名 说明
登录界面背景图 login.png :check_mark: 支持替换,建议尺寸 1920×1080 或 1920×1920,格式为 .png
浏览器图标 favicon.ico
登录页Logo login_logo.png
主界面机型展示图 img_01.pngimg_02.pngimg_03.png 用于首页设备展示

:white_check_mark: 文档依据:来自《白牌包定制指南》明确说明:

“登录界面背景图”可通过上传 login.png 文件进行替换,图片要求为 .png 格式,建议尺寸 1920×1920 像素,大小不超过 1MB。


:white_check_mark: 3. 操作步骤(推荐流程)

  1. 准备定制文件目录

    mkdir -p my_whitelabel/image
    cp your_custom_login.png my_whitelabel/image/login.png
    
  2. 创建 filelist.conf 文件
    my_whitelabel/ 目录下创建 filelist.conf,写入:

    image/login.png opt/bmc/web/htdocs/theme/custom/bmcimg/
    
  3. 创建 manifest.yml(可选)
    用于定义其他品牌信息,如公司名、支持链接等。

  4. 使用 bingo 工具打包白牌包

    bingo publish -z WBD -b openUBMC -r openubmc_dev -f my_whitelabel/filelist.conf -s my_whitelabel
    
  5. 刷写白牌包到 BMC

    • 通过 WebUI 的 固件升级 → 配置更新 页面上传 .opkg 包。
    • 或使用命令行工具刷写。
  6. 重启 BMC 查看效果

    ipmcset -d reset
    

:white_check_mark: 4. 常见问题与注意事项

问题 原因 解决方案
更换图片后无变化 未使用白牌包机制,或文件未正确打包 使用 bingo 工具构建白牌包
图片显示模糊或错位 尺寸不匹配 使用推荐尺寸:1920×1080 或 1920×1920
图片格式错误 使用了 .jpg 而非 .png 确保使用 .png 格式
构建失败 filelist.conf 路径错误 检查源路径与目标路径是否正确

:white_check_mark: 5. 附:登录页面结构参考

根据截图信息,当前登录页面包含以下元素:

  • 安全公告(可定制)
  • 欢迎语openUBMC S920X20 iBMC
  • 用户名/密码输入框
  • 语言切换(简体中文)
  • 版权信息(底部)

:pushpin: 所有这些元素均支持通过白牌包机制进行定制,详见《白牌包定制指南》。


:white_check_mark: 总结

项目 是否支持 说明
直接替换文件修改背景图 :cross_mark: 不推荐 构建系统不会保留临时路径修改
使用白牌包替换 login.png :white_check_mark: 推荐 官方支持方式,持久生效
图片格式要求 .png 不支持 .jpg
建议尺寸 1920×1080 或 1920×1920 避免拉伸失真
打包工具 bingo 必须使用官方工具生成 .opkg

:wrench: 结论:您应使用 白牌包定制机制 替换 login.png 文件,而非手动替换构建路径下的文件。这是 openUBMC 官方推荐且唯一保证生效的方式。


:pushpin: 参考资料来源

openubmc/manifest/temp 是构建临时目录,不能直接修改。 每次构建都会重新生成里面的内容,自然不会生效打包到hpm包里。

要实现修改背景图。有以下方案

  1. 使用品牌包定制方案 (推荐
    openUBMC品牌包定制指南

  2. 使用hpm包自带品牌包定制方案
    配置参考上面第1点, 修改参考PR

  3. fork webui仓库,直接修改login.png图片 (不推荐)