当前项目版本：MVP0.5.5 / v0.5.5。当前开发总结为统一现状入口；本页旧版本与日期属于历史记录。

VMware · Windows 连接指南

在 Windows 虚拟机中试玩现有 Windows 下载包。

2026年10月11日本机核对：VMware Fusion，共享网络（NAT），Mac 地址 172.16.163.1。

为什么连接不上

Windows 包连接 127.0.0.1:18080，这个地址在虚拟机里指 Windows 自己。后台运行在 Mac；现已为 Mac 的 VMware 接口增加 172.16.163.1:18080 访问，同时保留 localhost:18080。

现有下载包的地址规则只接受 HTTPS 或本机 HTTP，因此这里使用 Windows 的本机端口转发，无需修改或重新下载游戏。

保持 VMware 网络为“与我的 Mac 共享”（NAT）。在 Windows 浏览器打开下面的地址，看到 ready 和 connected 后继续。

本次已在 Mac 侧验证该地址与本机地址正常。Windows 虚拟机中的实际连通测试仍需你完成。

在 Windows 内右键点击“开始”，选择“终端（管理员）”，使用 PowerShell 执行以下命令。这些命令在 Windows 中运行，不要放进 Mac 终端。

Start-Service iphlpsvc

只监听 Windows 的本机地址；目标是 Mac 的 VMware 私有接口。

netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=18080 connectaddress=172.16.163.1 connectport=18080

返回 ready、connected 后，重新打开 Windows 游戏并登录。

curl.exe --fail http://127.0.0.1:18080/health/ready

netsh interface portproxy show v4tov4

TcpTestSucceeded 应为 True。若为 False，先检查 VMware 是否仍为共享网络、Mac 后台是否运行。

Test-NetConnection 172.16.163.1 -Port 18080

如果该端口已经被其他程序占用，先确认占用程序，不要随意结束进程。

Get-NetTCPConnection -LocalPort 18080 -State Listen

若能打开 Mac 的地址却不能打开 127.0.0.1，检查是否以管理员身份设置、IP Helper 服务是否启动，以及 Windows 的 IPv6 网络组件是否被禁用（系统端口转发依赖它）。

在 Windows 管理员终端执行；不删除其他端口转发规则。

netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=18080

Mac 侧的可选地址配置在 Backend/.local/compose.env 中：VMWARE_BIND_IP=172.16.163.1。留空后，在 Mac 工程目录运行 python3 Backend/manage.py start，即恢复只监听本机。不要修改数据库端口或密码。

VMware 关闭导致接口不可用时，可先启动虚拟机，或按上述方式留空 VMWARE_BIND_IP。改用桥接网络或重新分配虚拟网段后，需要重新核对 Mac 地址。