# 使用 Homebrew, Nix 安装 xk6

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

## 安装

```sh
sudo av install brew:xk6
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install xk6
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#xk6
```

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

## 软件包事实

- **软件包键:** brew:xk6
- **软件包管理器:** Homebrew
- **版本:** 1.4.9
- **来源摘要:** Build k6 with extensions
- **主页:** <https://k6.io>
- **仓库:** <https://github.com/grafana/xk6>
- **最后更新:** 2026-08-02T22:31:36Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- xk6 (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

xk6 is Grafana k6's extension-development toolbox: a command-line tool for creating extension skeletons, building custom k6 binaries, running k6 with extensions, testing extensions, linting extension projects, and sharing reusable extension workflows. In package terms it is the bridge between the stock k6 executable and the larger Go-module ecosystem of k6 extensions.

### 项目历史

The tool grew out of k6's decision to keep the core load-testing runtime small while letting users compile in Go-based extensions. The current Grafana repository presents xk6 as the official toolbox for extension authors and lists its main jobs as scaffolding, building, running, testing, linting, reusable workflows, Docker use, and development-container support.

xk6's command surface has expanded from the basic custom-builder role into a fuller extension workflow. Its README documents commands such as `xk6 new`, `xk6 build`, `xk6 run`, `xk6 lint`, `xk6 test`, and `xk6 sync`; the build command also handles extension module paths, replacements, target OS/architecture, k6 forks, and k6 major-version resolution.

### 采用历史

xk6 became important because many useful k6 capabilities live outside the default binary. Grafana's extension documentation tells users that official and community extensions may be resolved automatically in newer k6 releases, but that other extensions, including private or newly-created ones, still require building a custom k6 binary with xk6.

The tool is therefore part of the normal path for k6 users who need SQL outputs, custom protocols, test helpers, private modules, or experimental APIs before they are available in the main k6 release. Grafana also publishes an xk6 Docker image so users can build custom binaries without first setting up a local Go toolchain.

### 使用方式

Typical use is `xk6 build --with module[@version]` to produce a custom `k6` executable containing one or more extensions. Extension developers also use `xk6 run` to rebuild and execute during development, `xk6 new` to create a template project, and `xk6 lint` or `xk6 test` to check extension compliance.

xk6 is most relevant when the desired extension is not handled by k6 automatic extension resolution, when an output extension is involved, when the extension is private, or when the user needs to pin or replace Go modules during a custom build.

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

xk6 is a package-nerd example of a small CLI that exists to manufacture another CLI. Its value is not in running load tests directly, but in making reproducible, module-aware k6 binaries from Go extension packages.

It also shows how modern developer tools push extension distribution into language package ecosystems: the package manager installs xk6, xk6 asks Go for modules, and the result is a custom executable tailored to a testing stack.

### 时间线

- 2020: Public support discussions show users installing and troubleshooting xk6 for custom k6 builds.
- 2021-2022: Grafana community answers routinely recommend `xk6 build ... --with ...` for extension-based k6 binaries.
- 2025: The Grafana xk6 repository records v0.x development and documents xk6 as a broader extension-development toolbox, not only a builder.
- 2026: Grafana k6 documentation still directs users to xk6 for custom binaries when automatic extension resolution is not enough.

### Related projects

- k6 is the load-testing runtime that xk6 builds. The surrounding ecosystem includes Grafana's k6 extension registry, xk6 extension template repositories, and individual extensions such as xk6-sql, xk6-output-influxdb, xk6-faker, and xk6-disruptor.

### 来源

- <https://community.grafana.com/t/i-need-to-build-k6-with-an-extension-in-local/97838>
- <https://community.grafana.com/t/unable-to-locate-xk6-after-installing-it/99016>
- <https://github.com/grafana/xk6>
- <https://grafana.com/docs/k6/latest/extensions/>
- <https://grafana.com/docs/k6/latest/extensions/run/>
- <https://grafana.com/docs/k6/latest/extensions/run/build-k6-binary-using-go/>
- <https://registry.k6.io/>


## 安全说明

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


## 其他软件包管理器记录

- Nix - xk6: normalized package name match | nixpkgs package indexes: pkgs/by-name/xk/xk6/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/xk6.yml](https://github.com/mxcl/pkgdb/blob/main/combined/xk6.yml)


## 来源

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