47 lines
2.6 KiB
Markdown
47 lines
2.6 KiB
Markdown
# 网络优化配置
|
||
|
||
位置：config/Network.yml（Kitin 体系 YAML，移植自 Kitin）。多数项可 /nekobackend reload，多端口监听需重启。
|
||
|
||
## network.chunk-lazy-loading — 区块惰加载（默认 true）
|
||
|
||
玩家在小范围反复横跳时不重复重发已加载的地形区块包，省地形带宽。
|
||
|
||
- network.chunk-lazy-loading（默认 true）：是否启用区块惰加载。
|
||
|
||
## network.reduce-high-frequency-entity-sync-packets — 高频实体同步包减量
|
||
|
||
某些实体（农场里的船/矿车、潜影贝）静止时也每 tick 强制同步，浪费带宽；此项改为按需同步。
|
||
|
||
- entitys（默认 $AbstractMinecart, $AbstractBoat, shulker）：要减量的实体列表。$AbstractMinecart=所有矿车，$AbstractBoat=所有船，其余写实体 id（支持 * 通配、# 标签）。
|
||
|
||
## network.particle — 粒子限流打包
|
||
|
||
领地特效/大量粒子刷屏时，先做视野/距离/遮挡剔除再打包发送。
|
||
|
||
- player-max-particles-per-packet（默认 250）：单包最多携带粒子数，超出拆包。
|
||
- player-min-optimize-threshold（默认 50）：单次粒子数超此值才启动优化。
|
||
- global-max-delay-ticks（默认 10）：粒子打包最大延迟 tick，攒一攒一起发。
|
||
- global-max-packet-particles-per-tick（默认 499）：每 tick 全局最多发送粒子总数。
|
||
|
||
## network.chunk-send — 区块发送限速 + QoS
|
||
|
||
控制区块包发送速率，并可按 IP/域名/线路分组限流。
|
||
|
||
- use-vanilla-chunk-sender（默认 false）：true=用原版区块发送器（关闭 Neko 限速与 ACK 发送器），排查兼容问题时可开。
|
||
- global-max-chunk-send-rate（默认 -1）：全局每秒最大区块发送数，-1=不限。
|
||
- global-chunk-send-burst-factor（默认 0.05）：突发因子，允许短时超速的比例。
|
||
- qos-groups（默认空）：分组限流。每个命名段一组，子选项：rate（该组每秒上限，-1不限）、bind-address（匹配本地绑定 IP）、upstream（上游线路标识）、virtual-host（匹配域名）。例：给 FRP 入口和直连分别限速。
|
||
|
||
## network.extra-listeners — 多端口监听（需重启）
|
||
|
||
额外监听端口，每个端口可单独配 PROXY Protocol v2，让 FRP 与直连共存。
|
||
|
||
- port（必填）：监听端口 0~65535。
|
||
- bind-address（默认 0.0.0.0）：绑定地址。
|
||
- proxy-protocol（默认 false）：该端口是否启用 PROXY Protocol v2（FRP 等需要）。
|
||
- 注意：启动时绑定 socket，不可热重载，改完需重启。
|
||
|
||
## 实时带宽监控
|
||
|
||
/nekobackend bandwidth 显示当前 Mbps、峰值、本次累计出站用量。
|