主机组与节点映射

读者：管理多区域、多运营商节点的运维人员。

**主机组（Host Group）**把多台 Host 按地域、线路或运维归属编组，便于批量查看、映射到逻辑节点，以及对接面板时的节点展示。它与 逻辑节点 的 Host 绑定配合使用：逻辑节点决定「配置是什么」，主机组决定「机器怎么归类」。

1. 适用场景

• 香港 / 美国 / 欧洲分区管理，面板侧按组展示节点
• 同一逻辑节点绑定组内多台机器，DNS 指向组内所有 IP
• 运维按组筛选告警、资源占用与同步状态

2. 概念关系

主机组（Host Group）
    └── 包含多台 Host（VPS）

逻辑节点（Logical Node）
    └── 绑定多台 Host（可与主机组重叠，绑定是独立关系）

面板 / 订阅
    └── 看到逻辑节点（线路名 + 域名），不直接看到「组」

主机组不替代逻辑节点绑定：一条线路要生效，仍需在逻辑节点详情里把目标 Host 绑上去。

3. 创建与管理主机组

1. 控制台 → 主机组 → 新建
2. 填写组名、备注（如 hk-premium、us-standard）
3. 将已接入的 Host 加入组（一台 Host 可属于多个组，视产品实现为准）
4. 保存

后续可在主机列表按组筛选，或在面板 Adapter 配置里引用组 ID（若对接方案需要）。

4. 与逻辑节点配合

典型多区域部署：

1. 创建逻辑节点 hk-reality，域名 hk.example.com
2. 将香港组内 3 台 Host 全部绑定到该逻辑节点
3. DNS：hk.example.com 配置 3 条 A 记录指向 3 台公网 IP
4. Master 保证 3 台 inbound 配置一致；流量由客户端 DNS 解析分配

若某台 Host 仅服务美国用户，可单独建逻辑节点 us-reality 并只绑定美国组内机器。

5. 节点映射

「节点映射」在文档中指：

• 逻辑节点 ↔ Host 的多对多绑定（node_hosts）
• 绑定后的 同步状态、XUI inbound ID、流量观测字段

在控制台逻辑节点详情页维护映射；主机组提供组织维度，不单独存储 inbound 配置。

6. 注意事项

• 从组中移除 Host 不会自动解绑逻辑节点，需分别在逻辑节点详情操作
• 组内机器架构需一致（同为 amd64 或 arm64），避免 Client 二进制不匹配
• 扩容时先 安装 Client，入组后再绑定逻辑节点，避免长时间 pending

7. 常见问题

Q：主机组和逻辑节点有什么区别？
A：组是运维分类；逻辑节点是业务线路与配置单元。用户订阅的是逻辑节点，不是组名。

Q：能否一个组绑定多个逻辑节点？
A：可以。同一 Host 可承载多个逻辑节点（不同协议或端口）。

相关链接

• 逻辑节点
• 配置同步队列