經銷商（白牌）
管理員位置： Customers › Resellers › List（
/resellers）、Domains & SSL（/resellers/domains）、Permissions & wholesale（/resellers/entitlements）、Defaults（/resellers/settings）。代理商名額：System › Admin › License & updates（/license）。
功能
一個代理商可在自己的網域名稱上擁有客戶入口網站的品牌化版本，並擁有自己的客戶、錢包、價格以及（選填）付款管道。他們向您以批發價購買，並以自己的價格銷售。他們的客戶永遠不會看到您的品牌，且代理商網域永遠無法開啟您的管理主控台。代理商透過 https://partner.<your-domain> 上的合作夥伴主控台來經營業務。
需求
| 項目 | 需求 |
|---|---|
| 授權 | 您的授權中每個自訂代理商網域對應一個代理商網域授權額度。授權頁面會顯示 used/max 個額度以及購買更多的連結。若沒有可用額度，新增網域將會失敗並顯示「Out of license reseller domain slots」。 |
| DNS | 每個代理商網域必須指向您的伺服器（請見下方）。 |
| 網頁伺服器與 TLS | 主機名稱必須透過您的反向代理伺服器連線至 NexCMP 面板，並具備該名稱的有效憑證。 |
| 電子郵件 | 已為邀請與通知電子郵件設定 SMTP。 |
| 主開關 | Reseller settings › General › rs_enabled 預設為開啟。 |
準備基礎設施
決定伺服器的公開位址：其 IPv4 位址，以及若您偏好 CNAME，則使用指向它的主機名稱（例如
sites.cloud.example.com）。開啟 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）。 傳送指示前請檢查這些數值
rs_server_ipv4、rs_cname_target與rs_master_hosts預設帶有範例數值。在您提供 DNS 指示給代理商之前，請將其替換為您自己的伺服器與網域，否則畫面上的指示會指向錯誤的位置。點擊 Save（系統會要求填寫原因）。
請確保您的反向代理伺服器將代理商主機名稱轉發至 NexCMP 面板，並為其中每一個名稱提供憑證。安裝程式僅會針對主網域（以及可解析的
admin.與partner.名稱）設定 nginx 與 Let's Encrypt。如果您使用 Cloudflare，請將主機名稱設定為透過代理並使用 Full SSL 模式。
在 NexCMP 中連線
建立代理商
開啟 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)。 佈建會在背景繼續進行 (每 30 秒一次)。開啟轉售商以查看進度，若某個步驟失敗，請使用 Continue provisioning 或 Retry。
指向 DNS (由轉售商執行)
轉售商 (或您) 建立顯示於 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 記錄，則會釋放該名稱。
網域狀態
在 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。
權限與批發
Customers › Resellers › Permissions & wholesale (/resellers/entitlements) 是一個矩陣：每個經銷商有一列，包含批發折扣與加價，以及每個服務（例如 DDoS Shield 和 VPN）一個開關。當全平台功能啟用時，開關可編輯；否則該儲存格為唯讀並連結至設定。Top-up codes 子標籤頁設定每個經銷商每月可發行多少代碼（見 Promotions）。
定價規則：
- 批發價 = 定價 x (1 - 折扣)，且可在經銷商的 Wholesale pricing 標籤頁中按方案與計費週期進行覆寫。
- 經銷商設定零售價，且不得低於底價（定價的百分比）。
- 當客戶購買時，經銷商的錢包會支付批發價。錢包具有信用額度、寬限期與透支上限（見 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。 |
誰來收取客戶付款
| 模式 | 含意 |
|---|---|
| 經銷商收款（自有管道） — 預設 | 經銷商連接他們自己的 Stripe、PayPal、USDT 或銀行帳戶。其 Webhook 為 https://<reseller-domain>/v1/billing/<gateway>/webhook/r/<id>。這些網站不支援儲存的卡片與 auto top-up。 |
| 平台收款 | 您的管道會顯示在經銷商網站上。在 rs_platform_collect_enabled = 1 之前為鎖定狀態。 |
| 混合 | 按管道選擇的組合。 |
經銷商所看到的內容
位於 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 分鐘，每一次寫入操作都會在管理員記錄與經銷商記錄中記錄您的姓名，且金錢相關操作需要二次確認。
驗證
- 佈建完成後，經銷商的清單列會顯示 active 以及綠色的 Provisioning 欄位。
- 在瀏覽器中開啟經銷商的網域：隨即會顯示帶有其品牌的經銷商專屬登入頁面。
https://<reseller-domain>/admin回傳 404。 - 在該網域上註冊測試客戶：該客戶會出現在 Customers › List 中，且 Site 欄位為該經銷商。
- 授權頁面會顯示多使用了一個配額。
限制與注意事項
- 每個自訂或測試網域佔用一個授權配額；平台子網域不佔用配額。
- 暫停經銷商會保留資料；Close reseller 會回收所有網域配額，且僅能在保留期過後才允許刪除虛擬機器。
- 經銷商客戶會出現在您的客戶清單中，且可以像其他客戶一樣進行模擬登入（連結會在經銷商的網域上開啟）。
- 經銷商無法檢視或變更您的付款管道、預設額度或其他經銷商。
故障排除
| 症狀 | 原因 | 修正方式 |
|---|---|---|
| 「經銷商網域配額已用盡」 | 所有配額皆已使用 | 釋放配額（移除網域）或在授權頁面購買更多配額。 |
網域卡在 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。 |