网络设置

打开 设置 → 网络，可配置手动代理、请求参数，以及高级 0G RPC 地址。

使用 Ghast 并不一定需要手动代理。只有网络确实需要、且你已有可用代理地址时再配置。这里不是系统级 VPN，也不保证每个 Ghast 连接都走同一路径。

保存、测试与放弃修改

本页所有配置字段都需要保存，包括代理模式和凭据、优先 IPv4、超时、重试次数、User Agent，以及 0G RPC。

1. 修改前记下原值。
2. 编辑字段，Ghast 会显示未保存的修改。
3. 配置手动代理时，可先用测试代理检查草稿。
4. 点击保存，等待未保存提示消失。
5. 在真正需要使用的功能里，重新执行一次低风险操作。

测试代理会用草稿发起真实网络探测，但不会保存代理，也不会让其他任务改用它。测试成功不能替代保存。

要放弃修改，点击返回应用或关闭，再确认不保存就关闭。切换设置页面既不会保存，也不会放弃共享草稿。共用操作见保存与放弃设置。

保存会更新共用 HTTP 连接设置，但不会重新配置所有已经打开的浏览器或渠道连接。如果已有连接仍沿用旧行为，请先完成正在执行的工作，再重启 Ghast 测试该功能。重启也不会让不支持这些设置的功能开始支持，见连接覆盖范围。

运行中的 macOS 客户端。空字段中的灰色示例文字是占位提示，不是已经保存的值。

配置手动代理

先从代理应用或网络管理员处取得协议、主机、端口以及必要凭据。打开这个选项不会替你创建代理服务器。

1. 在 代理 → 模式 中选择手动。
2. 选择代理类型：HTTP、HTTPS 或 SOCKS5。
3. 填写代理服务器和端口。
4. 需要认证时，填写用户名和密码。
5. 向下滚动到测试代理，执行测试并检查结果。
6. 确认填写的配置适合当前网络之后再保存。

字段	如何填写
代理类型	选择代理服务支持的协议。这里的 HTTPS 指连接代理本身使用的协议，不要因为目标网站是 HTTPS 就选择它。
代理服务器	填写主机名或 IP，不要加协议前缀、路径、端口或凭据。本机代理应使用代理应用实际提供的主机地址。
端口	代理实际监听的端口，范围为 1–65535。初始值 8080 不代表该端口一定运行着代理。
用户名 / 密码	代理凭据，不是 Ghast 账户密码、模型 API Key 或钱包密钥。不需要认证时留空。

超出范围的端口会被限制到允许的范围。清空或输入无效数字时可能恢复为 8080，请检查最终显示的数字，不要假定它仍为空。

未保存的填写示例，只展示字段位置，不证明你的电脑上有可用的 127.0.0.1:8080 代理。

不要把主机留空、保存手动模式，然后期待网络请求会被阻止。不完整的配置不是安全的“只允许走代理”模式，不同功能的回退行为也可能不同。

测试当前草稿

只有开启手动模式且填写主机、端口后，测试按钮才可用。即使已经选择手动，主机为空时仍可能显示**启用手动代理后才能测试。**提示。

测试有自己约八秒的请求时限，不使用本页的超时、重试次数、自定义 User Agent 或优先 IPv4 配置。调高“请求超时”不会延长这项测试。

结果	如何理解
… ms 已连接 …	代理成功访问了公共出口 IP 探测服务。结果可能包含 IP 地址和国家旗帜。
已连接，但没有旗帜	国家查询可能失败；这不会把第一步成功的探测变成失败。
代理失败:…	连接或探测失败。阅读错误，再检查协议、主机、端口、凭据以及代理是否运行。
代理失败:fetch failed	通用连接错误，不能凭这一句确定唯一原因；多种连接问题都可能显示相同文案。

显示的延迟测量初始响应，不是整个国家查询的耗时，也不是模型回答需要的时间。

修改字段后必须重新测试

更换服务器、端口、协议或凭据不会自动清除旧测试结果。再次点击测试代理，再把结果作为新配置的依据。把模式切到关闭会清除结果。

测试会发送什么

测试通过草稿中的代理连接 icanhazip.com 获取出口 IP，再把这个 IP 发送到 api.country.is 查询国家。这些服务会收到探测流量，但不会收到对话内容。代理凭据会提交给 Ghast 本地桌面服务，再用于连接代理。

测试通过不代表 Provider、MCP 服务、网站、更新服务、WebSocket 或内嵌登录页都能访问；请单独检查目标功能。分享测试截图之前，移除私有代理信息和出口 IP，不要假定所有错误消息都已经脱敏。

关闭或更换手动代理

1. 打开 设置 → 网络。
2. 选择关闭，或把手动字段替换为新的代理配置。
3. 点击保存。
4. 在受影响的功能中重新执行无副作用的请求。如果已有浏览器或渠道连接仍沿用旧路径，先完成正在执行的工作，再重启 Ghast。

关闭只停用 Ghast 的手动代理。尽管界面写着直接出站流量。，支持这些设置的请求仍可能使用操作系统代理。系统代理解析不可用或失败时，共用 HTTP 路径还可能使用进程的 HTTP_PROXY / HTTPS_PROXY 环境变量。关闭不是强制直连开关。

关闭模式不会擦除已保存的主机或凭据。要移除它们，先显示手动字段，清空主机和凭据，再切回关闭并保存。不要为了修复错误代理而清除账户或重置其他无关设置。

如果已保存的手动代理导致无法连接，请回到设置恢复原值或选择关闭，确认保存后再重启。支付、发布、发送等外部操作超时后，应先核对目标服务的实际状态，再决定是否重试。

调整请求参数

这些控件只影响接入了相应配置的连接，不影响每个功能的全部请求。

控件	范围与默认值	作用及限制
优先 IPv4	默认关闭	在共用直连路径上强制使用 IPv4 DNS 查询，不控制代理端解析，也不为仅有 IPv6 的主机提供 IPv6 回退。
请求超时	5–120 秒，步长 5 秒；默认 30 秒	共用 HTTP 每次尝试、0G RPC 每次请求的超时。具体功能可以使用自己的时限。
重试次数	0–10；默认 3	共用 HTTP 首次请求之后的额外尝试次数。三次重试意味着最多四次尝试，不是总共三次。
自定义 User Agent	可选，默认空	替换支持此设置的共用 HTTP/RPC 请求中的 User-Agent，不会改变全部内嵌浏览器的身份。

修改超时或重试次数

1. 拖动请求超时滑块，或修改重试次数。
2. 检查最终显示的值。重试次数会限制在 0–10；清空或输入无效值时可能恢复为 3。
3. 点击保存。
4. 重新执行一次低风险任务，比较结果后再决定是否调整其他选项。

对共用 HTTP 请求而言，超时不是包含全部重试的总预算；它约束等待响应，不限制整个流式回答的持续时间。因此，对话运行时间可能超过所选超时。

共用重试策略包括网络或超时错误，以及 HTTP 408、425、429 和 5xx 响应，具体功能可以覆盖这个策略。设为 0 只关闭遵循本设置的重试，不会关闭 0G 只读端点回退、SDK 自己的重试，或服务端已经开始的处理。

不要靠增加重试解决无效凭据或权限错误。重试也不能让外部动作变得可安全重复：发送或交易结果不确定时，先检查它是否已经发生。

使用 IPv4 或自定义 User Agent

如果为排查直连问题而启用优先 IPv4，保存后测试目标服务；如果仅支持 IPv6 的目标因此不可达，请关闭并保存。这个选项不能改变代理出口位置。

除非目标服务或网络管理员要求特定值，否则把自定义 User Agent留空。占位文字 Ghast/0.1 是示例，不代表已经配置了覆盖值。要移除自己的覆盖值，清空字段并保存。

修改 0G RPC 地址

**0G RPC（高级）**修改的是 0G 主网区块链请求地址，不是 Provider 的模型推理地址。它不会选择模型、增加计算余额，也不会替换其他支付来源链的 RPC。

1. 取得可信的 0G Mainnet，链 ID 16661 RPC 地址。
2. 在 0G RPC（高级） 中填写完整的 HTTP 或 HTTPS URL。
3. 点击保存。
4. 先检查只读的钱包或余额刷新，再执行交易。

保存时不会测试连接或链 ID，测试代理也不会测试这个 RPC 地址。URL 错误可能直到区块链功能实际使用它时才显示。

RPC 配置	读取	交易
留空	使用默认主网地址，遇到连接错误时尝试只读备用端点；最近成功的默认端点可能优先使用。	使用单一的默认写入端点。
自定义 HTTP/HTTPS URL	只使用该地址，不再使用默认的只读备用端点。	只使用该自定义端点。

合约错误或交易回退不能靠只读端点切换解决。RPC 请求使用适用的代理、超时、User Agent 和直连 IPv4 配置，但不使用重试次数；等待交易回执还可能有独立时限。

要恢复标准 RPC 配置，清空字段并保存。如果交易可能已经提交，请先检查状态再重新提交；没有收到响应不能证明交易失败。

把自定义 RPC URL 当作可能包含敏感信息的内容处理，特别是地址内有服务商 Token 时，不要放进公开截图或支持消息。

哪些连接遵循这里的配置？

功能或连接	应如何理解
使用 Ghast 共用 HTTP 路径的模型和工具	可以使用代理和请求参数；单次请求可以覆盖超时或重试策略。
0G 区块链 RPC	使用适用的代理、超时、User Agent 和直连 IPv4 控件，并有自己的端点选择策略。
部分内嵌搜索和登录窗口	使用独立配置的浏览器会话代理。已经打开的会话可能保留旧设置，浏览器的超时和 User Agent 另行处理。
内嵌窗口使用仅支持 HTTPS 的代理或认证代理	共用 HTTP 测试通过不代表浏览器兼容。当前浏览器会话不会以相同方式保留 HTTPS 代理传输，也没有相同的已保存凭据处理，请实际检查登录或搜索窗口。
插件提供的模型、MCP 连接、插件下载、应用更新，以及 0G Pay 服务请求	不要假定全部使用本页配置，其中多处使用独立网络实现；请针对失败功能单独测试和排查。
Shell 命令、外部应用以及独立启动的服务	使用各自网络环境；修改本页不等于配置系统级代理。

只有模型失败时，先检查Provider 配置和测试；搜索失败见网络搜索测试；服务连接或授权问题见MCP 配置。把代理访问、服务认证、模型可用性和账户余额作为不同项目分别检查。