# 使用 Homebrew 安装 ioctl

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

## 安装

```sh
sudo av install brew:ioctl
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install ioctl
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:ioctl
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/ioctl>
- **版本:** 2.4.3
- **来源摘要:** Command-line interface for interacting with the IoTeX blockchain
- **主页:** <https://docs.iotex.io/>
- **仓库:** <https://github.com/iotexproject/iotex-core>
- **上游文档:** <https://docs.iotex.io/>
- **许可证:** Apache-2.0
- **源码归档:** <https://github.com/iotexproject/iotex-core/archive/refs/tags/v2.4.3.tar.gz>
- **最后更新:** 2026-07-07T07:00:48Z
- **已生成:** 2026-07-10T07:20:53+00:00

## 可执行文件

- ioctl (cli)
- ioctl (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## 版本和新鲜度

- 页面生成时间: 2026-07-10
- 管理器版本: 2.4.3
- 管理器更新时间: 2026-07-07
- 本地数据: OK
- 上游仓库: https://github.com/iotexproject/iotex-core
- 检测到的最新版本: v2.4.3 (当前)
## 项目历史与用法

ioctl is the command-line client for interacting with the IoTeX blockchain. It is built from the iotex-core repository and gives developers, node operators, and wallet users a terminal interface for installation checks, endpoint configuration, accounts, actions, queries, smart contracts, staking, tokens, ioID identities, W3bstream, DID, and JWT-related workflows.

### 项目历史

ioctl's history is coupled to iotex-core, the Go implementation of the IoTeX blockchain protocol. The IoTeX docs show `make ioctl` as the source-build path and the GitHub repository describes iotex-core as the official implementation of the protocol.

The official reference includes a version example built in April 2019, which places the CLI in the early public mainnet era of IoTeX tooling. IoTeX project updates from that period discuss Mainnet Alpha launch preparation and delegate operations, the same operational context in which a chain CLI is needed.

Over time, ioctl became a documented developer and operator tool rather than only a build artifact. The docs include install scripts, Homebrew installation, endpoint setup for mainnet and testnet gateways, update commands, and a reference tree covering the core blockchain interaction surface.

### 采用历史

ioctl adoption tracks IoTeX ecosystem participation: developers use it to configure endpoints and interact with the chain, wallet users can create and inspect accounts, and delegates or node operators rely on command-line workflows around releases and network operations. The Homebrew formula makes the CLI available as a standard macOS package.

### 使用方式

Users install ioctl with the IoTeX install script, Homebrew, or a source build from iotex-core, then configure an endpoint such as the IoTeX mainnet or testnet gateway. The reference documents `ioctl config`, `ioctl update`, `ioctl version`, and command groups for accounts, queries, actions, smart contracts, staking, tokens, and identity-related features.

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

ioctl is a good example of a blockchain project CLI packaged separately from the node daemon but built from the same monorepo. For package maintainers, that means versioning, release assets, install scripts, and node/network compatibility all matter more than a normal standalone utility's flags.

The name is also package-nerd bait: it collides conceptually with Unix `ioctl(2)`, but in Homebrew it is the IoTeX client executable. Context from docs and repository metadata is essential to avoid misclassifying it as a low-level Unix system tool.

### 时间线

- 2018-2019: IoTeX project updates describe Mainnet Alpha preparation and launch-era network operations.
- 2019-04: IoTeX docs show `ioctl version` output from client and server builds around Mainnet Alpha timing.
- 2019 onward: Documentation organizes ioctl as the command-line client for accounts, actions, queries, smart contracts, staking, tokens, and identities.
- Package-manager era: Homebrew provides the `ioctl` formula for installing the IoTeX CLI.
- 2026: iotex-core release notes continue to ship protocol releases from the same repository that contains the CLI.

### Related projects

- iotex-core is the source repository and blockchain implementation that contains ioctl.
- iotex-bootstrap documents node and network operation around iotex-core releases.
- IoTeX docs, IoTeXscan, staking tools, ioID, and W3bstream are adjacent ecosystem surfaces referenced from the ioctl documentation.

### 来源

- <https://community.iotex.io/t/official-iotex-project-updates/695>
- <https://docs.iotex.io/blockchain/build/reference-docs/ioctl-client>
- <https://docs.iotex.io/blockchain/build/web3-development/ioctl-cli>
- <https://docs.iotex.io/blockchain/build/web3-development/ioctl-cli/installation>
- <https://formulae.brew.sh/formula/ioctl>
- <https://github.com/iotexproject/iotex-core>
- <https://github.com/iotexproject/iotex-core/releases>


## 安全说明

没有找到 ioctl 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## 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: ~/.config/ioctl/default/config.default

## Credential files

- Unix: ~/.config/ioctl/default
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ioctl
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## 相关链接

- [Terminal utility packages](https://www.automicvault.com/zh-hans/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/zh-hans/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Language runtime packages](https://www.automicvault.com/zh-hans/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/zh-hans/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/zh-hans/pkg/brew/go/) - Build dependency declared by Homebrew.
- [bcoin](https://www.automicvault.com/zh-hans/pkg/brew/bcoin/) - Shares av.db curated category or tags: blockchain, cli, data.
- [burrow](https://www.automicvault.com/zh-hans/pkg/brew/burrow/) - Shares av.db curated category or tags: cli, data, go.
- [cayley](https://www.automicvault.com/zh-hans/pkg/brew/cayley/) - Shares av.db curated category or tags: cli, data, go.
- [clickhouse-sql-parser](https://www.automicvault.com/zh-hans/pkg/brew/clickhouse-sql-parser/) - Shares av.db curated category or tags: cli, data, go.
- [conduit](https://www.automicvault.com/zh-hans/pkg/brew/conduit/) - Shares av.db curated category or tags: cli, data, go.
- [cql](https://www.automicvault.com/zh-hans/pkg/brew/cql/) - Shares av.db curated category or tags: blockchain, cli, data.
- [iceberg-cli](https://www.automicvault.com/zh-hans/pkg/brew/iceberg-cli/) - Shares av.db curated category or tags: cli, data, go.
- [kaf](https://www.automicvault.com/zh-hans/pkg/brew/kaf/) - Shares av.db curated category or tags: cli, data, go.
- [astra](https://www.automicvault.com/zh-hans/pkg/brew/astra/) - Local package facts share a topical domain. Shared terms: cli, command-line, data, interface, line.
- [cubejs-cli](https://www.automicvault.com/zh-hans/pkg/brew/cubejs-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, data, interface, line.

## Combined YAML source

View the package source record on GitHub. [combined/ioctl.yml](https://github.com/automic-vault/db/blob/main/combined/ioctl.yml)


## 来源

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
