---
title: 經銷商（白牌）
description: 讓合作夥伴以自己的品牌與網域銷售您的雲端服務——建立經銷商、設定網域與 DNS、批發定價、預設值及授權額度。
url: https://nexcmp.com/zh-tw/docs/customers/resellers/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 經銷商（白牌） {#resellers-white-label}

> **管理員位置：** Customers › Resellers › List（`/resellers`）、Domains & SSL（`/resellers/domains`）、Permissions & wholesale（`/resellers/entitlements`）、Defaults（`/resellers/settings`）。代理商名額：System › Admin › License & updates（`/license`）。

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

一個**代理商**可在**自己的網域名稱**上擁有客戶入口網站的品牌化版本，並擁有自己的客戶、錢包、價格以及（選填）付款管道。他們向您以批發價購買，並以自己的價格銷售。他們的客戶永遠不會看到您的品牌，且代理商網域永遠無法開啟您的管理主控台。代理商透過 `https://partner.<your-domain>` 上的**合作夥伴主控台**來經營業務。

## 需求 {#requirements}

| 項目 | 需求 |
|---|---|
| 授權 | 您的授權中每個自訂代理商網域對應一個**代理商網域授權額度**。授權頁面會顯示 `used/max` 個額度以及購買更多的連結。若沒有可用額度，新增網域將會失敗並顯示「Out of license reseller domain slots」。 |
| DNS | 每個代理商網域必須指向您的伺服器（請見下方）。 |
| 網頁伺服器與 TLS | 主機名稱必須透過您的反向代理伺服器連線至 NexCMP 面板，並具備該名稱的有效憑證。 |
| 電子郵件 | 已為邀請與通知電子郵件設定 SMTP。 |
| 主開關 | **Reseller settings › General › `rs_enabled`** 預設為開啟。 |

## 準備基礎設施 {#prepare-the-infrastructure}

1. 決定伺服器的公開位址：其 IPv4 位址，以及若您偏好 CNAME，則使用指向它的主機名稱（例如 `sites.cloud.example.com`）。
2. 開啟 **Customers › Resellers › Defaults**（`/resellers/settings`），群組 **Domains & SSL**，並設定：

   | 金鑰 | 含意 |
   |---|---|
   | `rs_server_ipv4` | 代理商的 A 紀錄必須指向的公開 IPv4。 |
   | `rs_cname_target` | 代理商的 CNAME 紀錄必須指向的主機名稱。 |
   | `rs_master_hosts` | 屬於您自己主要網站的主機名稱（不得指派給代理商）。 |
   | `rs_platform_domain` | **平台子網域**的選填母網域（例如 `partners.cloud.example.com` 以提供代理商 `acme.partners.cloud.example.com`）。留空則停用此選項。 |
   | `rs_sites_stale_minutes` | 憑證服務被視為過期前的分鐘數（預設 15）。 |
   | `rs_ssl_fail_hours` | 引發錯誤前的失敗嘗試時數（預設 48）。 |

   ::: warning 傳送指示前請檢查這些數值
   `rs_server_ipv4`、`rs_cname_target` 與 `rs_master_hosts` 預設帶有範例數值。在您提供 DNS 指示給代理商**之前**，請將其替換為您自己的伺服器與網域，否則畫面上的指示會指向錯誤的位置。
   :::

3. 點擊 **Save**（系統會要求填寫原因）。
4. 請確保您的反向代理伺服器將代理商主機名稱轉發至 NexCMP 面板，並為其中每一個名稱提供憑證。安裝程式僅會針對主網域（以及可解析的 `admin.` 與 `partner.` 名稱）設定 nginx 與 Let's Encrypt。如果您使用 Cloudflare，請將主機名稱設定為透過代理並使用 Full SSL 模式。

## 在 NexCMP 中連線 {#connect-in-nexcmp}

### 建立代理商 {#create-the-reseller}

1. 開啟 **Customers › Resellers › List** 並點擊 **New reseller**。此精靈共有 8 個步驟並會在最後完成所有佈建；每個步驟皆可安全地重試。

   | 步驟 | 填寫內容 |
   |---|---|
   | **代理商** | 法定或營業名稱、**slug**（4 至 31 個字元，包含 a–z、0–9 或 `-`，以字母開頭；同時也是發票前綴）、聯絡人姓名、電子郵件與電話、預設語言、代理商的帳單詳細資料（作為錢包加值買家）。 |
   | **主控台帳戶** | 使用者名稱、帳戶電子郵件、全名；**透過電子郵件傳送單次邀請連結**（有效期限 72 小時，建議使用）或顯示一次性暫時密碼。 |
   | **品牌** | 品牌名稱、簡稱、標語、主要色彩、支援電子郵件與電話、列印在客戶發票上的賣家名稱、標誌（亮色與暗色背景）、方形標誌與圖示：PNG、JPEG、WEBP 或 ICO，大小上限 256 KB，**不支援 SVG**。 |
   | **Domains** | 包含**也有 www** 的客戶網域、哪一個是主要網域、**測試網域** (sslip.io) 與**乾跑**選項，或是平台子網域。精靈會顯示 **DNS OK / DNS not ready** 以及需要建立的記錄。 |
   | **Pricing & wallet** | 批發折扣 (%)、零售底價 (佔定價的 %)、預設加價 (%)、信用額度、初始餘額、低餘額警示、客戶、VM 與網域的限制、網站功能 (客戶註冊、DDoS 防護、支援工單、自訂方案、調整大小、Auto Scaling)。 |
   | **Payment channels** | 誰來收取客戶款項 (見下方) 以及自選的 PayPal 與自選越南銀行轉帳。 |
   | **Email** | 寄件者名稱與回信地址 (Reply-To)。在為轉售商網域設定 DKIM 之前，From 地址會維持平台地址。 |
   | **Review** | 檢查所有項目並點擊 **Provision everything**，或是 **Save draft (provision later)**。 |

2. 佈建會在背景繼續進行 (每 30 秒一次)。開啟轉售商以查看進度，若某個步驟失敗，請使用 **Continue provisioning** 或 **Retry**。

![帶有範例數值的首步驟新轉售商精靈](https://nexcmp.com/zh-tw/docs/images/customers/resellers-01-wizard.webp)

### 指向 DNS (由轉售商執行) {#point-dns-the-reseller-does-this}

轉售商 (或您) 建立顯示於 **Domains & SSL** 標籤頁上的記錄：

| 記錄 | Name | 值 |
|---|---|---|
| TXT (擁有權驗證，僅限首次) | `_site-verify.<domain>` | `sv=<token>` 顯示於畫面上 |
| A (頂級網域，例如 `shop.example.net`) | 該網域 | 您的 `rs_server_ipv4` |
| CNAME (子網域，例如 `cloud.example.net`) | 該網域 | 您的 `rs_cname_target` (或是指向 `rs_server_ipv4` 的 A 記錄) |
| CNAME (選填) | `www.<domain>` | 您的 `rs_cname_target` |

此外：

- 移除任何 **AAAA** (IPv6) 記錄，除非您的伺服器支援該 IPv6 位址。
- 在驗證網域期間，請將 CDN 代理**關閉** (灰色雲朵)。
- 如果網域有 **CAA** 記錄，請允許 `letsencrypt.org`。

每個網域的 TXT 記錄中的權杖皆不同；請從畫面複製。在前 48 小時內系統每 5 分鐘重新檢查一次 DNS，之後每小時檢查一次，如果在 72 小時後仍缺少 TXT 記錄，則會釋放該名稱。

### 網域狀態 {#domain-states}

在 **Customers › Resellers › Domains & SSL** (所有轉售商) 以及轉售商的 **Domains & SSL** 標籤頁中：

| 狀態 | 含意 |
|---|---|
| `pending_verify` | 正在等待 TXT 記錄。 |
| `pending_dns` / `verifying` | 正在等待 A 或 CNAME 指向您。 |
| `issuing` | 憑證發行中。 |
| `active` | 提供轉售商網站服務中。 |
| `cert_expiring` | 憑證即將到期；預期將進行續約。 |
| `dns_lost` | DNS 停止指向您；30 天後該網域將被移除。 |
| `error` | 查看錯誤代碼；修正後 **Retry**。 |
| `removing` / `removed` | 即將撤回；授權額度將被收回。 |

列動作：**Check now**、**Retry**、**Make primary**、**Test mode** (用於測試網域)、**Remove**。


## 權限與批發 {#permissions-wholesale}

**Customers › Resellers › Permissions & wholesale** (`/resellers/entitlements`) 是一個矩陣：每個經銷商有一列，包含批發**折扣**與**加價**，以及每個服務（例如 DDoS Shield 和 VPN）一個開關。當全平台功能啟用時，開關可編輯；否則該儲存格為唯讀並連結至設定。**Top-up codes** 子標籤頁設定每個經銷商每月可發行多少代碼（見 [Promotions](https://nexcmp.com/zh-tw/docs/billing/promotions/)）。

定價規則：

- 批發價 = 定價 x (1 - 折扣)，且可在經銷商的 **Wholesale pricing** 標籤頁中按方案與計費週期進行覆寫。
- 經銷商設定零售價，且不得低於**底價**（定價的百分比）。
- 當客戶購買時，經銷商的**錢包**會支付批發價。錢包具有信用額度、寬限期與透支上限（見 Defaults）。

## Defaults {#defaults}

**Customers › Resellers › Defaults** (`/resellers/settings`) 是適用於所有經銷商的 `rs_*` 設定金鑰。每次變更均需填寫原因並會受到稽核。

| 群組 | 金鑰 | 預設值 | 含意 |
|---|---|---|---|
| 一般 | `rs_enabled` | 1 | 經銷商計劃已啟用。 |
| | `rs_platform_collect_enabled` | 0 | 允許平台為經銷商代收客戶付款。**請僅在經過法律審查後啟用。** |
| | `rs_totp_required` | 1 | 經銷商主控台帳號必須使用雙重認證。 |
| | `rs_agreement_version` | 1 | 他們必須接受的經銷商協議版本。 |
| 預設定價 | `rs_default_discount_bp` | 2000 (20 %) | 新經銷商的批發折扣（基點，0 至 9000）。 |
| | `rs_default_markup_bp` | 2500 (25 %) | 預設加價（0 至 50000）。 |
| | `rs_default_floor_bp` | 9000 (90 %) | 零售底價（0 至 20000）。 |
| | `rs_default_max_domains` | 3 | 每個經銷商允許的網域數量。 |
| 錢包與撥款 | `rs_grace_hours` | 72 | 經銷商錢包餘額不足時，客戶服務受影響前的寬限期。 |
| | `rs_overdraft_cap_cents` | 5000 | 錢包允許透支。 |
| | `rs_retention_days` | 14 | 已關閉經銷商的虛擬機器被銷毀前的天數。 |
| | `rs_payout_hold_days` | 30 | 佣金在可提領前保留的天數。 |
| | `rs_payout_min_cents` | 5000 | 最小提領金額。 |
| | `rs_topup_min_cents` | 2000 | 經銷商最小錢包加值金額。 |
| 付款與郵件 | `rs_webhook_base` | 空白 | 經銷商閘道 Webhook 的公開基礎 URL（空白 = 使用網站 URL）。 |
| | `rs_mail_from` | 空白 | 經銷商電子郵件的寄件者地址。 |
| | `rs_invoice_show_processor` | 1 | 在發票上顯示付款處理者。 |
| | `rs_gw_stripe_enabled`, `rs_gw_usdt_enabled` | 1 | 經銷商是否可以設定自己的 Stripe 或 USDT。 |

## 誰來收取客戶付款 {#who-collects-customer-payments}

| 模式 | 含意 |
|---|---|
| **經銷商收款（自有管道）** — 預設 | 經銷商連接他們自己的 Stripe、PayPal、USDT 或銀行帳戶。其 Webhook 為 `https://<reseller-domain>/v1/billing/<gateway>/webhook/r/<id>`。這些網站不支援儲存的卡片與 [auto top-up](https://nexcmp.com/zh-tw/docs/billing/auto-top-up/)。 |
| **平台收款** | 您的管道會顯示在經銷商網站上。在 `rs_platform_collect_enabled = 1` 之前為鎖定狀態。 |
| **混合** | 按管道選擇的組合。 |

## 經銷商所看到的內容 {#what-the-reseller-sees}

位於 `https://partner.<your-domain>` 的夥伴主控台包含 Overview、Reports、Customers、VMs、Tickets、Orders、Payments、Prices、Brand、Landing & legal、Domains & SSL、Email、Wallet 和 Payment channels。主控台帳號擁有 *reseller*（完整）或 *staff*（唯讀）角色。若要親自查看，請開啟該經銷商並點擊 **Sign in to partner console**：您將進入 60 分鐘，每一次寫入操作都會在管理員記錄與經銷商記錄中記錄您的姓名，且金錢相關操作需要二次確認。

## 驗證 {#verify}

1. 佈建完成後，經銷商的清單列會顯示 *active* 以及綠色的 **Provisioning** 欄位。
2. 在瀏覽器中開啟經銷商的網域：隨即會顯示帶有其品牌的經銷商專屬登入頁面。`https://<reseller-domain>/admin` 回傳 404。
3. 在該網域上註冊測試客戶：該客戶會出現在 **Customers › List** 中，且 **Site** 欄位為該經銷商。
4. 授權頁面會顯示多使用了一個配額。

## 限制與注意事項 {#limits-notes}

- 每個自訂或測試網域佔用一個授權配額；平台子網域不佔用配額。
- 暫停經銷商會保留資料；**Close reseller** 會回收所有網域配額，且僅能在保留期過後才允許刪除虛擬機器。
- 經銷商客戶會出現在您的客戶清單中，且可以像其他客戶一樣進行模擬登入（連結會在經銷商的網域上開啟）。
- 經銷商無法檢視或變更您的付款管道、預設額度或其他經銷商。

## 故障排除 {#troubleshooting}

| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 「經銷商網域配額已用盡」 | 所有配額皆已使用 | 釋放配額（移除網域）或在授權頁面購買更多配額。 |
| 網域卡在 `pending_verify` | 缺少 TXT 記錄 | 建立完全如所示的 TXT 記錄；使用 **Check now**。 |
| 網域卡在 `pending_dns` | A/CNAME 未指向您、存在 AAAA 記錄，或 CDN 代理已開啟 | 修復 DNS、關閉代理，然後點擊 **Check now**。 |
| `error` 狀態 | 查看該列上的代碼（例如 CAA 封鎖 Let's Encrypt、速率限制） | 修復後點擊 **Retry**。 |
| 瀏覽器顯示主機未知或「421」 | 主機名稱不在授權中，或未路由至控制台 | 透過經銷商新增網域（會消耗一個配額）並修復反向代理。 |
| 說明顯示錯誤的 IP 或主機 | `rs_server_ipv4` / `rs_cname_target` 仍保有範例值 | 在 Defaults 中設定它們。 |
| 經銷商無法啟用平台收款 | 已鎖定 | 經過法律審查後設定 `rs_platform_collect_enabled`。 |