# 使用 Homebrew, apk, dnf, MacPorts, Nix, zypper, scoop, winget 安装 butane

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

## 安装

```sh
sudo av install brew:butane
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install butane
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install butane
```

  证据: MacPorts ports tree: sysutils/butane/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add butane
```

  证据: Alpine Linux edge package indexes: butane from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- dnf (92%):

```sh
sudo dnf install butane
```

  证据: Fedora Rawhide package metadata: butane from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#butane
```

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

- zypper (92%):

```sh
sudo zypper install butane
```

  证据: openSUSE Tumbleweed package metadata: butane from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install extras/butane
```

  证据: Scoop official bucket manifest trees: bucket/butane.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Fedora.CoreOS.butane -e
```

  证据: Windows Package Manager source index: Fedora.CoreOS.butane from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:butane
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/butane>
- **版本:** 0.29.0
- **来源摘要:** Translates human-readable Butane Configs into machine-readable Ignition Configs
- **主页:** <https://coreos.github.io/butane/>
- **仓库:** <https://github.com/coreos/butane>
- **上游文档:** <https://coreos.github.io/butane/>
- **许可证:** Apache-2.0
- **源码归档:** <https://github.com/coreos/butane/archive/refs/tags/v0.29.0.tar.gz>
- **最后更新:** 2026-07-07T21:31:40Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- butane (cli)
- butane (别名)

## 构建依赖

- go

## 安装行为

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

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 0.29.0
- 管理器更新时间: 2026-07-07
- 本地数据: OK
- 上游仓库: https://github.com/coreos/butane
- 检测到的最新版本: v0.29.0 (当前)
## 项目历史与用法

Butane is the Fedora CoreOS-era configuration transpiler that turns human-readable YAML-like Butane Configs into Ignition JSON. It sits in the provisioning path for Fedora CoreOS, Flatcar-style immutable host workflows, and other Ignition consumers where operators want reviewable source configuration without hand-writing low-level Ignition documents.

### 项目历史

The project was originally known as the Fedora CoreOS Config Transpiler, or FCCT, and was later renamed Butane. Its README still describes that lineage directly: Butane was formerly FCCT and translates human-readable configs into machine-readable Ignition configs.

Butane tracks versioned config variants and Ignition spec versions. The development documentation describes separate versioned base and config packages, experimental spec versions, stabilization checklists, and a Fedora RPM-based release build process.

### 采用历史

Butane became part of the Fedora CoreOS provisioning ecosystem because Fedora CoreOS machines are initialized through Ignition. It is packaged beyond Homebrew in Fedora, Nix, MacPorts, Scoop, winget, Alpine, and openSUSE according to the supplied package-manager facts, which reflects use by both Linux operators and workstation users preparing machine configs.

### 使用方式

A typical workflow is to write a Butane config, run the `butane` CLI to validate and translate it, and feed the generated Ignition config to a Fedora CoreOS or related machine at first boot. The official docs emphasize the getting-started guide and per-variant configuration specifications.

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

Butane is package-nerd interesting because it is not just a format converter: it encodes Fedora CoreOS and Ignition schema evolution into a small CLI that distributions can ship. Formula and distro maintainers care about its spec-version matrix, Go build process, and tight relationship with Ignition releases.

### 时间线

- 2019: v0.1.0 tag appears in the official Git repository.
- 2020: The project continues under the Butane name after the FCCT era.
- 2026: v0.28.0 tag appears in the official Git repository.

### Related projects

- Ignition is the machine-readable config format emitted by Butane.
- Fedora CoreOS is the operating-system project most closely associated with Butane configs.
- Fedora rpms/butane is the packaging repository described by the project development docs for released binaries.

### 来源

- <https://coreos.github.io/butane/getting-started>
- <https://coreos.github.io/butane/specs>
- <https://github.com/coreos/butane>
- <https://github.com/coreos/butane/blob/main/docs/development.md>
- source_facts.package-manager


## 安全说明

narrow executable package without higher-risk signals.

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

## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** butane
- **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

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

- Nix - butane: normalized package name match | nixpkgs package indexes: pkgs/by-name/bu/butane/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - butane - 0.29.0-r1: normalized package name match | Alpine Linux edge package indexes: butane from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Butane to Ignition config generator | https://github.com/coreos/butane
- dnf - butane - 0.29.0-2.fc45: normalized package name match | Fedora Rawhide package metadata: butane from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-primary.xml.zst | Butane config transpiler | https://github.com/coreos/butane
- dnf - butane-redistributable - 0.29.0-2.fc45: normalized package name match | Fedora Rawhide package metadata: butane-redistributable from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/210a2053c8e007daf9ae39c2a21daaed9b2ddd07d63ecffa597050361e73650c-primary.xml.zst | Statically built Butane for Linux, macOS and Windows | https://github.com/coreos/butane
- zypper - butane - 0.27.0-1.5: normalized package name match | openSUSE Tumbleweed package metadata: butane from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Tool to generate Ignition configs from Butane Configs | https://github.com/coreos/butane
- MacPorts - butane: normalized package name match | MacPorts ports tree: sysutils/butane/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - extras/butane: normalized package name match | Scoop official bucket manifest trees: bucket/butane.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
- winget - Fedora.CoreOS.butane: normalized package name match | Windows Package Manager source index: Fedora.CoreOS.butane from https://cdn.winget.microsoft.com/cache/source.msix


## 相关链接

- [Source-control packages](https://pkg.so/zh-hans/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/zh-hans/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/zh-hans/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [config-file-validator](https://pkg.so/zh-hans/brew/config-file-validator/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools, yaml.
- [dhall-json](https://pkg.so/zh-hans/brew/dhall-json/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools, yaml.
- [editorconfig](https://pkg.so/zh-hans/brew/editorconfig/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools.
- [dynaconf](https://pkg.so/zh-hans/brew/dynaconf/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools.
- [json2hcl](https://pkg.so/zh-hans/brew/json2hcl/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools.
- [libucl](https://pkg.so/zh-hans/brew/libucl/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools.
- [dhall-bash](https://pkg.so/zh-hans/brew/dhall-bash/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools.
- [setconf](https://pkg.so/zh-hans/brew/setconf/) - Shares pkgdb curated category or tags: cli, configuration, developer-tools.
- [aliae](https://pkg.so/zh-hans/brew/aliae/) - Both packages work with overlapping file formats or content types. Shared terms: cli, configuration, developer, developer-tools, yaml.

## Combined YAML source

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


## 来源

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