@hasna/domains

中文文档
0.3.3发布于 2026/10/16Apache-2.0TypeScriptES Module近 30 天下载 4.8万

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

中文使用文档
文档目录16 节
  1. 特征
  2. 安装
  3. 可选命令组
  4. 快速启动
  5. 供应商矩阵
  6. CLI 使用量
  7. 为代理人压缩输出
  8. AWS 域发现
  9. 存储
  10. MCP 服务器
  11. MCP 运输
  12. HTTP API 密码 还有SDK
  13. 环境变量
  14. 主机存储为权威
  15. 许可证
  16. 保存邮件 DNS

@ 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

安装

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, 和服务器命令加载. 允许选择小组每次引用:

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。 。 。 .

快速启动

# 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 [email protected]
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; 仅限企业合同.
cloudflareDNS + 库存没有没有没有DNS区和记录首选 DNS 提供者; 区目录同步域, 但不能证明注册员的所有权 .
sedo市场市场搜索/状况仅记录购买没有没有塞多是市场/名单/组合,而不是CLI中的登记员DNS.

CLI 使用量

# 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行,除非一个命令已经有更小的明确限制,将长音符/记录值切换出,并打印下一细节路径的提示.

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

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 完整记录:

{ "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:

{
  "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 域发现

# 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 服务器

domains-mcp

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

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

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

MCP 运输

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

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 :

domains-mcp --stdio

仅读代理会话 :

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_TOKENDNS写道:"云花" 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 失败关闭 。 道从不去除角色, 或重启旧运行时间作为恢复 。 一旦测绘服务突变可能已经开始,即使工作和租赁计数为零,也禁止向后回滚,包括人工回滚。 将不确定结果核对为只读,并准备单独审查的有约束力前期修复。 部署工作仍须服从正常释放和拥有权.

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 服务器使用 – 每个请求都新鲜, 所以按键旋转 治愈长寿客户端 :

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_KEYHMAC 签名秘密 domains-serve 以验证 API 密钥
AWS_PROFILE53号公路域和托管区的 AWS 简介
AWS_ACCESS_KEY_ID, (中文(简体) ), AWS_SECRET_ACCESS_KEY, (中文(简体) ), AWS_SESSION_TOKENAWS 证书倒置
DOMAINS_PURCHASE_AWS_PROFILE当配置不存在时, 购买配置回落 purchase_aws_profile
CLOUDFLARE_API_TOKENCloudflare API 符号
CLOUDFLARE_API_KEY, (中文(简体) ), CLOUDFLARE_EMAILCloudflare 全球密钥回落
CLOUDFLARE_ACCOUNT_ID创建区域的 Cloudflare 账户 ID
DOMAINS_PROVIDER_HTTP_TIMEOUT_MSCloudflare和Brandsight域名API请求在毫秒内超时, 1– 说吧 –120000 (默认) 30000(中文(简体) )
DOMAINS_PROVIDER_MAX_RESPONSE_BYTES以字节表示的 Cloudflare 响应大小限制, 1– 说吧 –4194304 (默认) 1048576(中文(简体) )
NAMECHEAP_API_KEY命名 API 密钥
NAMECHEAP_USERNAMENamecheap 账户用户名
NAMECHEAP_CLIENT_IP名称为 白色 IP
NAMECHEAP_SANDBOX使用名牌沙盒 API
GODADDY_API_KEY, (中文(简体) ), GODADDY_API_SECRETGo Daddy API 证书
BRANDSIGHT_API_KEY, (中文(简体) ), BRANDSIGHT_API_SECRET, (中文(简体) ), BRANDSIGHT_CUSTOMER_IDBrandsight/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 共发布 50 个版本,首次发布于 2026/03/26;过去 12 个月发布了 50 个版本。

版本发布日期距今
0.3.3latest2026/10/161 个月前
0.3.22026/10/151 个月前
0.3.12026/09/211 个月前
0.3.02026/09/201 个月前
0.2.02026/09/191 个月前
0.1.02026/09/072 个月前

关于 @hasna/domains 的常见问题

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