Z Tag
管理组织服务与凭证配置

SSH

配置 SSH 登录账号与凭证、主机公钥和允许的操作。

适用于组织 Owner / Admin;成员的个人连接器同样适用

在连接器的 访问内容 → 添加访问 中,在 原生资源 里选择 SSH,填写一台目标主机。保存后,ZAI 可以在这台主机上执行命令、使用交互终端或传输文件,具体能做哪些由下面的 允许的操作 和登录用户的权限决定。

服务地址

目标地址 填写服务器的主机名或 IP,端口 默认 22;非标准 SSH 端口按服务器管理员提供的值填写。内网服务器需要所属连接器指定网络隧道,或有匹配的内网路由,见内网路由要求。

账号与凭证

用户名 填写目标主机的登录用户。认证方式 选择 密码 或 私钥:密码填写该用户的 SSH 密码;私钥填写与服务器 authorized_keys 中公钥配对的完整私钥。加密私钥还要填写 私钥密码,未加密的私钥留空。

密钥对可以由服务器管理员签发,或用 OpenSSH 工具生成。私钥是以 BEGIN / END 行包围的完整内容,不是 .pub 公钥,也不是本地文件路径。密码和私钥只由平台使用,不会交给 ZAI。

主机公钥

从服务器管理员、服务器控制台或其他可信渠道获取 SSH 服务器的主机公钥。每行填写一条公钥,格式为 <算法> <公钥 Base64>,最多 16 行。这是服务器的身份,用于验证连接到了正确的主机;它不同于登录用户的公钥。

ssh-keyscan 可以收集候选公钥,但它的输出行首带有主机名,粘贴前要删掉;也可以直接使用服务器上 ssh_host_*_key.pub 文件的内容。首次获取的公钥仍需通过可信渠道核对指纹,不要把尚未核验的网络结果当作可信身份。

允许的操作

执行命令、交互终端 和 文件传输(SFTP)默认全部开启,按需要关闭不用的能力,但至少保留一项;三项都关闭时,表单提示「至少保留一项允许的操作」。实际的文件和命令权限仍由登录用户决定;端口转发、agent forwarding 和其他 SSH 子系统不开放。

维护

SSH 凭证没有平台到期时间。已有凭证在行菜单中可以 编辑、替换凭证、撤销凭证 或 删除。撤销或删除后,ZAI 不能再通过这个连接器连接这台主机;删除不可恢复。ZAI 每次连接的时长有上限,见常用限制。

验证

保存后,请 ZAI 在这台主机上执行一条只读命令,或列出有权限的目录。主机公钥不匹配时,先核对服务器或它的主机密钥是否已经更换;不要为了消除报错,就把报错中出现的新公钥不经核对直接填进去。其余排查见验证与排错。

官方说明:OpenSSH 手册。

本页目录