@berthos/registry-server

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

本地应用注册表:发布/发现/安装本地应用(阶段5)

中文使用文档
文档目录3 节
  1. 使用
  2. 限制
  3. 文档

@berthos /注册中心服务器

一个小的,自托管的注册表,用于在团队或封闭的网络中共享驻留应用程序。 berth publish 上传一个应用程序到它,然后 berth init --registry 从1开始一个新项目。

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

npm install -g @berthos/registry-server

使用

berth-registry                                              # listens on http://127.0.0.1:4873
berth publish --registry http://localhost:4873              # from an app's directory; prints an owner token
berth init my-app --registry http://localhost:4873 --template notes

名称的第一次发布打印所有者令牌。保存它:它不会再次显示,并且该名称的每个后续版本都需要它(--token 或者 BERTH_REGISTRY_TOKEN)。

Env var默认的它是做什么的
BERTH_REGISTRY_PORT4873监听端口
BERTH_REGISTRY_HOST127.0.0.1绑定地址; 0.0.0.0 接受远程连接
BERTH_REGISTRY_DATA_DIR./.berth-registry-dataSQLite索引和上传的包
BERTH_REGISTRY_TLS_CERT, _KEY, _CA, _REQUIRE_CLIENT_CERT设置为HTTPS

要嵌入它, createRegistryServer({ dataDir, tls?, logger? }) 返回一个实例;呼叫 .listen() 你自己。

限制

  • 单节点,无用户或速率限制。唯一的凭证是每个名称的所有者令牌,它不能被恢复或旋转。
  • 当它在另一台机器上时,通过HTTPS提供它,因此所有者令牌不会以明文形式发送。

文档

应用注册表参考 · TLS · 回购

版本与发布记录

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

版本发布日期距今
0.3.1latest2026/10/312 天前
0.3.02026/10/277 天前
0.2.42026/09/271 个月前
0.2.32026/09/271 个月前
0.2.22026/09/271 个月前
0.2.12026/09/271 个月前

关于 @berthos/registry-server 的常见问题

@berthos/registry-server 是什么?

本地应用注册表:发布/发现/安装本地应用(阶段5)

如何安装 @berthos/registry-server?

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

@berthos/registry-server 支持 TypeScript 吗?

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

@berthos/registry-server 支持 ESM 还是 CommonJS?

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

@berthos/registry-server 需要什么版本的 Node.js?

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

@berthos/registry-server 可以商用吗?

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

@berthos/registry-server 还在维护吗?

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