Maya 网络连接修复指南

Maya 网络连接修复指南（适用于 [WinError 10013 / 10054 / 10060]）

概述

本文档解释如何解决 Maya 工具在启动时由于网络限制导致的问题，特别是以下错误：

URLError: <urlopen error [WinError 10013]>
URLError: <urlopen error [WinError 10054]>
URLError: <urlopen error [WinError 10060]>

这些错误通常发生在网络环境存在防火墙、严格的安全软件，或代理/VPN 配置不当的情况下。

---

分步解决方案

1. 在 Maya 中手动设置代理

如果你使用本地代理（例如 Clash、V2Ray 等），请在 Maya 的 Script Editor 中 启动工具之前 输入以下代码：

import os
os.environ['http_proxy'] = 'http://127.0.0.1:7890'
os.environ['https_proxy'] = 'http://127.0.0.1:7890'

import xgtc
import xgToolsUI_user_sub
xgToolsUI_user_sub.XgtRun()

如果端口号不是 7890，请替换为你实际的本地代理端口。

2. 可选：在 Maya 启动时自动加载代理

1. 打开（或创建）以下文件：

   • C:\Users\\<你的用户名>\\Documents\\maya\\2025\\scripts\\userSetup.py

2. 在文件中添加上面的代理设置代码。

3. 保存并重启 Maya。

---

软路由 VPN 用户

浏览器可能能访问网络，但 Maya 无法访问。这是因为 Maya 的 Python 不会自动继承系统代理设置。解决方法是按照上面的方法手动在 Maya 中设置代理。

---

网络许可服务器

Maya 的许可证可能来自 RLM、FlexNet、云订阅或独立许可。许可证的类型不会影响插件访问外部服务器（例如 Gumroad）。

---

理解 WinError 10013 / 10054 / 10060

错误码	含义	常见解决方法
10013	访问被拒绝 / 权限不足	设置代理，检查防火墙/杀毒软件，使用管理员权限运行 Maya
10054	连接被远端服务器重置	检查 VPN/代理，确保服务器可访问，检查网络稳定性
10060	连接超时	验证网络/VPN/代理配置是否正确，确认 IP/端口，检查目标服务器是否可用

示例：检查插件连接情况

with urllib.request.urlopen(
    "https://xgt-license-server.onrender.com/healthz", timeout=10) as r:
    print("OK:", r.status)

• 如果失败，请按照 步骤 1 在 Maya 中设置 HTTP/HTTPS 代理。

---

公司网络说明

• 公司可能会屏蔽未在白名单中的程序。

• Maya Python 不会自动继承系统代理。

• IT 部门可能需要放行 maya.exe 或开放所需端口。

---

错误分析总结

问题	原因
10013	本地系统/防火墙阻止了套接字访问
10054	远端服务器强制关闭了连接
10060	连接超时 / 目标服务器不可达
插件无法连接	Maya 未设置代理或 VPN 无效

---

提示

import urllib.request
with urllib.request.urlopen("https://www.google.com", timeout=10) as response:
    print(response.status)

• 如果返回 200，说明代理正常工作。

• 如果失败，请检查代理软件和防火墙设置。