@berthos/mesh-coordinator

中文文档

0.3.1发布于 2026/10/31Apache-2.0TypeScriptES Module构建来源已验证

泊位的WireGuard网格的协调服务：分配稳定的网格ip，交换公钥，并在引入它们之前相互匹配对等体（参见docs/mesh-reference.md）

@berthos / mesh-coordinator

Berth的WireGuard网的主机端服务。它为每个沙箱提供一个稳定的网格IP，交换公钥，并只在每个应用程序都是 network:peer:<name> 能力为另一个命名。

泊位在沙盒中运行人工智能代理的工具。每个工具在类中声明它可以接触什么 berth.yml manifest， Linux内核强制执行它。

npm install -g @berthos/mesh-coordinator

BERTH_MESH_COORDINATOR_HOST=0.0.0.0 berth-mesh-coordinator   # listens on 4875
berth dev --mesh-coordinator=http://host.docker.internal:4875

Env var	默认的	它是做什么的
`BERTH_MESH_COORDINATOR_PORT`	`4875`	监听端口
`BERTH_MESH_COORDINATOR_HOST`	`127.0.0.1`	绑定地址。容器通常不能到达主机的环回，所以设置 `0.0.0.0` 或者桥接地址
`BERTH_MESH_COORDINATOR_DATA_DIR`	`./.berth-mesh-coordinator-data`	SQLite数据库
`BERTH_MESH_COORDINATOR_TLS_CERT`， `_KEY`， `_CA`， `_REQUIRE_CLIENT_CERT`	设置	为HTTPS

要嵌入它， createMeshCoordinatorServer({ dataDir, tls?, logger? }) 返回一个tify实例。

内核无法区分每个应用程序的WireGuard流量，因此协调器的相互匹配决定了哪些应用程序可以相互访问。把它放到只有你能控制的地方。

@berthos/mesh-coordinator 共发布 6 个版本，首次发布于 2026/09/27；过去 12 个月发布了 6 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

泊位的WireGuard网格的协调服务：分配稳定的网格ip，交换公钥，并在引入它们之前相互匹配对等体（参见docs/mesh-reference.md）

在项目目录运行 npm install @berthos/mesh-coordinator，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 berth-mesh-coordinator，可以用 npx berth-mesh-coordinator 直接运行。

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

package.json 的 engines 字段要求 Node.js >=22.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@berthos/mesh-coordinator 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

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