从命令行安装 stellar-helper

桌面客户端已经内置了 stellar-helper。本页面针对独立的 stellar-helper 命令行二进制 —— 适用于服务器、开发环境、无 GUI 的 Linux 桌面，或者任何更习惯命令行操作的场景。

下面所有命令都假设 stellar-helper 已加入 $PATH。按平台选一条安装命令，然后跳到登录部分。

macOS

curl -L -o stellar-helper.tar.gz \
  https://apps.stellar.international/stellar-helper-8.3.1-darwin-universal.tar.gz
tar xzf stellar-helper.tar.gz
sudo install -m 0755 stellar-helper /usr/local/bin/stellar-helper
# 二进制未做 notarize，去掉 Gatekeeper 隔离属性：
sudo xattr -dr com.apple.quarantine /usr/local/bin/stellar-helper

Linux

# 根据主机 CPU 选 arm64 或 amd64。
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
curl -L -o stellar-helper.tar.gz \
  "https://apps.stellar.international/stellar-helper-8.3.1-linux-${ARCH}.tar.gz"
tar xzf stellar-helper.tar.gz
sudo install -m 0755 stellar-helper /usr/local/bin/stellar-helper

Windows（PowerShell）

Invoke-WebRequest `
  https://apps.stellar.international/stellar-helper-8.3.1-windows-amd64.zip `
  -OutFile stellar-helper.zip
Expand-Archive stellar-helper.zip -DestinationPath C:\Stellar
$env:Path += ';C:\Stellar'

如需跨会话保留，请通过"系统属性 → 环境变量"把 C:\Stellar 加入系统 Path。

首次使用

1. 登录

stellar-helper login

按提示输入账号密码（与桌面客户端相同）。Token 会缓存到本机，每台机器只需登录一次。

2. 选择线路

列出当前账号可用的线路：

stellar-helper lines
Available lines:
  0: 香港-广州-1
  1: 台北-GIA
  2: 上海-首尔
  ...

按编号连接（不需要知道技术名）：

sudo stellar-helper connect --lineIndex 0 --computerMode off -p allowlist

或不带 --lineIndex 进入交互选择：

sudo stellar-helper connect --computerMode off -p allowlist
Available lines:
  0: 香港-广州-1
  1: 台北-GIA
  ...
Enter the line index:

进程会前台运行，并打印出代理环境变量，方便把当前 shell 流量挂到代理上：

export http_proxy=http://127.0.0.1:8668
export https_proxy=http://127.0.0.1:8668
# 或者，支持 SOCKS 的工具：
export http_proxy=socks5://127.0.0.1:1080

--computerMode off 只启动用户态代理（HTTP :8668、SOCKS5 :1080）。如果要让整台机器走 TUN 全局代理，把 --computerMode 改成 global 或 allowlist。

3. 查看运行中的隧道

stellar-helper connect 启动后，再开一个终端通过 Unix socket 与它通信：

stellar-helper ctl ping              # → pong
stellar-helper ctl state             # 人类可读状态
stellar-helper ctl state --json      # 可以管道传给 jq
stellar-helper ctl set-timeout 0     # 关闭 5 分钟空闲自动停止

4. 断开

直接 Ctrl-C 前台 connect，路由表与监听端口都会清理掉。如果没有 TTY 访问：

sudo pkill stellar-helper

小贴士

出问题时加 --log verbose 看详细输出。
全局代理模式（--computerMode global/allowlist）需要 sudo，因为要操作路由表和 TUN 设备。
纯 HTTP/SOCKS 模式（--no-routes）只占用用户态端口，不动系统路由，适合在共享机器上使用。
stellar-helper ctl --help 列出 daemon 暴露的所有读写命令，类似本地隧道的 kubectl。