RouterOS Branding 包可以定制系统元素，包括路由器名称、公司 URL、ASCII logo 和 WebFig 界面。它支持为登录页、皮肤和 hotspot logo 包入自定义文件，同时提供按版本区分的选项，例如隐藏 SNMP 名称。

Branding（品牌定制）

RouterOS 允许借助 branding 包进行少量系统定制（修改默认配置、LCD logo、WebFig 主页等）。

这是一个特殊的系统包，你可以在你的 mikrotik.com 账户中通过 "Branding maker" 区域生成。生成的文件扩展名为 .dpk，可以通过与 .npk 包相同的所有方式安装。

要在路由器上安装该包，必须先把 branding 包上传到路由器，然后重启路由器。也可以使用 Netinstall 工具达到同样的效果。

生成的包可以安装在任何 RouterOS 版本上。

信息

注意，特定的 branding 功能从特定的 RouterOS 版本起才可用。

选项

可以通过 branding 包配置的选项：

• Router name - Branding 包名称，即 RouterOS 中的设备 identity 和 platform name，只能是一个单词，不要使用空格或特殊字符。
• Company URL - 连接到 RouterOS 设备时在 console 中显示的值。
• Manual URL - 文档链接，可在 WebFig 中打开。
• ASCII Logo - 登录命令行界面（即 Telnet、SSH、WinBox Terminal）时显示的文本 logo。logo 可以在 branding maker 中创建，或从任何其他纯文本编辑器复制。logo 高度不能超过 8 行，宽度不限，但请注意在窄终端窗口中 logo 可能会变形。
• Hide "Mikrotik" from SNMP information - MikroTik 名称将在 SNMP 信息中被隐藏。
• Do not run script on install - 安装 branding 包时不运行 Default configuration 脚本。
• Hide Default configuration prompt - 配置重置后隐藏 Default configuration 提示 （从 RouterOS 7.15 起可用）。
• Hide default caps-mode-script - 隐藏默认 caps-mode-script （从 RouterOS 7.15 起可用）。

自定义文件

诸如 WebFig 登录页、WebFig logo、hotspot、skins、Default configuration、LCD logo 和 CAPs 模式脚本等自定义文件都可以包含在 branding 包中。

警告

任何 reset 按钮模式都会从 branding 包恢复默认配置。

WebFig 登录页

WebFig 登录页是访问路由器 IP 地址时出现的定制默认 RouterOS 登录界面。可以定制该页面以满足品牌或功能需求。

• 自定义文件：

  • /index2.html：登录页的主模板。
  • /assets/style.css：MikroTik RouterOS 样式表。
  • /assets/script.js 负责处理登录功能，并包含赋予按钮交互性的代码。

• script.js 所需元素：

  1. 登录表单：
     <form id="login">
  2. 用户名字段：
     <input id="name" data-defaultuser="admin">
     • admin 值可以改为其他用户名，或留空。
  3. 密码字段：
     <input id="password">
  4. 错误显示区域：
     ``

• 以下是一个用户自定义登录页的示例，带有一个 "Show Password" 按钮，通过修改后的 [index2.html](https://manual.mikrotik.com/management-tools/pathname:/assets/295239801_index2.html) 以及额外的 toggle_button.css 和 show_password.js 文件实现。
  HTML 文件必须命名为 "index2.html"，并使用正确嵌套的 HTML 以确保兼容所有浏览器。

• 上传的图片或 JavaScript 文件必须引用与 index 文件相同的路径。不能使用自定义文件夹名称。

---

WebFig logo

RouterOS WebFig 页面（配置页面）的 logo。要覆盖 WebFig 登录页上的 MikroTik logo，请上传你命名为 "mikrotik_logo.png" 的自定义 logo。

hotspot

Hotspot 登录页 logo。文件必须命名为 "logobottom.png"。

skins

名为 "your_file_name.json" 的皮肤文件。要为特定用户组应用某个皮肤，你无需登录路由器。你可以通过 branding 上传 Default configuration 文件来实现。

Default configuration

一个 RouterOS 默认配置文件，将覆盖 RouterOS 默认配置。此配置即使在 RouterOS 重置后也会保留。可以使用只读变量 $defconfPassword 和 $defconfWifiPassword 重新应用出厂密码（从 RouterOS 7.10 起可以访问出厂密码）。

警告

如果 Default configuration 或 CAPs 模式脚本执行超过 2 分钟，脚本会失败，LOG 中会包含 "runtime limit exceeded"，少数情况下是 "std failure: timeout" 错误。

LCD logo

LCD logo 将显示在配备 LCD 屏幕的设备上。logo 尺寸不能超过 160px 宽、72px 高。CCR1xxx 系列背景为白色 (0xffffff)，2011 系列背景为黑色 (0x000000)。

Custom files

自定义文件会被复制到名为 "branding" 的文件夹中，并可从 RouterOS 内访问。

CAPs 模式脚本

一个 RouterOS CAPs 模式脚本，将覆盖 RouterOS 默认 CAPs 模式脚本。可以利用只读变量 $defconfPassword 和 $defconfWifiPassword 重新应用出厂密码（从 RouterOS 7.15 起可用）。

警告

任何 reset 按钮模式都会从 branding 包恢复默认配置。CAPs 模式脚本只能在设备完全启动后，通过 GUI 或 CLI 执行配置重置来应用。

警告

如果 Default configuration 或 CAPs 模式脚本执行超过 2 分钟，脚本会失败，LOG 中会包含 "runtime limit exceeded"，少数情况下是 "std failure: timeout" 错误。