终极指南：如何在5分钟内快速启动Handshake全节点

【免费下载链接】hsdHandshake Daemon & Full Node项目地址: https://gitcode.com/gh_mirrors/hs/hsd

Handshake Daemon (HSD) 是Handshake协议的一个完整实现，让你能够运行自己的去中心化域名系统全节点。无论你是想要参与Handshake网络验证、进行域名拍卖，还是构建基于Handshake的应用，本指南都将帮助你快速上手这个强大的去中心化域名系统。

🚀 快速入门：立即运行你的第一个节点

系统要求与安装准备

HSD需要Node.js v14或更高版本。如果你还没有安装Node.js，建议先安装最新LTS版本。对于大多数用户来说，最简单的安装方式是通过npm直接从Git仓库安装：

npm install -g https://github.com/handshake-org/hsd.git

如果你更喜欢从源码构建，可以使用以下命令：

git clone --depth 1 --branch latest https://gitcode.com/gh_mirrors/hs/hsd.git cd hsd npm install --omit=dev

安装完成后，你可以立即启动一个测试网络节点：

./bin/hsd --network=testnet

使用Docker快速部署

如果你熟悉Docker，这是最便捷的部署方式。首先拉取官方镜像：

docker pull ghcr.io/handshake-org/hsd:latest

然后运行容器，将数据目录映射到本地：

docker run --name hsd \ --publish 12037:12037 \ --volume $HOME/.hsd:/root/.hsd \ ghcr.io/handshake-org/hsd:latest \ --http-host 0.0.0.0 \ --api-key=your_api_key_here

🔧 核心功能配置详解

网络连接与同步设置

HSD支持多种网络配置选项。默认情况下，节点会连接到主网（mainnet），但你可以通过参数切换到测试网：

# 连接到测试网络 ./bin/hsd --network=testnet # 接受入站连接并设置最大连接数 ./bin/hsd --listen --max-inbound 50 # 公开节点IP地址以便其他节点连接 ./bin/hsd --listen --public-host [你的公网IP地址] --max-inbound 50

DNS服务器配置

HSD内置了权威DNS服务器和递归DNS服务器，默认分别监听端口5349和5350。你可以自定义这些端口：

# 权威DNS服务器监听5300端口 ./bin/hsd --ns-port 5300 # 递归DNS服务器监听53端口（注意：这会公开你的DNS服务） ./bin/hsd --rs-host 0.0.0.0 --rs-port 53

配置完成后，你可以测试DNS解析功能：

dig @127.0.0.1 www.ietf.org +dnssec dig @127.0.0.1 -p 5300 org +dnssec

RPC API访问控制

为了安全地访问节点的API，你需要设置API密钥：

./bin/hsd --http-host '::' --api-key 'your_secure_key'

💼 实用场景与操作指南

参与域名拍卖流程

Handshake最吸引人的功能之一就是域名拍卖系统。以下是参与拍卖的完整流程：

1. 查询域名状态：

   hsd-rpc getnameinfo example

2. 开启竞拍（如果域名可用）：

   hsw-rpc sendopen example

3. 提交竞标（需要等待一段时间）：

   # 提交5 HNS的竞标，锁定10 HNS作为保证金 hsw-rpc sendbid example 5 10

4. 揭示竞标（竞标期结束后）：

   hsw-rpc sendreveal example

5. 监控竞拍状态：

   hsw-rpc getauctioninfo example

认领现有域名

如果你拥有ICANN认证的域名，可以通过DNSSEC所有权证明在Handshake上认领：

# 创建认领请求 hsw-rpc createclaim yourdomain # 获取TXT记录并添加到你的DNS配置中 # 等待DNS记录传播后发送认领 hsw-rpc sendclaim yourdomain

认领成功后，等待约30天（4,320个区块）成熟期，然后你就可以直接更新域名记录，无需参与竞拍。

CPU挖矿配置

虽然HSD主要用于全节点运行，但也支持CPU挖矿：

# 启动节点并启用挖矿API ./bin/hsd --http-host '::' --api-key 'mining_key' \ --coinbase-address '你的接收地址' # 在另一个终端中启动挖矿 hsd-rpc --http-host 'localhost' \ --api-key 'mining_key' setgenerate true 1

📊 监控与维护最佳实践

数据目录结构

HSD的数据默认存储在~/.hsd目录中，包含以下重要子目录：

• chain/- 区块链数据
• blocks/- 区块存储
• wallets/- 钱包数据
• logs/- 日志文件

常用监控命令

# 查看节点基本信息 hsd-cli info # 查看网络连接状态 hsd-cli getpeerinfo # 查看内存池状态 hsd-cli getmempoolinfo # 查看区块链信息 hsd-cli getblockchaininfo

日志管理与故障排除

HSD的日志输出非常详细，你可以通过以下方式调整日志级别：

# 启用调试日志 ./bin/hsd --log-level=debug # 将日志输出到文件 ./bin/hsd --log-file=/path/to/hsd.log

常见的故障排除步骤包括：

• 检查端口是否被占用
• 确认防火墙设置
• 验证磁盘空间是否充足
• 检查网络连接状态

🛡️ 安全配置建议

生产环境安全设置

1. 使用专用用户运行：

   sudo useradd -r -m -s /bin/false hsd sudo -u hsd ./bin/hsd

2. 配置防火墙规则：

   # 仅允许必要的端口 sudo ufw allow 12038/tcp # P2P端口 sudo ufw allow 12037/tcp # HTTP API端口

3. 定期备份钱包：

   # 备份钱包文件 cp ~/.hsd/wallets/yourwallet ~/backup/

API访问安全

• 永远不要使用默认API密钥
• 为不同的客户端使用不同的API密钥
• 定期轮换API密钥
• 使用IP白名单限制API访问

🚀 进阶功能与集成

与Unbound集成

为了获得最佳性能和DNS兼容性，HSD支持与Unbound集成：

# 确保系统已安装unbound sudo apt-get install unbound # HSD会自动检测并使用libunbound ./bin/hsd

自定义插件开发

HSD支持插件系统，你可以在lib/wallet/plugin.js中找到插件接口。创建自定义插件可以扩展钱包功能，比如添加新的交易类型或集成外部服务。

📈 性能优化技巧

1. 使用SSD存储：区块链数据量较大，SSD能显著提升同步速度
2. 调整内存缓存：通过--cache-size参数优化内存使用
3. 并行处理：多核CPU系统可以调整线程数
4. 网络优化：调整--max-inbound和--max-outbound参数

🎯 总结

通过本指南，你已经掌握了Handshake全节点的核心配置和操作。无论你是想要运行一个简单的测试节点，还是部署生产环境的高可用集群，HSD都提供了灵活的配置选项和强大的功能。

记住，Handshake是一个不断发展的生态系统，定期查看docs/release-notes/目录中的更新日志，保持节点软件的最新状态。如果你遇到任何问题，项目中的测试用例和文档都是宝贵的参考资料。

现在就开始你的Handshake之旅吧！运行你的第一个节点，参与域名拍卖，或者基于Handshake构建创新的去中心化应用。去中心化的域名系统正在改变互联网的基础架构，而你正是这场变革的一部分。🌟

【免费下载链接】hsdHandshake Daemon & Full Node项目地址: https://gitcode.com/gh_mirrors/hs/hsd