Ovobrowser
帮助中心
展开全部教程目录

ovoBrowser 常见问题与故障排查

本页汇总使用 ovoBrowser 时最常见的问题。先按对应条目检查；仍无法解决时，请在客户端右上角点击「联系我们」，并提供客户端版本、发生时间、环境编号、错误提示和可复现步骤。请勿发送代理密码、账号密码、Cookie 或 2FA 密钥。

ovoBrowser 常见问题与故障排查

本页汇总使用 ovoBrowser 时最常见的问题。先按对应条目检查；仍无法解决时，请在客户端右上角点击「联系我们」，并提供客户端版本、发生时间、环境编号、错误提示和可复现步骤。请勿发送代理密码、账号密码、Cookie 或 2FA 密钥。

安装、登录与更新

客户端无法启动怎么办？

  1. 确认已经完成安装，不要直接运行安装包中的临时文件；

  2. 在任务管理器中结束残留的 ovoBrowser 进程，再重新打开；

  3. 暂时退出可能拦截程序启动的安全软件后重试；

  4. 重新下载安装最新版客户端并覆盖安装；

  5. 若启动页显示某一步失败，点击「重新检查」，并记录失败步骤和完整提示。

收不到邮箱验证码怎么办？

  1. 确认邮箱拼写正确；

  2. 查看垃圾邮件、广告邮件和邮件隔离区；

  3. 等待倒计时结束后重新获取；

  4. 不要连续频繁请求验证码；

  5. 验证码有效期为 10 分钟，只使用最后一次收到的验证码。

忘记密码怎么办？

在登录页点击「忘记密码」，输入注册邮箱并获取 6 位验证码，然后设置新密码。密码至少 10 位，且同时包含大写字母、小写字母和数字。团队子账号应联系团队所有者重置密码。

更新下载失败怎么办？

进入「设置 > 系统设置 > 版本信息」重新检查更新。若自动更新仍失败，点击「下载安装包」手动覆盖安装。安装前先关闭全部正在运行的环境。

环境管理

为什么无法新建或恢复环境？

通常是环境配额不足。查看客户端左下角的环境已用数量与总额度，删除不再需要的环境或增加额度后再试。恢复回收站中的环境也会占用环境额度。

环境为什么启动失败？

按以下顺序检查：

  1. 查看右下角启动进度面板停在哪一步；

  2. 确认目标内核已下载，或保持网络畅通让客户端首次启动时自动下载；

  3. 在「代理管理」重新检测环境使用的代理；

  4. 编辑环境，检查系统、内核、User-Agent、系统版本等指纹参数是否匹配；

  5. 关闭该环境的残留进程后重试；

  6. 若仍失败，记录环境编号和「启动失败」中的完整错误，若无法解决可联系客服。

关闭环境后标签页和登录状态会保留吗？

正常从 ovoBrowser 关闭环境时，客户端会保存本次会话的标签页，并把 Cookie 同步到服务器。下次启动会恢复配置。强制结束进程、电脑断电或网络中断时，最后一次变更可能来不及保存。

删除环境和清空缓存有什么区别？

  • 「删除环境」会把环境移入回收站，环境不再出现在环境列表中；

  • 「同时删除环境本地缓存」会额外删除当前电脑上的浏览数据；

  • 「设置 > 缓存设置 > 清空缓存」只清理未运行环境的本地缓存，不会删除云端环境记录；

  • 「回收站 > 彻底删除」会永久删除环境记录，不能恢复。

代理网络

代理检测失败怎么办？

先确认协议、主机、端口、用户名和密码与代理服务商提供的信息完全一致，再查看代理检测异常和配置 HTTP、HTTPS、SOCKS5 代理。常见原因包括代理过期、白名单未放行、认证错误、本机网络无法连接代理服务器或代理服务商限制目标地区，请联系您的代理服务商。

检测成功但网站仍打不开怎么办？

  1. 确认打开的是刚刚检测过的同一条代理；

  2. 检查代理是否限制目标网站或端口；

  3. 更换环境中的「IP 查询渠道」再检测；

  4. 检查电脑的系统代理、VPN 或安全软件是否改变了网络链路；

  5. 联系代理服务商确认出口 IP 是否正常。

直连能隔离不同环境的公网 IP 吗？

不能。直连环境使用当前电脑实际出口网络；若电脑启用了系统代理，也可能经系统代理出口。多个直连环境通常共享同一个公网 IP。如需网络隔离，应为不同环境分配不同的可用代理。

团队、权限与分享

为什么看不到某个菜单或按钮？

团队角色会控制菜单和操作权限。看不到「团队管理」「窗口同步」「API & MCP」等功能，或按钮处于禁用状态时，请联系团队所有者检查角色权限和套餐权益。权限保存后立即生效，必要时刷新数据或重新进入页面。

删除成员前为什么必须选择资源接管人？

删除成员是不可逆操作。该成员拥有的环境、分组和代理需要转移给仍在团队中的接管人，避免业务数据失去归属。请先确认接管人，再输入页面要求的成员账号完成二次确认。

可撤回分享和不可撤回分享有什么区别？

两种方式都会给接收方创建独立副本，双方后续修改互不影响。可撤回分享允许发送方之后撤回并删除接收方副本；不可撤回分享不能由发送方撤回，接收方还可以继续分享。

窗口同步与扩展

窗口同步列表为空怎么办？

窗口同步只显示当前已经打开的环境。请先在「环境管理」至少打开两个环境，再回到「窗口同步」点击刷新。还要确认当前角色拥有窗口同步权限。

文本没有输入到跟随窗口怎么办？

先在每个目标窗口中点击需要输入的文本框，使其获得焦点，再发送文本。若页面存在多个输入框、页面拒绝脚本写入或窗口连接已断开，操作台会给出失败原因。

已添加扩展但环境中没有加载怎么办？

确认扩展状态为「启用」，并满足以下任一条件：已开启「应用到所有环境」，或已在「分配环境」中勾选目标环境。扩展设置在环境下次启动时生效，已运行的环境需要关闭后重新打开。

API & MCP

调用本地 API 提示 Connection refused

  1. 保持 ovoBrowser 客户端运行并已登录；

  2. 打开「API & MCP」页面；

  3. 确认显示「服务运行中」；

  4. 使用页面显示的接口地址，不要假定端口一定是 50325；

  5. 确认请求发往 127.0.0.1，且没有被容器、虚拟机或代理改写。

本地 API 需要 Token 吗？

不需要。当前本地 API 仅监听 127.0.0.1，不使用 Token、Bearer Token 或 x-api-key。不要把该服务通过端口映射、反向代理或隧道暴露到局域网或公网。

为什么 HTTP 状态是 200，但操作仍失败？

部分业务错误会返回 HTTP 200，并在响应体中使用 {"success":false,"msg":"错误说明"} 表示失败。调用程序必须检查 success，不能只检查 HTTP 状态码。

缓存与磁盘

清空缓存会丢失账号登录状态吗？

清空缓存会删除未运行环境在本机的浏览数据。正常关闭环境后，Cookie 会保存服务器快照，之后可重新注入，但无法保证所有网站的全部本地存储都能恢复。重要业务操作前应先正常关闭环境，并确认关键数据已保存。

为什么清空缓存后仍有占用？

正在运行的环境会被自动跳过；客户端自身文件、内核文件和安装文件也不属于「环境缓存」。先关闭全部环境，再刷新缓存信息并重试。

联系支持前准备什么？

请准备：

  • ovoBrowser 客户端版本；

  • Windows 版本；

  • 问题发生时间；

  • 环境编号（不要发送账号密码）；

  • 完整错误提示；

  • 从打开页面到出现问题的操作步骤；

  • 必要的截图或录屏；

  • 代理问题可提供协议、主机和端口，但请隐藏用户名与密码。