Helper 命令

stellar-helper 是桌面客户端使用的特权 helper。大多数用户应直接在 Stellar 客户端中操作。命令行主要用于调试、测试路由，或直接控制 helper daemon。

全局参数

  • --log LEVEL：设置日志级别。可用值包括 quiet、info、verbose、debug、very-verbose、very-very-verbose。
  • stellar-helper version：输出 helper 版本、构建信息和运行环境。

不带命令运行 stellar-helper 时，会启动 RPC daemon，等同于 stellar-helper rpc。

登录

stellar-helper login

提示输入邮箱/手机号/用户名和密码，并保存 authorization token，供后续 helper 请求使用。

连接

stellar-helper connect --area HKG --proxyMode allowlist --computerMode off
stellar-helper connect --server HOST:PORT --token TOKEN --sn cloudflare.com --proxyMode global

connect 会应用一次连接请求。如果 daemon 已经可用，该命令会把请求发送给 daemon；否则会在当前进程中运行代理。

常用参数：

  • --area AREA：使用已知地区代码连接。
  • --lineIndex N：从拉取到的线路列表中选择线路，避免交互输入。
  • --server HOST:PORT：连接指定代理服务器。
  • --token TOKEN：直接连接服务器使用的 token。
  • --sn NAME：TLS/SNI 使用的服务器名称，默认是 cloudflare.com。
  • --proxyMode MODE 或 -p MODE：HTTP 模式。可用 off、allowlist、denylist、global、transparent。
  • --computerMode MODE 或 -c MODE：电脑/TUN 模式。可用 off、allowlist、denylist、global、gbd。
  • --httpProxyPort PORT：本地 HTTP 代理端口，默认 8668。
  • --socksProxyPort PORT：本地 SOCKS5 代理端口，默认 1080。
  • --shareHttp：允许其他设备连接本机 HTTP 代理。
  • --proxyChina：代理中国区域流量。
  • --no-routes：只运行 HTTP/SOCKS，不修改系统路由。
  • --local：即使 daemon socket 可用，也强制在当前进程运行。

调试参数：

  • --hijack-https：启用 HTTPS MITM 检查。
  • --hijack-regex REGEX：只对匹配的主机启用 HTTPS hijack。

RPC daemon

stellar-helper rpc
stellar-helper rpc --listenAddr /tmp/stellar-helper.sock

启动 daemon RPC 服务。默认在 macOS/Linux 监听 /tmp/stellar-helper.sock，在 Windows 监听 :43210。

参数：

  • --listenAddr 或 -l：覆盖 daemon socket 或监听地址。
  • --ws：开启 :8888 上的调试 WebSocket 日志服务。

控制 daemon

ctl 会连接一个已经运行的 daemon，不会启动 daemon。

stellar-helper ctl ping
stellar-helper ctl state
stellar-helper ctl state --json
stellar-helper ctl set-timeout 30

子命令：

  • ping：检查 daemon 是否可达。
  • version：输出 daemon 报告的版本。
  • state：输出路由状态、当前域名、代理端口、延迟、丢包率和流量计数。
  • reselect-domain：要求 daemon 重新选择 API 域名。
  • restore-route：恢复系统默认路由。
  • reset-routes：清理旧路由并恢复默认路由。
  • reset-network：强制默认网卡 down/up。
  • restart-service：要求 daemon 通过服务管理器重启自身。
  • set-timeout MINUTES：设置 daemon 自动停止时间。

任何 ctl 命令都可以使用 --socket PATH 覆盖 daemon socket。

路由工具

stellar-helper routes --list-links
stellar-helper routes --flush --dry-run
stellar-helper routes --reset

路由命令用于修复和调试。部分参数会修改系统路由，可能需要管理员权限。

  • --list-links：列出网络接口。
  • --flush 或 -f：清理非默认路由。
  • --dry-run：只打印操作，不实际修改路由。
  • --reset 或 -r：删除旧路由并恢复默认路由。