# @agentconnect\.md/setup 中文文档

规范地址：https://npmcn.com/package/%40agentconnect.md/setup/

版本：2\.13\.0
npm 元数据更新时间：2026-11-10T22:22:45.225Z
中文译文更新时间：2026-11-10T22:23:54.033Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40agentconnect.md/setup
原文对照：https://npmcn.com/package/%40agentconnect.md/setup/?lang=original
源码仓库：https://github.com/agentconnect-md/agentconnect

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

- 包体积（解压后）：20.3 MB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.12\.0
- 运行依赖：0 个
- 首次发布：2026-08-06T00:14:41.599Z
- 最新版本发布：2026-11-10T22:22:44.840Z
- 近 30 天下载量：33064（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：952（近 12 个月 952 个）

## 中文简介

AgentConnect 自我托管的设置服务器

## 安装

```sh
npm install @agentconnect.md/setup
```

也可以使用：`pnpm add @agentconnect.md/setup`、`yarn add @agentconnect.md/setup`、`bun add @agentconnect.md/setup`

## README

# `@agentconnect.md/setup`

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

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

## 用多克编曲运行

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

```bash
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, 人民组织](https://npmcn.com/package/docs/designs/azure-devops-integration.md#33-people)。 。 。 .

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

## 从源头运行

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

```bash
pnpm --filter @agentconnect.md/setup dev
```

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

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

```dotenv
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端点则来自它们. 变动 在应用更新的提供者之前, 环境和重新启动设置服务器 设置.

## 配置属性

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

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

```bash
docker compose restart control-plane relay web
```

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

## 常见问题

### @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 和提交记录判断。