NexGen Client 使用说明

外观

关于这张表 ​

本表由源码自动提取，共 115 个可配置项；id 以 custom 开头且与主面板重复的 23 个控件已合并，不单独列出。表格按编辑器中的分组归类，数据来源是配置服务器前端编辑器的控件定义，因此表中的每一项都能在编辑器里找到对应的控件。

  • 配置键：写入 YAML 档案的字段 id，也是排查问题时最可靠的定位依据。
  • 界面标签：编辑器里显示的文案。部分控件没有独立文案，此时直接显示字段 id。
  • 控件：按控件类型归一化——checkbox → 开关，color → 颜色，text / url → 文本框，number → 数字，select → 下拉选择，textarea → 多行文本，file → 文件上传。
  • 所属分类：编辑器里的分组名。当两个编辑器的分组名不一致时，写成 Xboard-Mihomo 分组 / NexGen React 分组，并按这个完整字符串分组归类，因此本页会出现形如「首页与界面布局 / 界面行为」的小节。

注意：编辑器里能看到，不等于客户端会生效

个别选项在两个编辑器里都有控件，但只有其中一个客户端真的会读取它。最典型的就是本表里那批品牌配色：两个编辑器的「自定义功能配置」面板里都能填，但只有老客户端 Xboard-Mihomo_sub 会应用它们，新客户端 NexGen Client React 不含这套机制。本表按实际生效标注，所以这批颜色是「Xboard-Mihomo」。

注意：custom 开头的控件已合并

编辑器里有一个「自定义功能配置」面板，放的是一部分用户需要、但不适合对所有用户默认开放的功能（点状配色、登录窗口套餐状态拦截、邀请与注册、节点解析等）。它需要用对接码验证通过后才显示，验证后也只能看到你这个码被授权的功能。机制说明见自定义功能。

部分功能已经移到常规分类

下面「所属分类」一列记录的是编辑器里的实际分组。其中一些项（例如各类界面隐藏开关、云端调度）在新客户端编辑器里已经移到常规分类下，不需要对接码就能改；在老客户端编辑器里它们仍在自定义面板中。所以同一个功能可能出现「自定义功能配置 / 界面行为」这样的合并分组名。

这个面板里有一批配置键以 custom 开头的控件，读写的是与常规选项同一个配置字段（例如 customHideColorSchemeButton 与 hideColorSchemeButton 都指向 hide_color_scheme_button）。因此本表将它们合并，只保留一份，避免同一设置出现两行。

前缀是 custom 并不等于重复项：customTrafficBarColor 是真实存在的独立配色选项，已经保留在表中。 :::

提示

品牌配色在使用时归属于「自定义功能配置」面板，因此它们出现在下方同名小节中，而不是单独成节。这些项同样需要对接码解锁才会显示，详见功能字段与取值。

remoteConfigSourcePreview（实时源码只读预览）与 editor（隐藏的内部控件）不参与实际配置，已从本表排除。想按分类逐项阅读说明，请回到配置项手册。

应用信息 ​

配置键界面标签控件所属分类
provider站点分组名称（provider / panels 键名）文本框应用信息
appTitle应用名称文本框应用信息
logoTypeLogo类型下拉选择应用信息
logoImageUrlLogo图片地址文本框应用信息

应用图标 ​

配置键界面标签控件所属分类
appIconUrl图标图片地址文本框应用图标
appIconUploadInputappIconUploadInput文件上传应用图标

认证页背景 ​

配置键界面标签控件所属分类
authBackgroundEnabled启用登录背景图开关认证页背景
authBackgroundImageUrl登录背景图地址文本框认证页背景

界面行为 ​

配置键界面标签控件所属分类
uiVariantUI 构建变体下拉选择界面行为
uiColorScheme新 UI 品牌色系下拉选择界面行为
dnsOverrideDefault默认启用 DNS 覆写开关界面行为
autoTestAfterLogin登录后自动测速并选择最低延迟节点开关界面行为
autoConnectOnStartup启动后自动连接代理开关界面行为
logFileEnabled记录应用日志文件开关界面行为
hideInvitePromotion隐藏邀请推广页面开关界面行为
hideDedicatedNodes显示专用节点开关界面行为
hideCurrentNodeLabel隐藏连接卡片当前节点标签开关界面行为
hidePageHeaderText隐藏页面顶部标题文案开关界面行为
noticeAutoOpenIntervalHours自动弹出最小间隔（小时）数字界面行为

首页与界面布局 ​

配置键界面标签控件所属分类
homePanelDefaultLayout首页面板布局下拉选择首页与界面布局
showDedicatedNodes显示 Metron 专用节点开关首页与界面布局
showIpInfo显示加速后 IP 信息开关首页与界面布局

首页与界面布局 / 界面行为 ​

配置键界面标签控件所属分类
hideTrafficDetails隐藏流量详情标签页开关首页与界面布局 / 界面行为
hideNodeStatus隐藏节点状态开关首页与界面布局 / 界面行为
latencyReductionEnabled延迟显示调整开关首页与界面布局 / 界面行为
latencyReductionValue延迟降低百分比数字首页与界面布局 / 界面行为
noticeAutoOpenOnStartup首页自动弹出公告开关首页与界面布局 / 界面行为

功能入口 ​

配置键界面标签控件所属分类
showCustomRuleEntry显示分流组自定义规则入口开关功能入口
authPagesSupportShowButton显示登录注册页客服入口开关功能入口
giftCardShowButton显示礼品卡按钮开关功能入口
checkinShowButton显示签到按钮开关功能入口
telegramShowButton显示 Telegram 频道入口开关功能入口
telegramUrlTelegram 频道或群组地址文本框功能入口
utilitySpeedShowButton显示实用工具：网速测试开关功能入口
utilityCfSpeedShowButton显示实用工具：CF 优选开关功能入口
utilityCfSpeedTargetDomains需要替换的节点地址多行文本功能入口
utilityCfSpeedAutoReplaceEnabled自动优选替换开关功能入口
utilityCfSpeedAutoReplaceIntervalMinutes自动间隔（分钟）数字功能入口
utilityIpLookupShowButton显示实用工具：IP 查询开关功能入口
utilityMediaUnlockShowButton显示实用工具：流媒体解锁检测开关功能入口
utilityGoogleServicesShowButton显示实用工具：安卓谷歌服务检测开关功能入口
popularAppsShowSection显示实用工具：热门应用开关功能入口

自定义功能配置 ​

配置键界面标签控件所属分类
subscriptionStatusPopupEnabled登录窗口套餐状态拦截开关自定义功能配置
proxyGroupsMainPolicyNodesOnly节点弹窗仅显示主策略节点开关自定义功能配置
hidePurchaseCoupon隐藏购买页优惠码开关自定义功能配置
sspanelNodePageParseEnabledSSPanel 节点页面解析开关自定义功能配置
registrationInviteEnabled注册邀请绑定开关自定义功能配置
registrationInviteMode绑定模式下拉选择自定义功能配置
registrationInviteCode邀请码文本框自定义功能配置
registrationInviteLinkEnabled自定义邀请链接开关自定义功能配置
registrationInviteLinkBaseUrl邀请链接地址文本框自定义功能配置
customTrafficBarColor颜色颜色自定义功能配置
noticeDialogIconBackgroundColor颜色颜色自定义功能配置
subscriptionWebsiteIconColor颜色颜色自定义功能配置
subscriptionRefreshIconColor颜色颜色自定义功能配置
subscriptionNoticeIconColor颜色颜色自定义功能配置
loginButtonColor颜色颜色自定义功能配置
plansSubscribeButtonColor颜色颜色自定义功能配置
plansFilterTabColor颜色颜色自定义功能配置
inviteCodeTextColor颜色颜色自定义功能配置
inviteCodeBackgroundColor颜色颜色自定义功能配置
commissionBalanceCardBackgroundColor颜色颜色自定义功能配置
inviteStatsTotalInvitesIconColor颜色颜色自定义功能配置
inviteStatsCommissionRateIconColor颜色颜色自定义功能配置
inviteStatsTotalCommissionIconColor颜色颜色自定义功能配置

自定义功能配置 / 界面行为 ​

配置键界面标签控件所属分类
hideColorSchemeButton隐藏品牌色系切换入口开关自定义功能配置 / 界面行为
hideOnlineSupportButton隐藏第三方客服入口开关自定义功能配置 / 界面行为
hidePlanSpeed隐藏购买套餐速率开关自定义功能配置 / 界面行为

自定义功能配置 / 云端调度 ​

配置键界面标签控件所属分类
cloudDispatchEnabled云端调度开关自定义功能配置 / 云端调度
cloudDispatchQueryUrlGTM 服务地址文本框自定义功能配置 / 云端调度
cloudDispatchQuerySecret查询密钥文本框自定义功能配置 / 云端调度
cloudDispatchAutoEnabledcloudDispatchAutoEnabled开关自定义功能配置 / 云端调度
cloudDispatchAutoIntervalMinutes自动调度间隔（分钟）数字自定义功能配置 / 云端调度
cloudDispatchFallbackRetryMinutes离线兜底回查间隔（分钟）数字自定义功能配置 / 云端调度

订阅配置 ​

配置键界面标签控件所属分类
useExclusiveMode专用客户端模式开关订阅配置
subscriptionUserAgent普通模式订阅 UA文本框订阅配置
exclusiveSubscriptionUserAgent专用模式订阅 UA文本框订阅配置
decryptKey订阅解密密钥文本框订阅配置
subscriptionCustomSubscribeDomains自定义订阅域名多行文本订阅配置
subscriptionCustomDomains自定义订阅域名多行文本订阅配置

面板 API 请求 ​

配置键界面标签控件所属分类
apiEncryptedUserAgent面板 API 自定义 UA文本框面板 API 请求
apiPathPrefix自定义 API 逻辑前缀文本框面板 API 请求

SSPanel-Metron 专属配置 ​

配置键界面标签控件所属分类
subscriptionCustomQuerySuffix自定义订阅查询后缀文本框SSPanel-Metron 专属配置

自动离线模式 ​

配置键界面标签控件所属分类
autoOfflineEnabled启用自动离线开关自动离线模式
autoOfflineForceOnStartup启动时强制自动离线开关自动离线模式
autoOfflineIntervalHours强制自动离线最小间隔（小时）数字自动离线模式

订阅缓存配置 ​

配置键界面标签控件所属分类
subscriptionCacheEnabled启用订阅缓存开关订阅缓存配置
subscriptionCacheTtl缓存有效期（小时）数字订阅缓存配置

OSS 配置文件 配置项 ​

配置键界面标签控件所属分类
remoteConfigPanelType面板类型（panelType）下拉选择OSS 配置文件 配置项
remoteConfigWebsiteUrl官网地址（websiteUrl）文本框OSS 配置文件 配置项
remoteConfigProviderKey站点分组名称（OSS 配置文件 > panels 键名）文本框OSS 配置文件 配置项

OSS 内置代理配置（clientProxy） ​

配置键界面标签控件所属分类
remoteConfigClientProxyEnabled启用内置代理开关OSS 内置代理配置（clientProxy）
remoteConfigClientProxyAutoEnable首次启动默认开启开关OSS 内置代理配置（clientProxy）
remoteConfigClientProxyLinksInput粘贴线路分享链接多行文本OSS 内置代理配置（clientProxy）

静态更新配置（update） ​

配置键界面标签控件所属分类
remoteConfigUpdateEnabled启用静态更新配置开关静态更新配置（update）
remoteConfigUpdateDescription配置说明（description）文本框静态更新配置（update）
remoteConfigUpdateLatestVersion最新版本（latest_version）文本框静态更新配置（update）
remoteConfigUpdateDownloadUrlAndroidAndroid 下载地址（download_urls.android）文本框静态更新配置（update）
remoteConfigUpdateDownloadUrlWindowsWindows 下载地址（download_urls.windows）文本框静态更新配置（update）
remoteConfigUpdateDownloadUrlLinuxArm64Linux ARM64 下载地址（download_urls[linux-arm64]）文本框静态更新配置（update）
remoteConfigUpdateDownloadUrlLinuxAmd64Linux AMD64 下载地址（download_urls[linux-amd64]）文本框静态更新配置（update）
remoteConfigUpdateDownloadUrlMacosArm64macOS Apple Silicon 下载地址（download_urls[macos-arm64]）文本框静态更新配置（update）
remoteConfigUpdateDownloadUrlMacosAmd64macOS Intel 下载地址（download_urls[macos-amd64]）文本框静态更新配置（update）
remoteConfigUpdateManualDownloadUrl手动更新地址（manual_download_url）文本框静态更新配置（update）
remoteConfigUpdateAvailable强制标记（update_available）下拉选择静态更新配置（update）
remoteConfigUpdateForceUpdate强制更新（force_update）下拉选择静态更新配置（update）
remoteConfigUpdateReleaseNotes更新说明（release_notes）多行文本静态更新配置（update）

静态更新配置（update） / OSS 在线客服配置（onlineSupport） ​

配置键界面标签控件所属分类
remoteConfigInputremoteConfigInput多行文本静态更新配置（update） / OSS 在线客服配置（onlineSupport）

加密与密钥 ​

配置键界面标签控件所属分类
remoteConfigKeyInput加密密钥（Base64，32字节）文本框加密与密钥
remoteConfigFileInputremoteConfigFileInput文件上传加密与密钥

OSS 配置文件 实时源码 ​

配置键界面标签控件所属分类
updatesBranchupdatesBranch下拉选择OSS 配置文件 实时源码
buildBranch源码分支下拉选择OSS 配置文件 实时源码
buildTag版本标签文本框OSS 配置文件 实时源码

本文档依据 Xboard-Mihomo-builds 源码整理

NexGen Docs