---
title: Branding
description: 为客户门户、管理控制台和电子邮件配置您自己的名称、徽标、颜色和货币——上传规则及每个设置的显示位置。
url: https://nexcmp.com/zh-cn/docs/customers/branding/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Branding {#branding}

> **Where in the admin:** System › Settings › Brand (`/settings/branding`)。相关：System › Settings › General (`/settings`) 用于设置 URL 以及打印在发票上的卖家详细信息。

## 功能说明 {#what-it-does}

NexCMP 采用白标设计：产品不带任何供应商名称，客户看到的一切均是**您的**品牌。品牌设置适用于登录页、注册页、门户、管理控制台和电子邮件。

## 前提条件 {#requirements}

| 项目 | 要求 |
|---|---|
| 角色 | 管理员。 |
| Files | 徽标：SVG、PNG、JPEG、WEBP 或 ICO，**每个最大 512 KB**。 |
| 依赖项 | 无。 |

## 步骤 {#steps}

1. 打开 **System › Settings › Brand**。
2. 在 **Identity** 卡片中填写：

   | 字段 | 备注 |
   |---|---|
   | **Brand name**（必填） | 最多 60 个字符。显示在门户、电子邮件、发票和法律页面中。 |
   | **发票上的卖家名称** | 最多 120 个字符。留空则使用品牌名称。 |
   | **Brand color** | 一个 `#rrggbb` 颜色；字段旁边的按钮可将其重置为内置颜色。 |
   | **Site currency** | **USD**：价格和余额仅以 USD 显示，无货币切换功能。**VND**：同时按存储的汇率显示转换后的金额（参见[Currency and exchange rates](https://nexcmp.com/zh-cn/docs/catalog/currency-and-exchange-rates/)）。 |

3. 点击**Save**。
4. 在卡片 **Logo & favicon** 中通过 **Upload**（或 **Replace**）上传三张图片——**Logo (light background)**、**Logo (dark background)** 和 **Favicon**；**Remove** 用于删除其中一张。

![包含身份字段和三个已上传图片的 Brand 页面](https://nexcmp.com/zh-cn/docs/images/customers/branding-01-brand.webp)

### General 中的相关设置 {#related-settings-in-general}

**System › Settings › General** 有两个标签页用于完善完整信息：

| 标签页 | 字段 |
|---|---|
| **Branding & URLs** | 品牌名称（电子邮件、发票）、默认语言（英文或越南语）、**Customer app URL**、**Console URL**、**Admin URL**（分销商代登录链接）以及 **Partner console URL**（邀请链接、分销商电子邮件）。安装向导会使用 `https://<domain>`、`https://<domain>/admin` 和 `https://<domain>/console` 填充这些内容。 |
| **Seller & invoicing** | 法人实体名称、税号、地址、联系电子邮件以及发票号前缀。参见 [Invoices and ledger](https://nexcmp.com/zh-cn/docs/billing/invoices-and-ledger/)。 |

电子邮件的 **From name** 在 **System › Settings › Email**（[SMTP and e-mails](https://nexcmp.com/zh-cn/docs/administration/smtp-and-emails/)）中设置。

## 已上传文件的检查 {#uploaded-files-are-checked}

- 系统会根据光栅图像的内容（而非文件名）进行识别和尺寸测量。
- **SVG文件会使用**安全的图形白名单进行重建。包含脚本、`foreignObject`、事件属性、指向外部的`url(...)`、DOCTYPE或实体文件的文件将**被拒绝**（`svg_unsafe`）。
- 文件过大会被 `asset_too_large` 拒绝，类型错误会被 `asset_type` 拒绝，尺寸错误会被 `asset_dimensions` 拒绝。
- 文件通过你自己的域名提供服务，并带有严格的安全标头。

## 验证 {#verify}

1. 在隐私窗口中打开门户登录页面：将显示徽标、名称和颜色。
2. 检查浏览器标签页中的 favicon（浏览器会缓存 favicon；如果仍看到旧的，请清除缓存后重新加载）。
3. 触发测试电子邮件（例如为测试客户发送 **Send reset link**），并检查主题和页脚中的品牌名称。

## 限制与注意事项 {#limits-notes}

- 当客户或管理员切换到深色主题时，将使用深色背景的 Logo。
- 分销商拥有自己的品牌；他们可以上传最大 256 KB 的 PNG、JPEG、WEBP 或 ICO（不支持 SVG）。参见 [Resellers](https://nexcmp.com/zh-cn/docs/customers/resellers/)。
- 对品牌颜色或 Logo 的更改会在下次加载页面时生效；已发送的电子邮件不会改变。

## 故障排查 {#troubleshooting}

| 症状 | 原因 | 解决办法 |
|---|---|---|
| 上传被拒绝：`svg_unsafe` | SVG 包含脚本、链接或外部引用 | 导出纯 SVG（无脚本、无外部图像）或使用 PNG。 |
| `asset_too_large` | 文件超过 512 KB | 压缩或调整图像尺寸。 |
| `asset_type` | 不是 SVG、PNG、JPEG、WEBP 或 ICO | 转换文件格式。 |
| `invalid_argument: primary` | 颜色不是 `#rrggbb` | 使用六位十六进制值。 |
| 旧 Logo 仍然可见 | 浏览器缓存 | 强制重新加载；favicon 可能需要更长时间。 |
| 价格仅以 USD 显示 | 站点货币为 USD | 切换到 VND 并确保已存储汇率。 |