EasyVMS客户端提示“网络异常”时，需依次验证服务端运行状态、端口连通性及客户端配置：确认easyvms-server进程活跃且监听0.0.0.0；用telnet/nc测试IP+端口可达；核对客户端serverUrl地址端口是否匹配，并排除防火墙、DNS、代理干扰。
EasyVMS客户端提示“网络异常”时，通常意味着前端无法与后端服务建立稳定通信，可能是服务未启动、地址配置错误、防火墙拦截或网络链路中断所致。需从服务端可达性、地址端口连通性、客户端配置三方面逐层验证。
确认EasyVMS服务端是否正常运行
EasyVMS依赖后台服务进程提供API和流媒体能力，若服务未启动，所有客户端均会报“网络异常”。
登录EasyVMS部署服务器（Linux或Windows），执行对应命令：
Linux系统：运行 systemctl status easyvms-server 或 ps aux | grep easyvms，确认主进程存在且状态为active（running）。
Windows系统：打开“任务管理器”→“服务”选项卡，查找名为 【EasyVMS Server】 的服务，确保其“状态”列为“正在运行”。
若服务已停止，Linux下执行 sudo systemctl start easyvms-server；Windows下右键该服务→“启动”。启动失败时检查日志：/var/log/easyvms/server.log（Linux）或 C:\Program Files\EasyVMS\logs\（Windows）中最近的ERROR条目。
测试服务端口是否可访问
客户端连接的是IP+端口组合，必须确保目标端口处于监听且未被拦截状态。
在客户端所在机器（如办公电脑）上，使用telnet或nc验证：
Windows：按Win+R输入 cmd 回车，执行 telnet 192.168.10.5 8080（将IP和端口替换为实际配置）。
Linux/macOS：终端执行 nc -zv 192.168.10.5 8080。
若返回“Connected to”或“succeeded”，说明端口通；若提示“Unable to connect”或超时，则问题出在网络路径或服务监听配置上。
【关键前提】 EasyVMS默认监听 0.0.0.0:8080（或配置文件中指定的端口），若服务仅绑定 127.0.0.1，则外部机器无法访问——需修改 config/application.yml 中的 server.address 为 0.0.0.0 并重启服务。
检查EasyVMS客户端网络配置
客户端配置错误是高频原因，尤其当服务端IP或端口变更后未同步更新。
方法一：通过EasyVMS客户端界面修改
启动EasyVMS客户端→点击右上角齿轮图标→进入“系统设置”→“服务器配置”→核对“服务器地址”和“端口”是否与实际部署一致；HTTP协议请勿漏写 http:// 前缀，HTTPS请确认证书有效性。
方法二：直接编辑配置文件（适用于批量部署或界面不可用时）
定位客户端安装目录下的 config/client-config.json（Windows常见路径：C:\Program Files\EasyVMS\config\；macOS：/Applications/EasyVMS.app/Contents/Resources/config/）。
用文本编辑器打开，检查 "serverUrl" 字段值，例如："serverUrl": "http://192.168.10.5:8080"。修改后保存，重启EasyVMS客户端生效。
注意：若服务端启用了反向代理（如Nginx），客户端应填写代理地址（如 https://vms.example.com），而非内网直连地址。
排查中间网络设备拦截
步骤一：确认客户端与服务端在同一局域网
执行 ping 192.168.10.5（替换为目标IP）。若持续“Request timed out”，说明基础ICMP不通，需检查：
— 物理链路（网线松动、交换机断电）
— VLAN隔离或ACL策略（企业网络中常见）
— 客户端/服务端防火墙是否放行ICMP（临时关闭防火墙测试）
步骤二：验证DNS解析是否正常
若客户端配置的是域名（如 vms.internal），先执行 nslookup vms.internal 或 dig vms.internal，确认能返回正确A记录。解析失败时，可临时改用IP直连绕过DNS环节。
步骤三：检查浏览器或系统代理设置
EasyVMS客户端若基于Electron或WebView构建，会继承系统代理。Windows：设置→网络和Internet→代理→确认“自动检测设置”已关、“手动设置代理”未启用；macOS：系统设置→网络→高级→代理→全部设为“不使用代理”。
