ZeroNews CLI 一条命令搞定内网穿透

0 阅读1分钟

如果你用过 ZeroNews,大概知道它能把本地服务穿透到公网。网页版已经够用了,但每次都要打开浏览器、登录、点来点去,有没有更简单、更省事的一种方式?

ZeroNews CLI 能很好的解决这个问题,在最新发布的 V4.0.0版本中,ZeroNews 已经完成对 CLI 的支持。

用户装好之后,用户在终端命令行里敲几个命令,加映射、查状态、恢复配置,全搞定,不用碰浏览器。

同时可以与 AI Agent 更好的对接,让 Agent 帮你干活,自动帮你完成客户端认证、添加映射。

CLI 是什么?

简单说,CLI 就是在终端里敲命令来操作程序,不需要鼠标、不需要浏览器,打开终端输入一行命令就能搞定。

在过去,CLI 常用于远程管理 Linux 服务器,网络设备,使用场景很受限, 而现在 AI Agent 时代, CLI 模式已成为 Agent 的标配,通过 CLI ,Agent 可以直接调用工具、执行命令、看结果、再决定下一步怎么做——整个流程它自己跑完,AI 自己把活全干了,不只是给建议,而你只需要说一句话。

为什么要用 CLI 模式?

有几个场景,用 CLI 会比网页版顺手很多:

在服务器或容器里

服务器通常没有图形界面,Docker 容器更是如此。这时候 CLI 是唯一能用的方式

写自动化脚本

部署脚本跑完之后自动开穿透,CI/CD 流程里加一行命令,完全不需要人来手动点

重复操作太烦了

每次都要打开浏览器、登录、找到对应的配置、点几下,用 CLI 一条命令就完事

让 AI 帮你操作

你在用 Cursor 或者其他 AI 工具的时候,直接让它帮你管理穿透配置,AI 靠的就是 CLI

团队共享配置

CLI 的配置可以存成文件放到 git 里,新同事拉下来跑一下就能复现同样的环境

ZeroNews 为什么要做 CLI?

网页版已经挺够用的,但现在的Agent时代,用 AI Agent 帮自己干活的人越来越多了。

你让 Claude 或者 Cursor 帮你把服务跑起来,它能写代码、能跑命令,但没法帮你去点网页。

没有 CLI 的话,穿透这一步就得你自己手动来,AI 帮不上忙。所以做好 CLI,AI 才能把整个流程都接管掉,你真的只需要说一句话 。

一个典型的开发场景:你在本地写完代码,跑个脚本部署上去,服务起来了——然后还要专门切出去开个浏览器,登录,找到配置页面,点几下加个映射。整个节奏就这么被打断了,挺烦的。

CLI 就是为了把这个步骤省掉。穿透配置直接写进部署流程,跟启动服务的命令放在一起,一起跑,一气呵成。

ZeroNews CLI 是什么?

ZeroNews CLI 就是 ZeroNews 的命令行版本。

你原来在网页上能干的那些事——绑定账号、加映射、查状态、还原配置——现在在终端里敲几个命令就能搞定。

比如加一条映射,就这一行:

zeronews add --name my-app --type http --local-port 3000

不用登录网页,不用找到对应的按钮,敲完回车就完事。

ZeroNews ClI 指令集:

ZeroNews client helps you expose local services with a managed data-plane and gateway workflow

Available Commands:

  1. add                Add a tunnel to expose a local service

  2. authtoken      Authenticate your client with the zeronews server

  3. completion    Generate the autocompletion script for the specified shell

  4. endpoints      List running local endpoints

  5. help               Help about any command

  6. reload            Reload the running local client by reconnecting to the cloud server

  7. reset              Uninstall service and remove local workdir state

  8. service           Manage zeronews client as a system serviceservice

  9. shutdown      Gracefully stop the running local zeronews client

  10. start              Start the local zeronews host and HTTP API

  11. status            Show local client runtime status

  12. Flags:

  13. -h, --help help for zeronews

  14. -v, --version version for zeronews

  15. --workdir string Absolute path to the client workdir

ZeroNews CLI 能干什么?

ZeroNews CLI 能覆盖几乎所有的映射操作,涵盖了日常用穿透的核心操作,下面列出几种典型操作。

  • 加映射

想把本地某个端口暴露出去,直接一条命令:

Web 服务

zeronews add --name api-server --type http --local-port 8080

TCP 服务,比如 SSH

zeronews add --name ssh-tunnel --type tcp --local-port 22

跑完之后,公网地址直接打印出来,复制走就能用,不用去页面上找。

  • 设备认证与配置恢复

客户端 TOKEN 认证

zeronews authtoen <TOKEN>

换机器或者容器重启之后,不想一条条重新加,可以从配置文件直接还原。

zeronews authtoen <TOKEN> <TOKEN_ID>

  • 管理 ZeroNews 程序运行状态

安装客户端服务

zeronews service install

以服务方式启动客户端

zeronews service start

停止服务方式启动客户端

zeronews service stop

  • 看状态

想知道现在有哪些映射,有没有在正常跑?

看全部

zeronews endpoints

输出大概长这样:

→ Running endpoints: 1ENDPOINT ID TYPE DOMAIN LOCAL STATUS ERROR7a29596ec1be4f86bca95d705797439c HTTPS xxxxx.shedge.waitoin.com 127.0.0.1:8000 active -

什么时候用 ZeroNews CLI?

说白了:只要你不想打开浏览器,就用 CLI,真正做到你只要说一句话,就能完成客户端认证、域名分配、映射添加全流程操作**。**