Provider Node/使用代理 IP
用代理 IP 添加节点
已有代理服务器时，不用安装 Provider Node：填入代理地址，验证通过后它就是你的节点，之后在网页上授权订阅即可。
没有代理服务器，或需要使用即梦？请改为安装 Provider Node： 节点接入指南 →
准备条件link
- 一台有公网 IP 或公网域名的代理服务器（VPS 或代理服务），端口能从公网访问。不能使用 localhost 或内网地址。
- 代理能访问 api.wokey.ai 和模型厂商官方域名的 443 端口。
- 代理出口所在地区需要被模型厂商支持。例如出口在中国大陆时，无法授权 Claude、ChatGPT 等订阅。
- 代理需要一直运行。不用安装 Provider Node，也不用一直开着自己的电脑。
代理地址格式link
| 协议 | 地址示例 | 说明 |
|---|---|---|
| HTTP CONNECT | http://user:[email protected]:8080 | 默认端口 80。代理账号密码以明文发给代理服务器。 |
| HTTPS 代理 | https://user:[email protected]:8443 | 默认端口 443。先用 TLS 连接代理服务器，可以保护代理账号密码。证书须由公共 CA 签发，自签名证书无法通过验证。 |
| SOCKS5h | socks5h://user:[email protected]:1080 | 默认端口 1080，域名由代理解析。不支持 socks5://，请写成 socks5h://。 |
- 账号密码写在地址里，格式为 user:password@。含有特殊字符时需要 URL 编码，例如 @ 写成 %40。
- 地址里不能带路径、查询参数或 #。
- 每个账号最多添加 100 个代理节点。
添加步骤link
- 1
打开 Provider 页面
进入 Provider 页面。还没有节点时，点击「使用代理 IP」；已经有节点时，在「共享节点」一栏点击「添加代理节点」。
- 2
接受隐私条款
第一次添加时，页面会提示接受 Provider 隐私条款，接受后继续。
- 3
填写代理信息
选择协议，填入代理连接地址。节点名称可以不填，最多 40 个字符。
- 4
验证并保存
点击「验证并保存」。平台会在 10 秒内通过代理连接 api.wokey.ai:443，连通后保存。第一个节点验证通过后，你会自动获得 Provider 身份。
成功标志：节点出现在「共享节点」列表里，显示为在线，类型为 SOCKS5h、HTTPS CONNECT 或 HTTP CONNECT。列表只显示 IP 和端口，不显示账号密码。
授权订阅link
代理节点没有本地页面，订阅在 Wokey 网页上授权。
- 1
打开授权页面
在 Provider 页面点击「添加凭证」，选择「OAuth 授权」，进入「添加授权凭证」页面。
- 2
指定代理节点
有多个节点时，平台会自动匹配。要用这个代理授权，在「出口节点」一栏点击「更换」并选中它。
- 3
完成登录
按页面提示登录订阅账号。第一次通过某个代理授权某家厂商时，平台会先检查代理能否连上这家厂商的官方地址；这次检查只建立加密连接，不发送请求，也不发送凭证。
- 可以用代理授权
- Claude、ChatGPT（Codex）、Grok、Kimi 的网页授权，以及各厂商的 API Key。
- 不能用代理
- 即梦需要安装 Provider Node，代理节点不会出现在即梦的节点列表里。
运行与管理link
- 在线状态
- 平台每 30 秒通过代理检查一次连通性。最近 3 分钟内有成功的检查，节点就显示为在线。连接或认证失败时，节点会停止接收请求 30 秒。
- 并发与收益
- 每个代理节点最多同时承载 32 个连接。收益规则和 Provider Node 相同，按成功调用结算。
- 暂停与删除
- 暂停后，经过这个代理的连接会全部断开。删除节点时，绑定在上面的账号会自动改绑到备用节点；没有备用节点时，这些账号会保持未绑定。
- 更换代理地址
- 页面暂不支持直接修改地址。需要更换时，先添加新的代理节点，再删除旧节点。
安全说明link
- 代理地址和账号密码加密保存，页面只显示 IP 和端口。
- 平台只会通过代理连接 Wokey 和模型厂商官方域名的 443 端口。
- 代理只能看到目标地址和加密后的流量，看不到发给模型厂商的请求内容。
- 使用 http:// 或 socks5h:// 时，代理账号密码以明文发给代理服务器；需要保护它们时，请使用 https:// 代理。
常见错误link
添加节点或授权失败时，页面会显示下面的提示，按提示检查即可。
代理账号或密码验证失败，请确认认证信息后重试。
proxy_auth_failed无法连接代理服务器，请检查 IP、端口和 VPS 防火墙设置。
proxy_connect_failed连接代理服务器超时，请确认端口已开放且 VPS 可以访问平台。
proxy_connect_timeout代理地址必须是公网 IP 或公网域名，不能使用 localhost 或内网地址。
proxy_address_not_public协议选择与代理地址前缀不一致，请检查协议和代理地址。
proxy_protocol_mismatch代理协议握手失败，请确认协议类型和代理服务配置。
proxy_handshake_failed无法建立到 HTTPS 代理的安全连接，请检查代理证书和地址。
proxy_tls_failed代理无法连接目标地址（平台验证地址或模型厂商），请检查 VPS 的出站网络、防火墙和目标白名单。
proxy_target_connect_failed代理账号或密码格式不正确。请检查用户名、密码及 URL 编码。
invalid_proxy_auth代理节点数量已达到上限，请先删除不再使用的节点。
proxy_node_limit授权时提示厂商不支持出口节点所在网络的地区
代理出口在模型厂商不支持的地区（例如中国大陆）。请换用受支持地区的代理，再重新授权。