# @ai-ecoverse/wasix-websocat 中文文档

规范地址：https://npmcn.com/package/%40ai-ecoverse/wasix-websocat/

版本：4\.0\.0-alpha3-8
npm 元数据更新时间：2026-10-21T06:24:50.550Z
中文译文更新时间：2026-11-06T14:33:00.015Z
软件包许可：MIT OR Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ai-ecoverse/wasix-websocat
原文对照：https://npmcn.com/package/%40ai-ecoverse/wasix-websocat/?lang=original
项目主页：https://github.com/ai-ecoverse/homescoop/tree/main/packages/wasix-websocat
源码仓库：https://github.com/ai-ecoverse/homescoop

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.5 MB，5 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-16T10:07:50.247Z
- 最新版本发布：2026-10-21T06:24:50.204Z
- 近 30 天下载量：2987（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

websocat,一个WebSocket客户端和服务器,如Netcat用于ws://URLs,用于SLICC.

## 安装

```sh
npm install @ai-ecoverse/wasix-websocat
```

也可以使用：`pnpm add @ai-ecoverse/wasix-websocat`、`yarn add @ai-ecoverse/wasix-websocat`、`bun add @ai-ecoverse/wasix-websocat`

## README

# `@ai-ecoverse/wasix-websocat`

[网络小猫](https://github.com/vi/websocat) 4.0.0-alpha3, WebSocket 客户端和服务器(“netcat for `ws://`" ),为 [块状](https://github.com/ai-ecoverse/slicc)作为WASIX程序的内核. **这是一个上游α:** websocat v4 尚未稳定发布. 它是上游的源头,有两个WASIX补丁(子进程失败干净;见下文)和一个出站码和日志的补丁(见出站码和日志). 该建筑还补丁了板条箱接线和Mio的WASIX叉;参见食谱.

```bash
pnpm add -g @ai-ecoverse/wasix-websocat
websocat -s 8080 mirror:                 # an echo server on the kernel loopback
echo hi | websocat ws://127.0.0.1:8080/  # hi
websocat -b ws://127.0.0.1:8080/ < file  # binary messages
```

需要slic-内核1.95.0或后期(WASIX epoll和eventfd, slic-内核#674).

## 联网

websocat v4 打开了自己的TCP连接,并做了自己的TLS,有生锈和被捆绑的Mozilla根(webpki-broot),所以 `wss://` 不需要CA设置 。 它已经 **没有 HTTP 或 SOCKS 代理支持**所以它从不穿过内核 `https_proxy`。 。 。 .

-   **内核回转** (单位:千美元)`127.0.0.1`, (中文(简体) ), `localhost`总是工作.
-   **其他主机** (单位:千美元)`ws://example.com/`, (中文(简体) ), `wss://…`)需要一个输出,给出程序原始TCP:在7个中,一个链接到的slic CLI或Tailscale输出节点(内核的上行链路). 没有一个人:
    -   名称失败 `No such file or directory (os error 44)`· ;
    -   地址失败 `Network unreachable`。 。 。 .
-   **没有 TLS 服务器 :** 网络猫v4不能服务 `wss://`。 。 。 .
-   **证书通过上行链路覆盖的内容:** `ws://` 回声,和 `wss://` 与 `-k`这是TLS握手和陷害一个被抛弃的CA 链的校验使用嵌入式的webpki根,被slic-bio所覆盖到底.

## 对WASIX的限制

-   **没有子进程** (homescoop#689,#709):websockat的流程支持在这个目标上没有效果. `exec:`, (中文(简体) ), `cmd:` 财务报告和审定财务报表 `sh-c:` 启动时被拒绝( e)`exec:, cmd: and sh-c: are not supported on WASIX`),同样 `--exec-after-listen`内 `-x` 情景剧本, `subprocess_new`, (中文(简体) ), `subprocess_new_osstr` 财务报告和审定财务报表 `system` 失败 `subprocesses are not supported on WASIX`。每个病例都非零,没有恐慌.

## 退出代码和日志

自4.0.0-alpha3-7起,上游 v4 仅登录的故障 退出非零, 每条对数线都到 Stderr, 所以 `websocat … > out` 财务报告和审定财务报表 `websocat … | jq` 只携带数据(homescoop#868). `RUST_LOG` 设置级别( e)`RUST_LOG=debug`, (中文(简体) ), `RUST_LOG=off`; 默认 INFO, housescoop # 1421 :

| 退出 | 何时 |
| --- | --- |
| 页:1 | 连接被拒绝或失败( 上游) |
| 15个 | 收听器无法绑定地址, 例如端口正在使用( homescoop# 696; 上游出入口 0) |
| 16个 | `readfile:`, (中文(简体) ), `writefile:` 或者说 `appendfile:` 无法打开文件( homescoop# 1023; 上游出入口 0) |
| 20, 21 (中文(简体) ) | 主机名没有地址, 或搜索失败( 上游) |

websocat 4是上游的正线,但仍是预放:选项和规格与websocat 1.x不同(参见 `websocat --help`;例如,没有 `-1`) (中文(简体) ).

## 常见问题

### @ai-ecoverse/wasix-websocat 是什么？

websocat,一个WebSocket客户端和服务器,如Netcat用于ws://URLs,用于SLICC\.

### 如何安装 @ai-ecoverse/wasix-websocat？

在项目目录运行 npm install @ai-ecoverse/wasix-websocat，或使用 pnpm add / yarn add / bun add。

### @ai-ecoverse/wasix-websocat 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ai-ecoverse\_\_wasix-websocat 是否存在。

### @ai-ecoverse/wasix-websocat 可以商用吗？

@ai-ecoverse/wasix-websocat 使用 MIT OR Apache-2\.0 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-ecoverse/wasix-websocat 的下载量有多少？

根据 npm 官方下载统计，@ai-ecoverse/wasix-websocat 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,987 次，日均约 100 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ai-ecoverse/wasix-websocat 还在维护吗？

最新版本 4\.0\.0-alpha3-8 发布于 2026/10/21（17 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。