GodotHub 国内镜像源的切换与配置

为什么需要镜像

Godot 引擎的官方下载源在海外，从中国大陆直连的下载速度通常在几十 KB/s，高峰时段甚至只有几 KB/s。一个 Godot 编辑器加导出模板合计两三百 MB，等下载完成往往要半小时以上。

GodotHub 内置的国内高速镜像，把下载源换到了国内服务器，同一资源的下载速度通常可以跑满宽带带宽。

切换镜像源

在 GodotHub 的设置界面里可以找到"镜像源"选项。当前版本通常提供：

• 默认镜像：GodotHub 主维护的高速源，日常使用直接用默认的就行
• 备用镜像：当主镜像不可用时手动切换
• 官方源：如果网络环境适合（比如开发者有国际带宽），可以切回官方源

切换是即时生效的，不需要重启 GodotHub。正在下载的任务会继续从新镜像续传（GodotHub 支持断点续传）。

镜像覆盖范围

GodotHub 的国内镜像覆盖：

• Godot 编辑器二进制（Windows / macOS / Linux / Android）
• 各平台导出模板（C# / .NET 版本同样覆盖）
• 插件资源
• 社区模板

镜像源不会存储第三方仓库的资源——比如 GitHub 上的插件作者自己发布的 release，如果没有被镜像收录，下载时还是会走 GitHub 的源。

选择合适的镜像

不同镜像可能覆盖的资源集合略有不同：

• 日常引擎和导出模板下载 → 用默认镜像就够了
• 某些冷门的旧版本 → 默认镜像可能没有，切到备用镜像或官方源
• C# 导出模板 → 确认选的是带 Mono 的版本，镜像里会单独列出

如果发现某个资源在所有镜像上都找不到，可以到社区反馈，维护者通常会尽快补镜像。