快速导航
一、集成方式选择（关键决策）
将现有DNS域名（如 .com、.org、.net）集成到ENS系统，共有两种标准方法。请根据以下核心差异选择：
| 对比维度 | 链下集成（ ） | 链上集成（ ） |
|---|---|---|
| 区块链资产 | 无链上Token，域名留在DNS | 创建ERC-721 NFT，域名上链 |
| 管理界面 | 在现有DNS提供商处管理 | 通过ENS App（app.ens.）管理 |
| 交易费用 | 0 Gas费（解析时按需验证） | 需要一次Gas交易（仅网络费，ENS无协议费） |
| 适用场景 | 追求低门槛、快速集成 | 需要链上所有权证明、交易流转 |
| 技术前提 | 域名必须开启 | 域名必须开启 |
> 官方建议：如果是企业仅需为官网增加Web3支付/身份功能，优先选择链下集成；如果需要将域名作为NFT资产进行交易或链上治理，选择链上集成。
二、链下集成方法（ ）
此方法是ENS EP5.1提案引入的升级方案，支持“无Gas的”验证，实现了真正的免费使用。
操作步骤
1. 前提条件：确认您的域名已启用，并使用RSA/SHA-256或ECDSA算法。
2. 添加TXT记录：登录您的DNS托管服务商（如、阿里云、），为域名添加一条TXT记录。
基础配置（使用ENS官方默认解析器）：
主机记录：@
记录值：ENS1 <解析器地址>
快速配置（直接指定解析到的ETH地址）：
主机记录：@
记录值：ENS1 01 <你的以太坊地址>
（注：01 是官方合约地址）
3. 等待生效：DNS变更通常需要10-30分钟在全球传播。
4. 验证：此时您的DNS域名已具备ENS功能，无需任何链上交易。
核心优势
零成本：无需支付以太坊Gas费。
通配符解析：支持子域名自动解析（如 ），无需逐个配置。
三、链上集成方法（ ）
如果您需要将域名以NFT形式持有，或需要在ENS App内集中管理所有记录，请选择此方法。
操作步骤
1. 前提条件：确保已启用且DNS记录传播完成。
2. 添加TXT记录：在DNS管理后台添加TXT记录，格式如下：
主机记录：_ens
记录值：a=<你的以太坊地址>
注意：若之前为链下集成添加过ENS1记录，需先删除旧记录，再添加此新记录。
3. 提交证明（Claim）：
访问 ENS官方应用。
搜索您的域名，点击“ DNS”或“Claim”。
系统会自动生成证明（Proof）并提交至智能合约。
确认钱包中的Gas费，完成交易。
Gas费用参考
链上导入仅需支付以太坊网络Gas费，ENS官方不收取额外协议费。
预估费用：$10 – $50（取决于网络拥堵情况）。
影响因素：网络越拥堵费用越高，使用智能合约钱包（如 Safe）费用比EOA账户更高。
四、代码实现示例（开发者专用）
对于希望将ENS解析功能集成到DApp或后端服务的开发者，推荐使用 Viem 库进行编程。
1. 安装依赖
npm viem @/ensjs
2. 正向解析（ENS域名 → 地址）
{ , http } from 'viem';
{ } from 'viem/';
const = ({
chain: ,
: http('你的'), // 推荐使用专用RPC节点
});
// 解析 .eth 或集成的DNS域名
const = await .({
name: '', // 支持DNS集成域名
});
.log(); // 输出: 0x...
3. 链上导入（编程方式）
如果你需要通过脚本批量导入域名：
{ , , http } from 'viem';
{ } from '@/ensjs';
{ , } from '@/ensjs/dns';
const = ({
chain: (),
: http(),
});
const = ({
chain: (),
: http(.),
});
// 获取DNS导入所需数据（包含证明）
const = await (, {
name: '',
});
// 提交交易完成导入
await (, {
name: '',
,
});
（代码参考自ENS官方文档）
4. 解析链下集成域名（）
对于链下集成的域名（即只配置了 ENS1 记录），使用通用解析库时会自动通过 CCIP-Read 机制（跨链读取）获取链下数据，无需开发者额外处理。
五、故障排查指南
如果在集成过程中遇到问题，请按照以下顺序排查：
1. 域名无法被ENS App识别
问题：更新DNS记录后，App仍显示未检测到。
解决方案：DNS传播有延迟，等待10-30分钟后刷新页面。若仍未生效，使用 分析器 工具检查您的配置是否有误。
2. 提示“TLD 有自定义设置”
问题：系统提示“The team [].tld have their ENS ”。
解决方案：这表示您的顶级域运营商（如 .luxe）有自己的集成方案，无法通过ENS App直接导入。请直接联系您的TLD运营商获取支持。
3. 链下转链上切换失败
问题：想从链下方式（）切换到链上方式（）。
解决方案：必须先删除用于链下集成的 ENS1 记录，然后再添加链上集成所需的 _ens 记录。系统需要时间来检测记录类型的变更。
六、企业级集成场景参考
大型平台（如微软Azure）正在探索将ENS解析集成到传统云服务中，主要应用包括：
1. 去中心化托管：通过集成 limo-web3-dns 库，使Azure DNS能够原生解析 .eth 域名。
2. 去中心化身份：将ENS名称集成至身份系统，替代传统邮箱登录。
3. 数据完整性：利用ENS作为可验证的数据完整性标识。
集成建议：对于企业级应用，建议使用链下集成方式以降低运营成本，并通过自建缓存层减少区块链交互延迟。
总结：对于大多数希望为现有网站增加Web3功能的用户，链下集成（ ） 是最优解——仅需添加一条TXT记录，无需任何Gas费即可让传统域名具备区块链解析能力。需要链上资产属性的场景，则采用链上导入方式。开发者可参考上述代码示例快速实现解析集成。
