CLI 参考

只需一个二进制文件 addtothese:登录、开启隧道、转发 TCP 端口,全部搞定。你的登录信息保存在 ~/.addtothese/config.yaml(Windows 上为 %USERPROFILE%\.addtothese\config.yaml)。

addtothese login

addtothese login --token att_...

保存 API 令牌。不带 --token 时,会从标准输入读取令牌。addtothese logout 会清除它。

addtothese http

addtothese http <port|host:port|url> [--subdomain name]

公开一个本地 HTTP 服务。不带 --subdomain 时,你会获得一个随机端点;带上它时,隧道会使用你在控制台中保留的名称。网络中断后 CLI 会自动重连,并在凭据过期前自动刷新。

参数默认值说明
--subdomain随机要使用的保留名称
--timeout10s将每个请求转发到你的服务时的超时时间
--access-logtrue输出每个经代理的请求
--log-levelwarndebug、info、warn 或 error

用邮箱验证码保护 URL

addtothese http 4321 --allowed-email ana@gmail.com --allowed-email '*@company.com'

只有你列出的人才能打开该 URL。访客输入邮箱;如果在列表中,就会收到一个 10 分钟内有效的 6 位验证码,并保持登录 24 小时。*@company.com 允许整个域名。每个地址或域名重复使用一次该参数。

你的服务会在 X-AddToThese-Email 请求头中收到经过验证的地址。每次运行都会替换该列表,因此不带 --allowed-email 运行会让 URL 重新变为公开。你也可以在控制台的端点页面编辑该列表。

addtothese tcp

addtothese tcp 5432 --subdomain mydb

公开一个原始 TCP 端口,例如 Postgres、SSH 或 RDP。需要访问它的人在自己一侧运行转发器,它会打开一个连接到你服务的本地端口:

addtothese forward tcp 5432 mydb --connect.url https://mydb.addtothese.com

之后他们就可以连接 localhost:5432,就像数据库在自己机器上一样。

环境变量

变量说明
ADDTOTHESE_TOKENAPI 令牌,优先于已保存的令牌
ADDTOTHESE_CONFIG备用配置文件的路径