@godspideai/ cognate- execution- ssh (英语)
作为Cognate执行世界的 SSH 主机: 文件覆盖 SFTP, 命令覆盖远程 exec - 在同一个后面 filesystem.* 编号 : process.exec 和所有其他供应商一样,所以在供应商之上没有任何人知道它是SSH。 建造于 ssh2 软件包.
何时使用此软件包 : 一个代理应该读取、写入和运行在远程机器上的命令,您可以通过 SSH 访问( 选择通过 跳转到主机) , 在发送任何消息之前验证主机身份 。 用于当地机器 @godspeedai/cognate-execution是因为 localExecutionWorld;用于 WSL 分布式使用 @godspeedai/cognate-execution-wsl。 。 。 .
安装
bun add @godspeedai/cognate-execution-ssh
要求数 阿宝 1.4.0. 取决于 ssh2 财务报告和审定财务报表 @godspeedai/cognate-execution (合同 这个提供者的工具).
快开始
import { sshExecutionWorld } from "@godspeedai/cognate-execution-ssh";
const world = sshExecutionWorld({
worldId: "build-box",
host: "build.example.com",
username: "dev",
auth: { kind: "key", privateKeyPath: "~/.ssh/id_ed25519" }, // or { kind: "agent" } / { kind: "password", password }
hostKeys: { fingerprints: ["SHA256:..."] }, // REQUIRED — or { knownHostsPath: "/home/me/.ssh/known_hosts" }
jump: [ // ProxyJump, optional; each hop is verified like the target
{ host: "bastion.example.com", username: "dev", auth: { kind: "agent" }, hostKeys: { knownHostsPath: "/home/me/.ssh/known_hosts" } },
],
});
const path = world.fileSystem.resolve("/srv/workspace", "README.md");
const readme = await world.fileSystem.readText(path);
const result = await world.process.exec({ argv: ["cargo", "test"], cwd: "/srv/workspace", timeoutMs: 300_000 });
console.log(world.metadata); // { host, port, username, auth: "key", hostKey: "SHA256:..." } — safe for logs
await world.dispose();
建筑彻底拒绝空置主机钥匙政策. 与新主机的第一个连接应该通过 probeHostKey,它读取服务器的密钥和 拒绝 ——没有经过认证或发送——人类可以决定将所打印的指纹贴上:
import { probeHostKey } from "@godspeedai/cognate-execution-ssh";
const probe = await probeHostKey({ host: "build.example.com" });
console.log(probe.fingerprint, probe.keyType, probe.known); // "SHA256:..." "ssh-ed25519" "unknown"
// Show it to a person; pin it in hostKeys.fingerprints or known_hosts before connecting for real.
它的保证
- 服务器是你钉住的. 主机密钥核查是强制性的——没有信任先用,没有接受-任何方式. 出现不匹配现象
HostKeyMismatchError在试图进行认证之前, 从未进行过再测试 。 平平无奇known_hosts条目,[host]:port表格、通配符、否定和@revoked标记受到尊重;@cert-authority条目被忽略(不支持). - 关闭失败. 无法到达的主机, 已更改的密钥, 或已处理的世界会升起
WorldUnavailableError没有什么会回到当地处决. - 禁闭.
resolve拒绝 lexical 逃逸, 任何读取/ 写入/ stat/ 列表( 通过 SFTP) 之前, 拒绝 root 内部的同义链接realpath) (中文(简体) ). - 一个已取消的命令真的结束 . 在一个主管之下运行的指令, 并有自己的流程组, 结束于
TERM或当stdin到达EOF时——因此整个进程树甚至针对忽略信号请求或放弃连接的服务器而死. - 复相通达. 在下一个操作上重拨了已丢弃的连接; 偶数文件操作重试一次, 命令和写作从不这样做 .
- 清净处置.
dispose()关闭直播频道,SFTP,以及每一次跳;它具有一能性,而后操作失败关闭. - 没有秘密泄露.
metadata携带主机、端口、用户、认证 类型,以及经过验证的主机钥匙指纹——从没有密码,密码,或密钥. 错误也从不重复证书 .
测试您的整合
这个 ./fixture 子路径导出 startSshFixture ——一个真正的进程内SSH服务器(sh2) Server)带有密码/公用钥匙认证,工作 exec,一个 SFTP 子集,以及用于 ProxyJump 的直接 tcpip 转发——这样,你自己的测试就可以运行共享兼容套件,从 @godspeedai/cognate-execution/conformance 对一个没有外部机器的真正的SSH客户端/服务器对.
已知限制
- 远程登录 shell 必须接受
exec sh -c '<posix script>'。 。 。 . version实值mtime(seconds):size(SFTP属性只携带了整秒),所以两个写在同一秒内,大小相等的外观不变. 当地和指挥世界mtime(ns):size:inode。 。 。 .- 并联封存检查是检查时使用:检查与操作之间的并发互换没有被阻止.
- 没有键盘交互/2FA认证和没有
@cert-authority支助.
相关软件包
@godspeedai/cognate-execution合同和合规套件.@godspeedai/cognate-execution-wsl——WSL发行商.@godspeedai/cognateSDK伞.
许可证
阿帕奇 - 2.0