浏览器下载卡住或失败怎么办？

账号第一次使用某个浏览器版本时，MaskPilot 会先在当前设备准备该版本，再启动账号。下载或安装没有完成时，本次启动会停止，不会把不完整文件当成可用浏览器。

先看失败停在哪个阶段

客户端的进度面板会显示当前步骤。不同阶段对应不同的排查方向：

• 正在获取浏览器下载信息：客户端正在获取当前设备对应的版本信息。此处失败时，先确认客户端仍然登录且网络可以访问 MaskPilot 服务。
• 正在下载浏览器：客户端正在传输文件。只有服务端提供了文件总大小时才会显示百分比；没有百分比但已下载大小仍在变化，并不代表卡住。
• 正在校验浏览器文件：下载已经结束，客户端正在核对文件完整性。校验失败时不会继续安装。
• 正在安装浏览器：客户端正在本机解压并准备可执行文件。这个阶段主要受磁盘空间、安全软件和本机文件写入影响。
• 正在启动浏览器：浏览器文件已经准备完成。此后失败不一定是下载问题，还应检查代理、扩展和账号启动条件。

先记录最后一个阶段和页面显示的完整错误，再开始重试。不要只根据进度条是否显示百分比判断状态。

下载阶段停止或失败

按以下顺序处理：

1. 确认当前设备网络稳定，并暂停会改写下载连接的 VPN、公司代理或网络过滤规则后复测。
2. 检查系统盘是否有足够空间容纳下载文件及解压后的浏览器目录。
3. 检查防火墙或安全软件是否拦截 MaskPilot 下载或写入本地文件；只为可信的 MaskPilot 客户端放行，不要全局关闭防护。
4. 打开客户端的「更新 → 浏览器版本」，找到账号选择的版本并重新下载。
5. 同一版本下载期间不要反复启动多个账号。客户端会协调同版本请求，首个任务完成后，等待中的启动可以复用已经校验的版本。

下载失败的临时内容不会被标记为已安装。网络恢复后重新下载即可，不要手工把不完整文件复制到浏览器目录。

校验或安装阶段失败

如果文件已经下载完成，但在校验或安装阶段失败：

1. 保留原始错误，不要用来源不明的浏览器压缩包替换。
2. 确认系统时间正常、磁盘空间充足，并检查安全软件的隔离或拦截记录。
3. 返回「浏览器版本」页面重新下载同一版本，让客户端重新校验并安装。
4. 如果同一版本连续失败，而其他版本可以完成，记录失败版本和当前客户端版本后联系支持。

MaskPilot 会在安装前核对下载文件；校验失败时停止，比继续运行损坏或不匹配的文件更安全。

已经下载完成但账号仍无法启动

当进度已经进入「正在启动浏览器」或浏览器版本页面显示「已下载」，继续下载通常不能解决后续问题。如果页面明确显示「启动前检查未通过」，先按启动前检查清单处理对应项目；其他情况再分别检查：

• 绑定代理是否可用，以及完整上游链是否通过检测；参见为什么绑定代理后账号无法启动？。
• 所选扩展是否支持当前浏览器版本；参见浏览器更新后扩展被停用怎么办？。
• 本机是否已有该账号的进程或启动操作，客户端是否为匹配的最新版本；参见账号显示“正在使用”怎么办？。

这样可以避免把代理、扩展或本机进程问题误判为浏览器下载失败。其他设备的运行记录不再通过租约阻止本机启动。

联系支持前准备

请提供浏览器版本、最后停留阶段、完整错误、失败时间和已尝试步骤。截图前遮盖账号信息与网络凭据，不要发送密码、代理密钥或其他敏感配置。

网络不稳定、防火墙或安全软件拦截、磁盘空间不足也是 Windows 浏览器安装失败的常见通用因素，可参考 Google Chrome 官方安装排障说明。