# 使用 Homebrew, Nix 安装 hsd

查看 hsd 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:hsd
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install hsd
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#hsd
```

  证据: nixpkgs package indexes: pkgs/by-name/hs/hsd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:hsd
- **软件包管理器:** Homebrew
- **版本:** 8.0.0
- **来源摘要:** Handshake Daemon & Full Node
- **主页:** <https://handshake.org>
- **仓库:** <https://github.com/handshake-org/hsd>
- **最后更新:** 2026-06-22T14:03:43-07:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- hs-seeder (别名)
- hs-wallet (别名)
- hsd (别名)
- hsd-cli (别名)
- hsd-node (别名)
- hsd-rpc (别名)
- hsd-spvnode (别名)
- hsw-cli (别名)
- hsw-rpc (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 8.0.0
## 项目历史与用法

HSD is the JavaScript full-node and daemon implementation of the Handshake protocol, a decentralized naming and certificate-authority experiment built around a peer-to-peer root zone.

### 项目历史

Handshake's own site identifies hsd as the initial code for the protocol, and the hsd README describes it as an implementation of Handshake. The project grew as a node, wallet, DNS resolver, RPC server, and CLI suite rather than as a single-purpose daemon.

The README and install guide show a Node.js-based project distributed from the official GitHub repository, installable from source, Git refs, Homebrew, and container images. The command set includes hsd, hsd-cli, hsw-cli, RPC shortcuts, wallet tools, and seeding utilities.

### 采用历史

HSD adoption is tied to Handshake network participation: running a full node, serving recursive or authoritative DNS, managing wallets, mining, claiming names through DNSSEC proofs, and participating in name auctions. The Homebrew and Nix package metadata in the input shows packaging beyond npm-style installation.

The release notes show long-running protocol maintenance with network soft forks, database and wallet migrations, API changes, and DNS/name-resolution improvements. That makes hsd closer to Bitcoin-derived node software than to a disposable CLI.

### 使用方式

Common usage is operational: run hsd as a full node, query it with hsd-cli, manage wallet state with hsw-cli, expose node and wallet HTTP APIs, and configure DNS ports for recursive or authoritative service.

The README emphasizes bitcoind-style RPC plus additional REST APIs, name auction commands such as sendopen, sendbid, sendreveal, sendupdate, and DNSSEC-based claim flows.

### 为什么软件包爱好者会关心

For package maintainers, hsd is significant because it packages a full blockchain/DNS stack with native dependency considerations such as libunbound, network ports, persistent state under ~/.hsd, wallet migrations, and security-sensitive API keys.

It is also a good example of an ecosystem package where the formula is not just installing a binary: the package participates in a protocol, has stateful upgrades, and exposes multiple command-line entry points.

### 时间线

- 2018-2019: Public v0.x tags and testnet tags appear in the upstream repository.
- 2020: v1.0.0 appears in the upstream tag series.
- 2023: v6.0.0 release notes include the ICANN Lockup soft fork and configuration changes.
- 2024: v7.0.0 release notes describe wallet migrations, interactive rescans, and history API changes.
- 2025: v8.0.0 release notes include the End Airdrop soft fork.

### Related projects

- Related projects include the Handshake protocol documentation, hs-client for RPC helpers, Bob Wallet as a GUI wallet, bns for DNS-related functionality, and libunbound for recursive resolver support.

### 来源

- <https://github.com/handshake-org/hsd#readme>
- <https://github.com/handshake-org/hsd/blob/master/CHANGELOG.md>
- <https://github.com/handshake-org/hsd/blob/master/docs/install.md>
- <https://handshake.org>


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.hsd/hsd.conf, ~/.hsd/hsw.conf, ~/.hsd/<network>/hsd.conf

## Credential files

- Unix: ~/.hsd/hsd.conf, ~/.hsd/hsw.conf
## 其他软件包管理器记录

- Nix - hsd: normalized package name match | nixpkgs package indexes: pkgs/by-name/hs/hsd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/hsd.yml](https://github.com/mxcl/pkgdb/blob/main/combined/hsd.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
