返回“运行命令清单”:
service及其子命令用法
使用gmzta service
功能在飞网网络内安全地共享本地服务。
gmzta service [参数] <target>
要在互联网上共享本地服务,请使用gmzta in
。
service 子命令用法
子命令参数 | 说明 |
---|---|
info | 查看当前配置 |
reset | 重置当前的service/in配置 |
gmzta service
可用的参数
--bg, --bg=false
后台运行(默认为false)
--http uint
在指定端口公开HTTP服务
-https uint
在指定端口公开HTTPS服务(默认开启)
--set-path string
将指定的路径添加到基本 URL 中,以便访问基础服务。
--tcp uint
在指定的端口上公开一个TCP转发器,用于转发原始TCP数据包。
--tls-terminated-tcp uint
在指定的端口上公开一个TLS终止的TCP转发器,用于转发已终止TLS的TCP数据包。
--yes, --yes=false
更新时没有交互提示(默认为false)
使用HTTPS和HTTP服务器
gmzta service --https=<port> <target> [off]
gmzta service --http=<port> <target> [off]
service
功能提供了一个具有几种模式的 HTTPS 和 HTTP 服务器:反向代理、文件服务器和静态文本服务器。使用自动预配的 TLS 证书保护 HTTPS 流量。默认情况下,终止由节点的飞网服务程序(gmztad)完成。
--https=<port>
或http=<port>
指定要监听的端口。--set-path
是一个以斜线分隔的URL路径。根级挂载点将简单地通过 / 向 发出请求来匹配 https://my-node.example.gmzta.net/ ,例如:gmzta service --set-path=/index 8080
此时访问服务的URL地址为https://devicename.example.gmzta.net/index
target
service 提供了 4 个用于提供内容的选项:HTTP 反向代理、文件、目录和静态文本。- 要充当本地后端的反向代理,请提供
<target>
参数的位置。本地服务的位置可以表示为端口号(例如3000)、部分URL(例如localhost:3000
)或包含路径的完整URL(例如tcp://localhost:3000/index
,https+insecure://localhost:3000/index
)。注意,代理目前只支持http://127.0.0.1
。
例如:
gmzta service localhost:3000
。或者,要通过 HTTP 提供服务,例如:gmzta service --http=80 localhost:3000
,HTTP 服务器可以通过简短的设备名称访问,例如 http://devicename- 文件服务器,提供要服务的文件或文件目录的完整、绝对路径。如果指定了目录,这将呈现一个简单的目录列表,其中包含指向文件和子目录的链接。
例如:
gmzta service /home/test/index.html
- 静态纯文本服务器,例如:
gmzta service text:"hello gmzta"
- 要充当本地后端的反向代理,请提供
使用TCP转发器
service --tcp <port> tcp://localhost:<local-port> [off]
service --tls-terminated-tcp <port> tcp://localhost:<local-port> [off]
service
命令提供了一个 TCP 转发器,可用于将原始 TCP 数据包和 TLS 结尾的 TCP 数据包转发到本地 TCP 服务器或其他基于 TCP 的协议。默认情况下,TCP 转发器转发原始数据包。
--tcp <port>
设置侦听指定端口的原始 TCP 转发器。您可以使用任何有效的端口号。--tls-terminated-tcp <port>
设置侦听指定端口的 TLS 终止的 TCP 转发器。您可以使用任何有效的端口号。tcp://localhost:<local-port>
指定要将数据包转发到的本地端口。
使用有效证书
gmzta service <https:target>
如果您有一个有效的证书,请在<target>
参数中使用https。例如:gmzta service https://localhost:8443
忽略无效证书和自签名证书检查
gmzta service <https+insecure:target>
如果使用具有自签名证书或其他无效证书的 HTTPS 运行本地 Web 服务器,则可以将 gmzta service
命令指定 https+insecure
为特殊的伪协议。
例: gmzta service https+insecure://localhost:8443
查看所开启服务的状态
gmzta service info [--json]
要查看服务器的状态,可以使用 info
子命令。这将列出节点上当前运行的所有服务器。如果您希望以 JSON 格式查看状态,您可以加上 --json
参数
重置飞网本地服务
要清除当前gmzta service
的配置,请使用gmzta service reset
命令。
禁用飞网本地服务
要关闭gmzta service
命令,您可以在用于打开它的命令的末尾添加off
。
如果使用此命令开启本地服务:
gmzta service --https=443 /home/test/index.html
您可以通过运行以下命令将其关闭:
gmzta service --https=443 /home/test/index.html off
重新开启飞网对飞网本地服务的影响
如果将 gmzta service
命令与 -bg
参数一起使用,它将在后台持久运行,直到禁用它。当您重新启动设备或使用命令 gmzta on
和 gmzta off
重新启动飞网时,service本地服务功能将自动恢复。
如果使用 gmzta service
不带-bg
参数的命令,然后重新启动设备或使用命令行重新启动飞网,则必须手动重新启动service才能恢复共享。