Flux Builder

登录页布局

布局预设 默认（右图版） 居中版 全屏背景版 标题（留空用内置文案） 副标题（留空用内置文案） 登录按钮文字（留空用内置） 注册入口 默认（显示） 显示 隐藏

登录主图

主题颜色（勾选才覆盖，否则用内置）

圆角 radius 间距 spacing

认证页面主体颜色（登录/注册/重置页，勾选才覆盖，否则用内置纯黑）

公告

启用公告 标题 内容 类型 info warning error

订阅通道(引导/应急层)

在线参数版本：尚未发布

App 的节点分「通道」(普通节点 / 大陆优化 / 多跳等),通道清单和线路参数由机场面板下发,这里只管 展示和应急:改名字、藏通道、出问题时一键回退。保存后约 1 分钟内所有 App 自动生效,不用重新打包。

池模式 pool_mode (不覆盖基座默认) off — 只用面板地址(应急回退) prefer — 池优先,面板兜底 force — 只用地址池

App 从哪里下载订阅。「地址池」= 面板给 App 的一组专用订阅网址(伪装过、可被墙后切换);「面板地址」= 普通用户看到的订阅网址。
平时用 prefer(先试专用地址,不行再用普通地址,最稳);想彻底隐藏普通地址用 force; off 是出问题时的「回到从前」开关——专用地址全挂了就切它。选「不覆盖」= 用代码里的默认值(当前为 prefer)。

默认选中通道 key

新装 App 或用户没手动切过通道时,默认停在哪个通道。填通道 key(如 cn);留空 = 普通节点(normal)。用户自己切换过就以用户的选择为准。

节点缓存 TTL(小时,1-168)

App 本地节点列表的保鲜时间:超过这个时长才会自动向服务器拉新列表(手动下拉刷新不受限)。调小 = 节点变化传达更快但请求更多;一般不用动,留空 = 12 小时。

订阅下载总时限(秒,20-120)

App 每次下载订阅,把所有地址都试一遍的总时间上限。调大 = 网络差的用户成功率更高,但彻底失败时等报错的时间也更久;调小反之。App 会几个地址同时试,40 秒足够把全部地址试完,一般不用动;留空 = 40 秒。

连不上时自动重下订阅的间隔(分钟,0-1440)

节点确认连不上时(App 自动重试几次都失败),App 会自动重新下载一次订阅,拿到你紧急更换后的新节点。这里设两次自动下载之间的最小间隔,防止反复失败时刷请求。填 0 = 关闭这个自动行为;留空 = 60 分钟。用户手动下拉刷新不受这里限制。

应急禁用通道(逗号分隔)

应急开关:某条线路出问题时,把它的通道 key 填进来,所有 App 立即隐藏该通道,已选中它的用户自动回到普通节点。填 hop 会同时隐藏「多跳」入口。平时留空。

订阅 UA 候选（每行一个，最多 8 个）

App 下载订阅时使用的身份标识(User-Agent)。格式为每行一个，不是逗号分隔；最多 8 个，每项只能使用 1–200 个可见 ASCII 字符。机场侧对应值位于「自定义订阅链接」插件的「App 订阅 User-Agent（每行一个）」；「订阅安全控制」会自动读取，无需重复配置。正常不用填：机场描述符中的有效列表优先，这里只在机场未下发有效 UA 时兜底。新版 App 按顺序尝试，旧版 App 只读取首项；修改前请先与机场插件同步。

公共 DoH 兜底地址（每行一个，最多 8 个）

这是节点入口私有 DNS 失败后的旧链路兜底，不是私有端点。留空使用 App 内置地址；私有 DNS 是否启用及其 token 地址在下面每个通道内单独设置。

通道覆盖(逐通道)

改每个通道在 App 里的「长相」和节点入口解析策略：显示名称、角标、说明、是否隐藏、排列顺序，以及是否启用私有 DNS。不填的展示项沿用面板下发值。

拖左侧 ⠿ 调整顺序,这里的上下顺序就是 App 里 Tab 的顺序(含「多跳」),保存时自动按行序编号。通道 key 只要填对,即使 XBoard 描述符里还没有,App 也会把它显示出来——但订阅仍要 XBoard 认得对应的 entry,否则那个通道会拿到默认节点。

entry 是唯一影响真实线路的一列:填了它,App 拉这个通道的订阅时就会带上 ?entry=填的值,并且无条件盖掉面板下发的值。必须和 XBoard「订阅参数规则」里的参数值一字不差,填错不会报错、只会静默拿到默认节点。留空 = 沿用面板下发,最省心。

每行“数据版本”只在 entry、订阅来源或 UA 等真实请求数据变化时自动推进；改名称、角标、描述、隐藏或排序只更新界面，不会让 App 重下节点。“强制重拉”用于内容不变但需要新版 App 绕过缓存拉一次的应急场景。

本区块保存时会自动写进下发器 global 层并重新发布,新老 App 都能读到。仅默认档位(应用 flux、平台与渠道都是 *)会同步——下发层不分平台,具体档位写进去会污染所有平台;选了具体档位时保存后会有提示,那种情况下这块设置对 App 无效。

私有 DNS：开启后每行填写一个完整 HTTPS 地址，必须是 2–4 个不同主机，路径格式为 /dns-query/<token>。第一阶段始终允许失败后回退，关闭开关即不对该通道使用私有 DNS。

+ 添加通道覆盖

立即保存 修改后自动保存,无需点击

写入下发器 global 层后，一方面进入签名在线层，现役客户端通常在下一次轮询（默认约 5 分钟）生效；另一方面会在下一次构建时原样固化进安装包 dynamic_hot seed，形成同一 schema 的双控制。功能项按完整对象校验和替换，非法在线整项由客户端回退同 key 随包基线；必要入口不能隐藏或禁用。清除一行 = 回到该安装包的随包基线，不是永久关闭。Lite/Pro 的 modes / tiers 本期仅保留契约，不接页面和模式服务。

客户端测速后匿名上报的「国家 → 最优毫秒」滚动聚合(flux#415)。只存国家与聚合数字,不存 IP/用户/设备。样本数达标的国家才通过公开端点 /app/latency-baseline 下发给客户端做首屏节点排序。

客户端在「双」参数 device.report_enabled=1 时按安装上报的设备清单(flux#418)。只收平台/系统/机型/架构/网络类型/地区,不含 IP、账号与节点信息;数据只进不出,公开面没有读取端点。

只展示用户在错误弹窗中主动确认上传的白名单脱敏诊断。正文位于私有存储，不含节点、订阅地址、凭据、配置和未知原始日志；公开端点只写不读。