# @hasna/domains 中文文档

规范地址：https://npmcn.com/package/%40hasna/domains/

版本：0\.3\.3
npm 元数据更新时间：2026-10-16T10:22:51.575Z
中文译文更新时间：2026-11-17T11:35:19.778Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40hasna/domains
原文对照：https://npmcn.com/package/%40hasna/domains/?lang=original
项目主页：https://github.com/hasna/apps/tree/main/apps/domains#readme
源码仓库：https://github.com/hasna/apps

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

- 包体积（解压后）：6.7 MB，223 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：12 个
- peer 依赖：@hasna/contacts ^0\.6\.19
- 首次发布：2026-03-26T10:37:30.192Z
- 最新版本发布：2026-10-16T10:22:51.346Z
- 近 30 天下载量：48164（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：50（近 12 个月 50 个）

## 中文简介

域名组合、登记员、市场和人工智能代理的DNS管理——CLI + MCP + HTTP API + SDK、共享账户API和PostgreSQL

## 安装

```sh
npm install @hasna/domains
```

也可以使用：`pnpm add @hasna/domains`、`yarn add @hasna/domains`、`bun add @hasna/domains`

## README

# @ hasna/域名

人工智能代理的域名组合、登记员、市场和DNS管理。 包装了一个CLI,MCP服务器,经过认证的HTTP API,生成了SDK,并输出了库. 每个客户都通过共享的一面来解决其信誉和权威 `@hasna/contracts` 解析器(macOS 键链, `~/.hasna/domains/config/credentials`,或 `HASNA_DOMAINS_API_KEY`,与舰队网关 `https://api.hasna.com/domains` 作为默认权限),当没有证书解析时数据命令会关闭:本地 SQLite 路径设置被拒绝; `domains-serve` 直接连接到云端邮报.

## 特征

-   **域组合管理** 轨迹登记员、期满、SSL、名服务员、定价、生命周期状况和笔记
-   **书记官长同步和采购流程** ——通过共享供应商登记处,直通53路和名牌注册加GoDaddy和Brandsight供应商表面
-   **命名服务员代表团** ——在提供者API支持时,53路和"Namecheap"适配器可以更新注册员名服务器
-   **DNS 供应商管理** 建立或再利用Cloudflare或Loute 53区,并通过DNS提供者层管理DNS记录
-   **DNS 记录 CRUD** - A、AAAA、CNAME、MX、TXT、NS、SRV记录
-   **DNS 理想状态** ——JSON计划/diff/应用提供者DNS记录,明确删除选入和应用后核查
-   **塞多市场工具** - 可选搜索、组合/名单管理、黑名单核对和记录的塞多采购
-   **AWS 诊断** ——同步路由 53 已注册域和托管区域,不打印秘密值
-   **可信性诊断** - 编辑了53号公路、Cloudflare、Nanocheap、Go Daddy、Brandsight和Sedo的支票
-   **过期提醒** ——设置域名过期和SSL证书过期的提醒
-   **WHOIS 检索** - 查询和储存登记员/来自卫生组织信息系统的信息
-   **SSL 证书检查** ——核查SSL发行人并到期
-   **DNS 传播检查** —查询 Google, Cloudflare, Quad9, OpenDNS
-   **区文件导出/导入** — BIND 格式区文件
-   **子域发现** - 通过curt.sh证书透明度日志
-   **DNS 验证** - 发现CNAME冲突、MX缺失以及更多
-   **组合导出** —— CSV 或 JSON 有全部域数据
-   **品牌监测** - 通过Brandsight API进行可选的打字/威胁检测
-   **MCP 服务器** - 示范背景协议对AI代理的支持
-   **MCP 安全模式** ——仅用: `DOMAINS_MCP_SAFE_MODE=1`
-   **HTTP API + SDK** - 认证 `/v1` API通过 `domains-serve` 键入 `@hasna/domains/sdk` 客户端
-   **互动 TUI** — 终端中的可选组合浏览器 `domains interactive`

## 安装

```bash
npm install -g @hasna/domains
```

所有普通客户使用共享账户API. 保存的证书在 macOS 密钥链或 `~/.hasna/domains/config/credentials`· ; `HASNA_HOME` 财务报告和审定财务报表 `HASNA_CONFIG_HOME` 可选择证书根。 现有的SQLite文件被保存以进行可核实的迁移,从未被CLI,MCP或SDK工厂打开.

## 可选命令组

默认的 CLI 保留了核心组合,登记器, DNS, 提供者, Route 53, 医生, MCP, 和服务器命令加载. 允许选择小组每次引用:

```bash
domains extras
DOMAINS_COMMAND_GROUPS=marketplace,owner domains --help
DOMAINS_ENABLE_EXTRAS=1 domains --help
```

可用组 : `brandsight`, (中文(简体) ), `events`, (中文(简体) ), `history`, (中文(简体) ), `interactive`, (中文(简体) ), `marketplace`, (中文(简体) ), `outreach`, (中文(简体) ), `owner`, (中文(简体) ), `provision`, (中文(简体) ), `research`, (中文(简体) ), `wallet`。 。 。 .

## 快速启动

```bash
# Set defaults used by availability, buy, setup, DNS, and doctor commands
domains config set default-registrar route53
domains config set default-dns cloudflare
domains config set purchase-aws-profile production-domains

# Add registrant contact defaults used by registrar purchase APIs
domains config set contact.first_name Jane
domains config set contact.last_name Example
domains config set contact.email jane@example.com
domains config set contact.phone +1.5555555555
domains config set contact.address_line_1 "1 Main St"
domains config set contact.city "New York"
domains config set contact.state NY
domains config set contact.country_code US
domains config set contact.zip_code 10001

# Check local health without printing secrets
domains doctor
```

## 供应商矩阵

| 提供者 | 类型 | 可用性 | 购买/注册 | 更新 | 命名员/DNS | 页:1 |
| --- | --- | --- | --- | --- | --- | --- |
| `route53` | 登记员+DNS | 对 | 对 | 没有 | 命名服务器+53路托管区 | 初自供养注册道. 使用 `AWS_PROFILE` 或 AWS 键. |
| `namecheap` | 登记员+DNS | 对 | 对 | 对 | 命名服务器 + 命名 DNS 记录 | 需要Namecheap API访问和白名单客户端IP. |
| `godaddy` | 登记员+DNS | 有门 | 没有直接购买CLI | 有门 | API 访问时的 DNS 记录 | 可用性仍为阈值;DNS/域管理可用于合格账户. |
| `brandsight` | 登记员+DNS | 对 | 合同规定 | 在合同允许时是 | 命名服务器 + DNS 记录 | Go Daddy Corporal Domains / Brandsight v2 API; 仅限企业合同. |
| `cloudflare` | DNS + 库存 | 没有 | 没有 | 没有 | DNS区和记录 | 首选 DNS 提供者; 区目录同步域, 但不能证明注册员的所有权 . |
| `sedo` | 市场 | 市场搜索/状况 | 仅记录购买 | 没有 | 没有 | 塞多是市场/名单/组合,而不是CLI中的登记员DNS. |

## CLI 使用量

```bash
# Portfolio management
domains domain add --name example.com --registrar Namecheap --expires-at 2027-01-01
domains domain list
domains domain list --status active --registrar Namecheap
domains domain get example.com
domains domain update <id> --notes "renewed"
domains domain delete <id>
domains domain search example
domains domain stats

# Expiry monitoring
domains domain expiring --days 30
domains ssl expiring --days 30

# WHOIS / SSL checks
domains domain whois example.com
domains ssl check example.com
domains domain check example.com example.net

# Portfolio export
domains domain export --format csv > portfolio.csv
domains domain export --format json

# Provider registry and diagnostics
domains providers
domains provider list
domains provider test route53
domains provider test cloudflare
domains doctor

# Registrar sync
domains sync --provider route53
domains sync --provider cloudflare
domains sync --provider namecheap
domains sync --provider godaddy
domains sync --provider brandsight
domains sync --all

# Availability and renewals
domains check example.com
domains check --provider route53 example.com
domains check --provider namecheap example.com
domains renew example.com --provider namecheap --years 1

# Purchases and setup
domains domain buy example.com --provider route53 --wait
domains domain buy example.com --provider namecheap --wait
domains domain buy premium.example --registrar sedo --price 2500 --expires 2027-01-01
domains domain setup example.com --registrar route53 --dns cloudflare --wait

# DNS record management
domains dns list <domain-id>
domains dns add --domain <id> --type A --name @ --value 1.2.3.4
domains dns update <record-id> --value 5.6.7.8
domains dns remove <record-id>
domains dns check-propagation example.com --record A
domains dns export <domain-id>
domains dns import <domain-id> --file zone.txt
domains dns discover-subdomains example.com
domains dns validate <domain-id>
domains dns pull example.com --provider cloudflare
domains dns push <domain-id> --provider cloudflare

# Create one new live DNS-only CNAME, without changing existing records
domains dns create example.com --provider cloudflare --zone-id <exact-zone-id> \
  --type CNAME --name new.example.com --value target.example.net \
  --ttl 300 --proxied false --yes --json

# Change one existing live record in place, by record ID (no delete, no recreate)
domains dns set example.com --provider cloudflare --zone-id <exact-zone-id> \
  --record-id <exact-record-id> --content new-target.example.net \
  --ttl 60 --proxied false --yes --json

# Read or change one allowlisted provider zone setting (Cloudflare)
domains zone setting get <exact-zone-id> --provider cloudflare --setting email_obfuscation
domains zone setting set <exact-zone-id> --provider cloudflare --setting email_obfuscation --value off --yes

# Desired DNS state against a provider zone
domains dns plan example.com --provider cloudflare --file dns.example.json
domains dns diff example.com --provider cloudflare --file dns.example.json
domains dns apply example.com --provider cloudflare --file dns.example.json --yes
# Delete plans require --allow-delete and may still be refused before writes
# when the provider path cannot guarantee safe convergence.

# Optional Sedo marketplace
DOMAINS_COMMAND_GROUPS=marketplace domains sedo search example
DOMAINS_COMMAND_GROUPS=marketplace domains sedo status example.com
DOMAINS_COMMAND_GROUPS=marketplace domains sedo portfolio --limit 25
DOMAINS_COMMAND_GROUPS=marketplace domains sedo add example.com --price 2500
DOMAINS_COMMAND_GROUPS=marketplace domains sedo edit example.com --price 3000
DOMAINS_COMMAND_GROUPS=marketplace domains sedo remove example.com
DOMAINS_COMMAND_GROUPS=marketplace domains sedo buy example.com --price 2500 --order-id SEDO-ORDER-ID

# Optional brand monitoring
DOMAINS_COMMAND_GROUPS=brandsight domains monitor watch mybrand
DOMAINS_COMMAND_GROUPS=brandsight domains monitor similar example.com
DOMAINS_COMMAND_GROUPS=brandsight domains monitor threats example.com

# Optional interactive portfolio browser
DOMAINS_COMMAND_GROUPS=interactive domains interactive
DOMAINS_COMMAND_GROUPS=interactive domains interactive --status active
```

`dns add/update/remove` 更改主机组合. `dns create` 改为联系人 Cloudflare 通过其配置的提供者证书并创建一个精确的 之前只缺DNS 的 CNAME 。 区名和区名必须匹配 活动提供者区域。 名称和目标必须加以充分限定 支持证书认证名称。 任何类型的现有记录, 包括一个相同的国家妇女委员会,在不发生变异的情况下被拒绝.

创建命令执行一个 POST 并检查返回的记录 ID 准确的ID和准确的名字提供者都读取。 它从不更新,删除,卷 返回,或自动重复写作。 如果连接失败或重新读取会 不匹配,请在决定是否再次尝试之前检查当前提供者状态. 提供商CNAME碰撞处理可保护竞争地址/CNAME的创建; 此操作不是对现有记录的一般比较和扫描 API .

`dns set` 更改一个已有的现场记录, 以其记录 ID: 针入 区域,先读记录 准确的图像前,然后发布一个 PATCH 的字段,并验证复数。 记录 ID、 类型和名称 被保留——没有被删除或再创建,也没有尝试重试. `--expect-content` 在任何写入之前拒绝更改, 除非记录还保留 载有审查的内容。 它拒绝没有 `--yes`,在任何回读时 不匹配, 当记录身份不匹配时, 以及在任何非 id 上 准确的Cloudflare区或记录编号.

`zone setting get` 读取一个允许的列表提供者区域设置 `zone setting set` 使用一个 PATCH 和一个匹配的回读来修改这个设置 。 这个 允许列表已关闭( l)`email_obfuscation`,数值 `on`编号 :`off`, 今天): 不详 设置、 未知的值、 没有设置支持的提供者以及回读 不匹配请求的值被拒绝,没有其它区域设置 触动.

## 为代理人压缩输出

列表,搜索,状态,历史,发现,和组合指令默认为紧凑. 人类输出显示必要的字段,将第一页封为20行,除非一个命令已经有更小的明确限制,将长音符/记录值切换出,并打印下一细节路径的提示.

需要时使用这些旗帜来披露更多信息:

```bash
domains domain list --limit 50 --offset 50
domains domain list --all
domains domain list --verbose
domains domain get example.com
domains domain list --json
```

`--verbose` 添加人可读的细节栏,如注册员,笔记,所有者联系字段,或提供者元数据等. `get`, (中文(简体) ), `info`,而其他细节命令一次显示一个记录. `--json` 保留机器可读细节路径,并保存现有自动化的全部记录,除非一个命令已经记录了明确的API/提供者限制.

MCP列表式工具遵循相同的渐进披露模式. 默认返回压缩 JSON 与 `count`, (中文(简体) ), `total`, (中文(简体) ), `limit`, (中文(简体) ), `offset`, (中文(简体) ), `has_more`, (中文(简体) ), `next_offset`, (中文(简体) ), `compact`,以及 `hint`。通过 `limit`编号 :`offset` 为呼唤, `all: true` 用于所有返回的匹配,或 `verbose: true` 完整记录:

```json
{ "name": "list_domains", "arguments": { "limit": 50, "offset": 50 } }
{ "name": "list_domains", "arguments": { "verbose": true, "limit": 5 } }
{ "name": "get_domain", "arguments": { "id": "example.com" } }
```

MCP 提供者同步工具默认返回计数/ 错误摘要; 通过 `verbose: true` 仅当一个代理需要特定供应商的数组或全同步诊断时.

喜欢 `domains` 53号公路的CLI比原始登记员的CLI要多,登记状况、地方投资组合更新和DNS代表团。 CLI应用了已配置的默认,在本地组合 DB 中记录结果,并保持提供方的行为一致.

理想的DNS状态文件是JSON:

```json
{
  "domain": "example.com",
  "records": [
    { "type": "A", "name": "@", "value": "192.0.2.10", "ttl": 300 },
    { "type": "MX", "name": "@", "value": "mail.example.com", "ttl": 300, "priority": 10 },
    { "type": "TXT", "name": "@", "value": "v=spf1 -all", "ttl": 300 }
  ]
}
```

`dns apply` 拒绝运行没有 `--yes`。如果计划包括删除,则还需要 `--allow-delete`,然后在写入之前拒绝,除非提供者路径能够保证不发生部分突变而删除趋同. 非删除程序在写入后应用重读提供者记录,如果活区仍然与所希望的文件不同,则失败.

## AWS 域发现

```bash
# Sync registered domains and hosted zones from specific AWS profiles
AWS_PROFILE=production-domains domains sync --provider route53
AWS_PROFILE=shared-dns domains sync --provider route53

# Check all configured providers and redacted credential status
domains providers --json
domains doctor --json
```

当选定的 AWS 账户允许时, 路线 53 同步导入已注册域 `route53domains:ListDomains`,并且当账户允许53号公路主机区读取时,托管区。 不相关的系统如SSM参数或保密管理器的域名,只有在审查后才能被导入,因为这些域名不能证明登记员的所有权.

## 存储

每个客户端表面—— CLI, MCP 服务器和 `./sdk` - 通过共同的认证和权威解决其信誉和权威 `@hasna/contracts` 解析器,每一次通话都新鲜:

1.  明确 `--api-key` 编号 : `--profile` 参数(代码级别)
2.  刻意的洞穴指针.. `HASNA_DOMAINS_API_KEY_OVERRIDE`, (中文(简体) ), `HASNA_PROFILE`, (中文(简体) ), `HASNA_DOMAINS_API_KEY_REF`
3.  macOS 键链——项目 `hasna.credentials.domains.api-key` 编号 : `.api-url`账户 `HASNA_STATION`,否则就是简短的主机名,否则 `$USER`
4.  磁盘,在呼叫时间读取—— `~/.hasna/domains/config/credentials` (仅所有者0600; `HASNA_HOME` 编号 : `HASNA_CONFIG_HOME` 覆盖根)
5.  `HASNA_DOMAINS_API_KEY` 在进程内——一个合法的层次

当局遵循同样的阶梯—— `HASNA_DOMAINS_API_URL`键链 `api-url` 证书文件 **默认为舰队网关 `https://api.hasna.com/domains`** 一旦一个证书决定了,那么单一个密钥就是一个完整的配置. 无前缀 `DOMAINS_API_URL` 编号 : `DOMAINS_API_KEY` 异名被解析器接受 `HASNA_DOMAINS_*` 名字总是赢。 退休地点`~/.hasna/fleet-env`云层下方 `~/.hasna`, (中文(简体) ), `~/.config/hasna`, (中文(简体) ), `$XDG_CONFIG_HOME`)从未读过,没有 `*_MODE` 编号 : `*_STORAGE_MODE` 变量选择任何东西.

**关闭失败.** 一个没有证书出口的东道主运行非零命名峡谷的双人——从不默默地倒向SQLite,从不 `*-local-fallback` 活动。 一个数据库DSN从不暴露于客户端.

**SQLite 客户端选择退出.** 未设置 `HASNA_DOMAINS_DB_PATH`, (中文(简体) ), `DOMAINS_DB_PATH`, (中文(简体) ), `HASNA_DOMAINS_DIR` 财务报告和审定财务报表 `DOMAINS_DIR` 在使用正常客户端之前。 即使没有配置 API 密钥,这些设置也会被拒绝 。 保存现有数据库,直到所有记录在共享账户中调节和核实为止;删除路径设置不会迁移数据.

`domains serve` 财务报告和审定财务报表 `domains-serve` 启动同一认证的 PostgreSQL 服务 。 两者都需要服务器数据库 DSN(`HASNA_DOMAINS_DATABASE_URL`)和签名密钥(`HASNA_DOMAINS_API_SIGNING_KEY`;客户端 API 密钥不能授权一个收听器. 数据路线的使用 `/v1` 并验证每个呼叫者的密钥和撤销状态。 首先应用所有者角色迁移 `domains db migrate`。 。 。 .

## MCP 服务器

```bash
domains-mcp
```

MCP 列表/ 搜索工具默认为密钥上下文安全; 使用 `limit`, (中文(简体) ), `offset`, (中文(简体) ), `all`,以及 `verbose` 参数,或单记录的详细工具,例如 `get_domain`当需要更多细节时.

在您的克劳德/代理配置中添加:

```json
{
  "mcpServers": {
    "domains": {
      "command": "domains-mcp",
      "args": ["--stdio"]
    }
  }
}
```

## MCP 运输

可流取的 HTTP 是共享代理会话的默认传输并绑定到 `127.0.0.1`数字 :

```bash
domains-mcp                     # default port 8859
domains-mcp --port 9000
MCP_HTTP_PORT=9000 domains-mcp
```

-   `GET /health` 返回时 `{"status":"ok","name":"domains"}`
-   `POST /mcp` 是可流的 HTTP MCP 端点

对每次启动一个 MCP 儿童进程客户端使用 stdio :

```bash
domains-mcp --stdio
```

仅读代理会话 :

```bash
DOMAINS_MCP_SAFE_MODE=1 domains-mcp
DOMAINS_MCP_SAFE_MODE=1 domains-mcp --http
```

安全模式只登记只读/单/检查/出口工具。 域名创建,DNS写作,提供者同步等变相工具以及"路由53"的注册被扣.

## HTTP API 密码 还有SDK

`domains-serve` 暴露公共卫生、准备状态、版本和OpenAPI端点加上API键认证 `/v1` 路线。 组合读取要求 `domains:read`; 普通写法需要 `domains:write`登记员的购买和供应需要单独的 `domains:purchase` 范围。 发送密钥通过 `x-api-key`。 。 。 .

托管的API是可用性、注册、Cloudflare区创建、登记员命名服务员授权、边界DNS对账和目标准备状态的生产当局。 具体目标是一般性的:现有 `shortlinks` 工人装订 `website_origin` 接受已验证的 AWS ALB 主机名的配置文件 。 创建网站的工作默认为 `origin_tls_mode: "strict"`; 较弱者 `"full"` 模式必须在每份购买或收养申请中明确,并成为持久的一能身份的一部分。 服务只设置 Cloudflare 区域 SSL 设置, 在创建网络记录前读取准确值, 并拒绝削弱已有的 `strict` 或更强 `origin_pull` 区域。 未知的 SSL 值在突变前失败 。 自动 SSL/ TLS 是单独的 Cloudflare 设置, 不更改 。 全模式加密 Cloudflare 与原生连接,但不认证原生证书 .

-   `POST /v1/availability` 53号公路有登记和更新价格.
-   `POST /v1/provisioning` ——一意孤行地储备并排出一个被封顶的购买对象.
-   `POST /v1/provisioning/adopt` ——采用已经拥有的组合域而不再购买.
-   `GET /v1/provisioning/:id` 财务报告和审定财务报表 `GET /v1/provisioning/by-name/:name` ——按工作或犬目域读取耐用状态机器.
-   `POST /v1/provisioning/by-name/:name/dns-reconcile` ——一能调节1~20个精确的TXT,CNAME,或提供商回读后MX记录.
-   `POST /v1/provisioning/:id/advance` ——有界限的操作员恢复;服务器工人通常自动推进工作.

每次采购都需要明确的总费用上限(`max_price_usd`, (中文(简体) ), `auto_renew`和一能键。 服务在登记员提交之前重新检查了可用性和多年总价格。 登记材料内容模糊 `manual_review` 并且不再自动复试,防止重复采购。 采用时需要登记员所有权回溯,加上现有的组合行;目标改变冲突,而不是默不作声地重新指定一个域。 53路和Brandsight投资组合的登记都保留登记员的出处。 在更改名称服务器之前,工人预先将请求的来源TLS模式,复制支持注册员的DNS组(A, AAA, CAA, CNAME, MX, 委托的NS,和TXT)输入Cloudflare,准确读取,并记录一个稳定的检查站. 不支持或丢失的 DNS 形状输入 `manual_review`; MX, TXT, CAA, 和无关的组从不被丢弃, 以让网络路由通过. 登记员还核对一个应用但及时的用户名服务器更新而不重复。 已准备好的任务返回一个中性提供者 `result` 带有不透明的区域引用,命名服务器,网络记录,以及目标检查时间.

在注册前,耐用工作记录了与53号公共公路主机区ID的精确匹配的一套. 清理工作只能针对一个新出现区域,只有当其目前的记录组是顶级NS/SOA配对时,其代表团就与这些NS记录相匹配,登记员在别处授权,Cloudflare是权威的. 清理从不删除记录集;同时添加的记录使得"53路"安全拒绝最终区删除.

托管的运行时间要求 :

-   AWS任务-作用权限53路域注册/状态/委托和安全主机区清理.
-   查询每个账户以供收养(包括假定的登记员角色) `route53domains:ListDomains` 财务报告和审定财务报表 `route53domains:GetDomainDetail`缺漏是指没有该域的已填充的存货;授权、运输和详细读取错误总是停止发现。 这也保留了域-细节浓缩已经需要的库存许可.
-   可选服务器 `DOMAINS_ROUTE53_REGISTRAR_ACCOUNTS_JSON` 最多16个账户引用登记员角色ARN。 新的收养在提供者突变之前就一直维持其选定的账户和角色指纹。 客户端不能选择一个账户或插入一个角色.
-   `DOMAINS_REGISTRANT_SOURCE_DOMAIN` 命名一个已有的Route 53域名,其注册人联系方式可以在进程中被再利用;从API客户端中从未接受或返回联系数据.
-   `CLOUDFLARE_ACCOUNT_ID` 加号 `CLOUDFLARE_API_TOKEN`DNS写道:"云花" `Zone Settings Write` 对明确的SSL-mode回读合同和所配置的目标绑定的允许。 主机提供故意拒绝 Cloudflare 全球 API 密钥/电子邮件认证 .
-   `BRANDSIGHT_API_KEY`, (中文(简体) ), `BRANDSIGHT_API_SECRET`,以及 `BRANDSIGHT_CUSTOMER_ID` 当采用现有的 Brandsight / Godaddy 公司域名投资组合注册时。 在保留主机工作或创建Cloudflare区之前,缺少证书的新收养申请失败.
-   可选 `DOMAINS_PROVIDER_HTTP_TIMEOUT_MS` (默认) `30000`最大值 `120000`) Brounds Cloudflare和Brandsight域名API请求. `DOMAINS_PROVIDER_MAX_RESPONSE_BYTES` (默认) `1048576`最大值 `4194304`) Brounds Cloudflare 响应; Brandsight Domain API 响应有一个固定的 1 MiB 约束.
-   可选 `DOMAINS_PROVISIONING_INTERVAL_MS` (默认) `5000`耐用背景工人.
-   可选 `DOMAINS_PROVISIONING_MAX_ATTEMPTS` (默认) `17280`将连续的民意测验限制在一个州内;成功的州过渡重新设置计数器,因此正常的登记员/DNS/证书等候不会消耗整个工作预算.

消费者必须称之为API(通常通过 `@hasna/domains/sdk`而不是自己持有登记员或Cloudflare购买证书.

受保护的部署道在一张候选图像摘要和登记员地图上采用两个阶段。 首先它装入了装订意识代码 保留了所有现有的条目 `DOMAINS_ROUTE53_ADOPTION_PAUSED=true`:新的"路由53"收养无法发现或持续约束,现有的约束性工作可以恢复,遗留的无约束性工作仍由默认账户承担. 然后,它需要一次完全集中的服务,以及两次完整而稳定的任务普查,包括可能仍在运行或停止的预期中的任务,然后才不暂停通过。 两个阶段都知道相同的地图,因此排水的第一阶段工人可以安全地处理第二阶段所录取的工作。 需要部署角色 `ecs:ListTasks` 财务报告和审定财务报表 `ecs:DescribeTasks` 服务的全部任务普查。 现有的已绘制图的部署需要车道的消化带相容性标签. 未知出处, 映射去除或重定向, 待定任务, 更改服务状态, 不完整 pagination 失败关闭 。 道从不去除角色, 或重启旧运行时间作为恢复 。 一旦测绘服务突变可能已经开始,即使工作和租赁计数为零,也禁止向后回滚,包括人工回滚。 将不确定结果核对为只读,并准备单独审查的有约束力前期修复。 部署工作仍须服从正常释放和拥有权.

```bash
domains-serve --host 0.0.0.0 --port 8080
curl http://127.0.0.1:8080/health
curl -H "x-api-key: $HASNA_DOMAINS_API_KEY" http://127.0.0.1:8080/v1/domains
```

软件包还输出生成的客户端, 连接到同一共享 解析器 CLI 和 MCP 服务器使用 – 每个请求都新鲜, 所以按键旋转 治愈长寿客户端 :

```ts
import { createDomainsClientFromEnv } from "@hasna/domains/sdk";

const domains = createDomainsClientFromEnv();
const portfolio = await domains.listDomains({ status: "active" });
```

明确 `baseUrl` 没有 `apiKey` 建立一个受此委托的客户端 永远无法取回环境船队钥匙 SDK抛出——它从不降解为匿名客户端或本地数据.

`domains serve` 是认证服务器运行时间的别名, 保存其 CLI 主机/ 端口默认值 。 它的账户数据路径是: `/v1/*`; 前者未经认证 `/domains` 代理已删除 .

## 环境变量

| 变量 | 说明 |
| --- | --- |
| `HASNA_DOMAINS_API_KEY` | 所主控的 API 密钥( 共享解析器的目录化层; 密钥链和证书文件下方) |
| `HASNA_DOMAINS_API_URL` | 可选托管的 API 基础 URL — 默认为车队网关 `https://api.hasna.com/domains` 一旦一个密钥解决 |
| `HASNA_DOMAINS_API_KEY_OVERRIDE` | 精心设计的每跑密钥比其他级别都高 |
| `HASNA_DOMAINS_API_KEY_REF` | 刻意通过 `@hasna/secrets` 请求时间 SDK |
| `HASNA_PROFILE` | 全球身份简介指针( I)`credentials-<profile>` 证书文件旁边) |
| `HASNA_HOME` | 证书/ 配置根共享 root 覆盖; 一般客户端不打开本地数据 |
| `HASNA_CONFIG_HOME` | 解析器证书文件的配置根重覆 |
| `HASNA_DOMAINS_DB_PATH` | 退休客户端设置;在删除前迁移并核实现有数据 |
| `DOMAINS_DB_PATH` | 已退休的遗留客户端设置; 被拒绝 |
| `HASNA_DOMAINS_DIR` | 退休客户端设置; 被拒绝 |
| `DOMAINS_DIR` | 已退休的遗留客户端设置; 被拒绝 |
| `HASNA_DOMAINS_HOME`, (中文(简体) ), `DOMAINS_HOME` | 退休客户端选择器; 被主机客户端表面拒绝 |
| `HASNA_DOMAINS_CONFIG_PATH`, (中文(简体) ), `DOMAINS_CONFIG_PATH` | 覆盖设置配置文件路径 |
| `DOMAINS_CONFIG_DIR` | 覆盖设置配置目录 |
| `DOMAINS_COMMAND_GROUPS` | 以逗号分隔的可选命令组来装入,或 `all` |
| `DOMAINS_ENABLE_EXTRAS` | 设定为 `1` 以装入所有可选命令组 |
| `DOMAINS_MCP_SAFE_MODE` | 设定为 `1` 只显示只读的 MCP 工具 |
| `HASNA_DOMAINS_DATABASE_URL` | 服务器侧 PostgreSQL DSN 使用 `domains-serve` 和 DB 迁移; 服务器存储需要 |
| `HASNA_DOMAINS_API_SIGNING_KEY` | HMAC 签名秘密 `domains-serve` 以验证 API 密钥 |
| `AWS_PROFILE` | 53号公路域和托管区的 AWS 简介 |
| `AWS_ACCESS_KEY_ID`, (中文(简体) ), `AWS_SECRET_ACCESS_KEY`, (中文(简体) ), `AWS_SESSION_TOKEN` | AWS 证书倒置 |
| `DOMAINS_PURCHASE_AWS_PROFILE` | 当配置不存在时, 购买配置回落 `purchase_aws_profile` |
| `CLOUDFLARE_API_TOKEN` | Cloudflare API 符号 |
| `CLOUDFLARE_API_KEY`, (中文(简体) ), `CLOUDFLARE_EMAIL` | Cloudflare 全球密钥回落 |
| `CLOUDFLARE_ACCOUNT_ID` | 创建区域的 Cloudflare 账户 ID |
| `DOMAINS_PROVIDER_HTTP_TIMEOUT_MS` | Cloudflare和Brandsight域名API请求在毫秒内超时, `1`– 说吧 –`120000` (默认) `30000`(中文(简体) ) |
| `DOMAINS_PROVIDER_MAX_RESPONSE_BYTES` | 以字节表示的 Cloudflare 响应大小限制, `1`– 说吧 –`4194304` (默认) `1048576`(中文(简体) ) |
| `NAMECHEAP_API_KEY` | 命名 API 密钥 |
| `NAMECHEAP_USERNAME` | Namecheap 账户用户名 |
| `NAMECHEAP_CLIENT_IP` | 名称为 白色 IP |
| `NAMECHEAP_SANDBOX` | 使用名牌沙盒 API |
| `GODADDY_API_KEY`, (中文(简体) ), `GODADDY_API_SECRET` | Go Daddy API 证书 |
| `BRANDSIGHT_API_KEY`, (中文(简体) ), `BRANDSIGHT_API_SECRET`, (中文(简体) ), `BRANDSIGHT_CUSTOMER_ID` | Brandsight/Go Daddy公司域名证书 |
| `BRANDSIGHT_DEMO_STUBS`, (中文(简体) ), `BRANDSIGHT_ALLOW_STUBS` | 设定为 `1` 当 Brandsight API 无法访问时, 允许演示站点响应 |
| `SEDO_PARTNER_ID`, (中文(简体) ), `SEDO_API_KEY`, (中文(简体) ), `SEDO_USERNAME`, (中文(简体) ), `SEDO_PASSWORD` | 塞多市场API证书 |

### 主机存储为权威

CLI,MCP服务器和SDK工厂是托管客户端. 他们解决所有者唯一的证书 从共享解析器 并发送请求 `https://api.hasna.com/domains/v1`。 。 。 . `HASNA_DOMAINS_DB_PATH`, (中文(简体) ), `DOMAINS_DB_PATH`, (中文(简体) ), `HASNA_DOMAINS_DIR`, (中文(简体) ), `DOMAINS_DIR` 财务报告和审定财务报表 `HASNA_DOMAINS_HOME` 是已退休的客户选择者,但被拒绝;他们从不选择SQLite或创建本地组合.

如果寄存器证书或权威无法解决,数据命令会关闭并报告配置错误. `domains doctor` 报告已解决的托管机构和证书来源,而不披露证书. `domains-serve` 财务报告和审定财务报表 `domains db migrate` 是运算符表面,需要通过 PostgreSQL `HASNA_DOMAINS_DATABASE_URL` (或记录的所有者-作用迁移变量).

## 许可证

阿帕奇 - 2.0

## 保存邮件 DNS

对于SES风格的授权,使用SDK的 `reconcileProvisionedDomainEmailDns` (单位:千美元)`POST /v1/provisioning/by-name/{name}/dns-reconcile/mail`拥有一个稳定 一能之钥. 域名必须具备随时提供的工作 。 这个 路由保存现有的 DMARC 内容和 TTL, 保存无关的 TXT 记录, 并保留现有的SPF授权和终端政策 包含。 DKIM或来自记录的邮件冲突需要审查,而不是 替换. `records` 约束所请求的意图; `result.records` 包含 返回后的有效提供者值,包括保存的自动 TTL.

一般情况 `/dns-reconcile` 路由仍然替换明确命名的记录组. 两个路由都不是客户端比较-和-wap API. 两条路线共用一个提供者区 PostgreSQL 的咨询锁, 连接到读、 合并、 写、, 复读和收讫. 一个繁忙的区域返回可重试的 HTTP 503. 尝试收款 继续自动承诺连接;不确定的锁定获取或释放 丢弃连接。 试图租借也写了护栏邮件。 这些控制 不锁定外部 DNS 管理员。 邮件写出已观察到的 SPF 漂移, 永远不要删除已有的记录组, 并拒绝模糊的 SPF 或 DMARC 政策设定为回放。 模糊的提供者结果需要重回 任何有意的恢复.

## 常见问题

### @hasna/domains 是什么？

域名组合、登记员、市场和人工智能代理的DNS管理——CLI \+ MCP \+ HTTP API \+ SDK、共享账户API和PostgreSQL

### 如何安装 @hasna/domains？

在项目目录运行 npm install @hasna/domains，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 domains、domains-mcp、domains-serve，可以用 npx domains 直接运行。

### @hasna/domains 支持 TypeScript 吗？

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

### @hasna/domains 支持 ESM 还是 CommonJS？

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

### @hasna/domains 可以商用吗？

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

### @hasna/domains 的下载量有多少？

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

### @hasna/domains 还在维护吗？

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

