解决Zwift-Offline多人模式连接问题的技术分析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_07088/article/details/148507392

解决Zwift-Offline多人模式连接问题的技术分析

zwift-offline Use Zwift offline 项目地址: https://gitcode.com/gh_mirrors/zw/zwift-offline

问题背景

在使用Zwift-Offline搭建私有服务器时，用户可能会遇到多人模式无法正常工作的现象。具体表现为：多个设备可以成功连接到服务器，但在游戏中无法看到彼此，玩家数量始终显示为1人。这个问题通常与网络连接和协议处理有关。

问题现象分析

通过日志分析，我们可以观察到以下关键错误信息：

TCP连接错误：

[ERROR] Error receiving TCP header [2] End of file

UDP协议解析错误：

UDPHandler ParseFromString exception: DecodeError('Field number 0 is illegal.')

网络状态错误：

[NETWORK] error (8) sending player state

根本原因

经过深入排查，发现该问题主要由以下几个因素导致：

版本不匹配：Zwift客户端与Zwift-Offline服务器版本不一致会导致协议解析失败。Zwift更新1.0.135866后，协议发生了变化，新旧版本无法兼容。
网络中间件干扰：某些地区的网络基础设施会进行深度包检测(DPI)，验证HTTP头中的域名信息是否与IP地址的注册信息匹配。即使使用hosts文件直接映射域名到IP，HTTP头中仍包含原始域名信息，导致连接被中断。
协议处理异常：新版本的Zwift-Offline在处理UDP协议时可能存在解析错误，特别是在网络环境复杂的情况下。

解决方案

1. 版本一致性检查

确保Zwift客户端与Zwift-Offline服务器版本完全一致。当服务器更新后，所有客户端也应同步更新到相同版本。

2. 使用网络优化服务

通过搭建本地网络优化服务器，可以剥离或修改HTTP头中的域名信息，避免被网络中间件检测和干扰。以下是使用Caddy作为网络优化服务的配置示例：

{
    auto_https off
    debug
    log {
        output file caddy.log
        format console
        level DEBUG
    }
}

:443 {
    tls cert-zwift-com.pem key-zwift-com.pem
    @all_hosts host cdn.zwift.com secure.zwift.com launcher.zwift.com us-or-rly101.zwift.com
    handle @all_hosts {
        reverse_proxy {$ZWIFT_IP}:443 {
            header_up Host ""
            transport http {
                tls_server_name "cdn.zwift.com"
            }
        }
    }
}

cdn.zwift.com:80, secure.zwift.com:80, launcher.zwift.com:80, us-or-rly101.zwift.com:80 {
    reverse_proxy {$ZWIFT_IP}:80 {
        header_up Host ""
    }
}

3. 网络架构优化

建议采用以下网络架构：

                           (Local Network Service)
   [Your PC] ^<=======^> [Caddy Server] =========^> [Remote Zwift-Offline]
    Zwift Client      localhost:80/443/3025/3024       Custom Server

这种架构中，所有流量先经过本地网络服务处理后再转发到远程服务器，有效避免了直接连接可能遇到的问题。

技术细节

端口使用：
- 443端口：HTTPS通信，用于API和网页接口
- 3025端口：TCP协议，用于游戏状态同步
- 3024端口：UDP协议，用于实时玩家位置更新
协议加密：
- 443端口使用标准SSL/TLS加密
- 3025和3024端口的数据包由Zwift-Offline和客户端自行加密解密，不依赖传输层加密
错误处理：
- 网络状态错误(Error 8)是正常现象，即使在官方服务器上也会出现
- 协议解析错误通常表明版本不匹配或数据包损坏