Provider Node/节点接入指南

Provider Node

Provider Node 是接入 Wokey 云路由的节点组件，不是独立自托管的 API 网关。把用不完的 AI 订阅接入平台，用的人省钱，出的人赚钱。

code

开源项目

Provider Node 完全开源，节点行为可自行审计。可在 GitHub 查看源码、自行构建、核对发布版本或反馈问题。

open_in_new在 GitHub 查看源码
本页内容expand_more

整个过程就是：在你电脑上 装 一个节点程序 → 把它 绑定 到你的 Wokey 账号 → 在节点里 授权 你的订阅。之后节点在线时，平台就把别人的调用路由到你的订阅，你按调用拿收益。

1装节点2绑定到账号3授权订阅

已有代理服务器？不用安装节点，直接把代理 IP 添加为节点： 使用代理 IP →

checklist

开始前

30 秒确认
workspace_premium

一个受支持的订阅

Claude、ChatGPT（OpenAI）、智谱、Kimi 等 AI 订阅套餐。

computer

一台电脑或服务器（VPS）

macOS / Windows / Linux 均可，无需常开。

1

装节点

推荐一行命令安装。macOS / Linux 用 bash，Windows 用 PowerShell；也支持 Docker 安装。无需预装环境：若缺少 Node.js，安装器会自动装好（Windows 用 winget 或官方安装包，macOS 用 Homebrew 或官方安装包，Linux 用官方预编译包）。

curl -fsSL https://github.com/focuxdot/wokey-provider-node/releases/latest/download/install.sh | bash
check_circle

成功标志：安装完成后会自动打开本机节点管理页面 127.0.0.1:16888。看到这个页面就成功了。

chevron_right备用安装包（各系统）
downloadmacOS DMGdownloadWindows x64 zipdownloadUbuntu / Debian amd64downloadLinux x64 tarballdownloadLinux arm64 tarball
2

绑定到账号

把这台节点和你的 Wokey 账号关联起来，这样收益才会记到你名下。

  1. 1在节点管理页面 127.0.0.1:16888 点击「一键绑定」。
  2. 2跳转到 Wokey Provider 页面并登录供应方账号，确认绑定。
  3. 3页面自动返回节点管理页面，绑定完成。
check_circle

成功标志：能进入节点管理页面；并在 Provider 页 /provider 看到这台在线节点。

chevron_right远程 / 无浏览器（CLI 绑定）
远程 / 无浏览器（CLI 绑定）
wokey-node add
wokey-node bind --value bind_...
wokey-node list
3

授权订阅

节点在线后，直接在 Provider 页 /provider 点「添加凭证」授权你要共享的订阅——授权请求会经你绑定的节点出口完成（也可在节点本机管理页操作）。

  1. 1在 /provider 点「添加凭证」，选「OAuth 授权」（Claude / ChatGPT / Grok 订阅账号）或「API Key 授权」。
  2. 2Claude：跳转登录后回填授权码；ChatGPT：在验证页输入设备码；Grok：点一次「去授权」，页面会在后台生成设备码并打开已预填授权码的 Grok 页面。
  3. 3出口节点默认按你当前网络自动匹配，通常无需手动选择；有多个节点时可点「更换」。
安全口径：① Provider Node 完全开源，节点行为可自行审计；② 节点装在你电脑上只作为网络出口，且默认只允许连接模型厂商的官方域名（白名单见仓库 official-exit-vendors.ts），不会访问任何其他地址。
check_circle

成功标志：在 Provider 页看到这条已启用的凭证即成功。

chevron_rightAPI Key / 远程导入
API Key / 远程导入
wokey-node import
wokey-node paste token --vendor openai --file ./token.json
rocket_launch

跑起来之后

bolt

在线 ＝ 收益

节点在线时，平台才会把调用分配到你的账号并产生收益。

schedule

无需常开

不必一直在线，随时上线即可加入，离线也不会影响账号——只是离线期间没有这段时间的收益。调用大多集中在白天工作时段，按平时用电脑的时间开着通常就够了。

pause_circle

想暂停

在节点管理页面关闭供应开关，或直接关闭节点程序即可。

收益与提现都在控制台查看。

payments打开 Provider 控制台
help

遇到问题

error节点装在 VPS 上，怎么打开节点管理页面？

先在 VPS 运行上面的 macOS / Linux 安装命令，并用 wokey-node status 确认节点正常。再在本地电脑运行 ssh -i /path/to/your-key.pem -o IdentitiesOnly=yes -N -L 16888:127.0.0.1:16888 ubuntu@服务器IP，保持窗口开启，然后访问 http://127.0.0.1:16888。不要把 VPS 的 16888 端口开放到公网。

errorClaude、ChatGPT（OpenAI）和 Grok 是三选一吗？一个节点可以添加多个账号授权吗？

不是三选一。一个节点可以授权添加多个不同 Claude / ChatGPT / Grok 账号，同一个 Wokey Provider 账号也可以绑定多个节点。添加下一个账号时，在 Provider 页 /provider 点「添加凭证」重复授权流程即可。

error节点可以绑定到别人的 Wokey 账号吗？一个账号可以绑定多少个节点？

可以。节点和 Wokey 登录账号解耦，绑定到哪个 Provider ID 取决于使用哪一个一次性绑定码；平台不限制一个 Provider 账号绑定节点数量。朋友想一起共享时，对方只需要安装并运行 Provider Node，再用你 Provider 页面生成的绑定码绑定到你的 Provider ID。

error节点离线后如何重新上线？

在安装节点的电脑或服务器上运行 wokey-node restart 即可重新启动并尝试上线；如果想确认是否恢复，再运行 wokey-node status。status → restart → status 的三步流程只用于排障，正常重新上线不需要执行三条命令。

error调用失败 / 凭证报错？

检查授权凭证是否过期，必要时在节点重新接入；查看 wokey-node logs。

error如何更新或卸载 Provider Node？

请在节点主机上，以运行 Provider Node 的同一个系统用户执行命令。macOS、Linux、Windows 使用 wokey-node update 更新；macOS 使用 wokey-node uninstall 卸载，添加 --purge 会同时清除本地数据。Linux / Windows 先运行 wokey-node uninstall-service，再移除安装包或运行目录。Docker 使用 docker compose pull && docker compose up -d 更新；docker compose down 保留数据，docker compose down -v 会清除节点绑定和本地授权数据。

menu_book更多问题

联系支持

terminal

命令行参考

远程 / 进阶

安装后可直接用 wokey-node 管理本机节点。无参数会打开交互式菜单；远程服务器建议优先用命令行。

绑定

绑定
wokey-node add
wokey-node bind --value bind_...
wokey-node list

状态

状态
wokey-node
wokey-node status

凭证

凭证
wokey-node import
wokey-node paste token --vendor openai --file ./token.json

更新与维护

更新与维护
wokey-node version
wokey-node update
wokey-node restart
wokey-node status
wokey-node logs

卸载（macOS）

卸载（macOS）
wokey-node uninstall
wokey-node uninstall --purge

移除服务（Linux / Windows）

移除服务（Linux / Windows）
wokey-node uninstall-service

Docker 更新与卸载

Docker 更新与卸载
docker compose pull
docker compose up -d
docker compose down
# 清除本地数据
docker compose down -v