@agentconnect.md/setup

中文文档
2.13.0发布于 2026/11/11Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 3.3万

AgentConnect 自我托管的设置服务器

中文使用文档
文档目录3 节
  1. 用多克编曲运行
  2. 从源头运行
  3. 配置属性

@agentconnect.md/setup

基于浏览器的 AgentConnect 自宿服务器 。 它配置了 Logto , (Logto ), GitHub, GitLab, Gitea, Slack, Google Chat, Linear, Google, Feishu, 和拉克 通过一个经认证的本地操作员表面。 供应商身份和只写证书存储于 部署数据库; UI 从未返回存储的秘密值.

此软件包没有命令行设置接口. 提供者创建, 匹配 全部检查、编辑、秘密替换和清除提供者配置 发生在设置.

用多克编曲运行

本地认证堆栈包括设置服务器 :

docker compose -f compose.yaml -f compose.logto.yaml up -d

打开 :

  • 设置 : http://localhost:8091
  • Logto 控制台 : http://localhost:3002
  • 代理连接 : http://localhost:3000

设置首先通过 Logto 管理 API 设置来引导操作员. 这个 在管理员签名之前不显示部署配置 进来 第一个注册用户被指定共享 ADMIN 角色; 一次签名 更何况新颖的标志 包含了这个角色.

Google 是最短的本地登录路径,因为它的 Web OAuth 客户端接受 捆绑的裸体 localhost 来源。 直到每个孩子都残疾 需要公共服务的URL使用HTTPS.

管理 Azure DevOps 寄存器选择需要控制台登录通过 与微软账户链接的 Logto (azuread)启用。 每个人使用他们的 已有链接的微软账户; 没有额外的 Azure DevOps 授权 请求。 环回无自动堆栈无法创建或增加这些寄存器 赠款。 连接和维持该组织的Azure应用程序 使用现有的管理流程。 见 Azure DevOps, 人民组织。 。 。 .

通过自己的身份提供者签名的组织可以选择 单笔签名( OIDC 或 SAML) 而不是一个社会提供者。 设置先问 创建连接器并显示重定向 URI (OIDC) 或 ACS URL的日志 和SP实体ID(SAML)向身份提供者登记;提供者 发行商和客户端,或其SAML元数据,以及至少一个 电子邮件域名: Logto 不通过连接器提供登录。 一个 私人网络上的身份提供者也需要地址: LOGTO_SSRF_ALLOWED_ADDRESSES。 。 。 .

从源头运行

启动数据库和可选 Logto 服务, 然后直接运行服务器 :

pnpm --filter @agentconnect.md/setup dev

进程读取寄存器 .env 并倾听 127.0.0.1:8091 以 默认. HOST 财务报告和审定财务报表 PORT 控制约束. DATABASE_URL 编辑 SECRET_CIPHER编号 :VAULT_* 根设置仍然是启动环境,因为它们 在部署数据库打开之前需要这样做.

公共服务基地URL也是启动环境. 控制飞机和 中继 URL 可能包括一个入侵路径前缀 :

AGENTCONNECT_PUBLIC_WEB_URL=https://gateway.example.test
AGENTCONNECT_PUBLIC_CP_URL=https://gateway.example.test/cp
AGENTCONNECT_PUBLIC_RELAY_URL=https://gateway.example.test/relay

设置在顶端显示这些值,因为 GitHub 和 Slack 显示 GitLab重定向URI,而Google Chat HTTP端点则来自它们. 变动 在应用更新的提供者之前, 环境和重新启动设置服务器 设置.

配置属性

每个供应商都有一张卡片 里面有它现在的身份 隐蔽的秘密状态, 匹配状态,并编辑/创建/清晰控件。 清除提供者删除其 存储的身份和秘密 所以它的创造流又可以使用.

所保存的部署更改是启动配置而不是热重装. 编辑后恢复消费服务 :

docker compose restart control-plane relay web

设置服务器绑定在提供的"Confose"堆栈中回放. 遥控器 主机, 将端口移到 SSH 上, 而不是公开曝光此 HTTP 服务 .

版本与发布记录

@agentconnect.md/setup 共发布 952 个版本,首次发布于 2026/08/06;过去 12 个月发布了 952 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.13.0latest2026/11/11今天
2.13.0-rc.102rc2026/11/11今天
2.13.0-rc.1012026/11/11今天
2.13.0-rc.1002026/11/11今天
2.13.0-rc.992026/11/11今天
2.13.0-rc.962026/11/11今天

其他发布通道:bootstrap → 0.0.0,rc → 2.13.0-rc.102。

关于 @agentconnect.md/setup 的常见问题

@agentconnect.md/setup 是什么?

AgentConnect 自我托管的设置服务器

如何安装 @agentconnect.md/setup?

在项目目录运行 npm install @agentconnect.md/setup,或使用 pnpm add / yarn add / bun add。

@agentconnect.md/setup 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/agentconnect.md__setup 是否存在。

@agentconnect.md/setup 支持 ESM 还是 CommonJS?

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

@agentconnect.md/setup 需要什么版本的 Node.js?

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

@agentconnect.md/setup 可以商用吗?

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

@agentconnect.md/setup 的下载量有多少?

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

@agentconnect.md/setup 还在维护吗?

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