2.1 KiB
配置
使用 EasyTier TOML,示例见 examples/client.toml。必须填写虚拟 IPv4 或 dhcp = true,二者互斥。自动分配实际地址由上游动态生成;状态从运行实例快照读取。
第一版允许顶层字段:hostname、instance_name、ipv4、dhcp、network_identity、peer、listeners、mapped_listeners、flags、stun_servers、stun_servers_v6、optimization、runtime。
network_identity 允许 network_name、network_secret。peer 数组的每项仅允许 uri。节点、监听与映射地址仅支持 tcp/udp。默认不开放监听端口;用户可显式设置 listeners。
flags 允许:default_protocol、latency_first、enable_ipv6、disable_p2p、p2p_only、lazy_p2p、need_p2p、disable_tcp_hole_punching、disable_udp_hole_punching、disable_sym_hole_punching、private_mode、foreign_relay_bps_limit,以及 no_tun、use_smoltcp、enable_encryption。enable_encryption 必须为 true;前两项在默认 application 模式必须为 true,在 system_vpn 模式必须为 false,可省略由模式确定。
未知、不支持的字段拒绝,不静默吞掉。解析器错误不返回配置原文,避免泄漏密钥。当前校验支持 TOML 解析与基本类型/策略,完整 runtime 能力校验仍在 start 阶段完成;validate 成功不保证远端可达。
UI 表单提供常用字段,其他已支持字段通过粘贴 TOML 输入。导出表单配置默认去掉密钥。高级安全模式、KCP/QUIC、Magic DNS、子网导出、系统出口、虚拟 IPv6 暂未支持。
[runtime] mode = "system_vpn" 显式选择 macOS 系统组网开发模式,默认 application。两种模式自动接入符合规则的已发布私有子网,无需 subnet_routes(该字段已移除)。只接入 /16~/32 的私有 IPv4,最多 32 项,过滤本机接口和虚拟网段冲突;公告撤回时取消接入。系统模式限制及权限要求见 系统组网。
MeshPort 扩展 [optimization] 配置在传入上游前解析并移除;模式、阈值、UDP优先和候选限制见 优化说明。