@ 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 - 认证
/v1API通过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; 仅限企业合同. |
cloudflare | DNS + 库存 | 没有 | 没有 | 没有 | 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 解析器,每一次通话都新鲜:
- 明确
--api-key编号 :--profile参数(代码级别) - 刻意的洞穴指针..
HASNA_DOMAINS_API_KEY_OVERRIDE, (中文(简体) ),HASNA_PROFILE, (中文(简体) ),HASNA_DOMAINS_API_KEY_REF - macOS 键链——项目
hasna.credentials.domains.api-key编号 :.api-url账户HASNA_STATION,否则就是简短的主机名,否则$USER - 磁盘,在呼叫时间读取——
~/.hasna/domains/config/credentials(仅所有者0600;HASNA_HOME编号 :HASNA_CONFIG_HOME覆盖根) 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/availability53号公路有登记和更新价格.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_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
政策设定为回放。 模糊的提供者结果需要重回
任何有意的恢复.