# toxiproxy を Homebrew, dnf, MacPorts, Nix でインストール

toxiproxy のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:toxiproxy
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install toxiproxy
```

  証拠: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install toxiproxy
```

  証拠: MacPorts ports tree: net/toxiproxy/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- dnf (92%):

```sh
sudo dnf install toxiproxy
```

  証拠: Fedora Rawhide package metadata: toxiproxy from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#toxiproxy
```

  証拠: nixpkgs package indexes: pkgs/by-name/to/toxiproxy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## パッケージ情報

- **パッケージキー:** brew:toxiproxy
- **パッケージマネージャ:** Homebrew
- **バージョン:** 2.12.0
- **ソース概要:** TCP proxy to simulate network & system conditions for chaos & resiliency testing
- **ホームページ:** <https://github.com/shopify/toxiproxy>
- **リポジトリ:** <https://github.com/Shopify/toxiproxy>
- **最終更新:** 2026-07-26T00:51:26+02:00
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- toxiproxy-cli (エイリアス)
- toxiproxy-server (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

- ページ生成日: 2026-08-03
- マネージャ版: 2.12.0
## プロジェクトの歴史と使われ方

Toxiproxy is Shopify's TCP proxy for simulating network conditions in tests, CI, and development. It lets applications route connections through a local proxy and then apply deterministic or randomized failures such as latency, bandwidth limits, timeouts, packet loss, resets, and disabled links.

### プロジェクトの歴史

Shopify created Toxiproxy during its 2014 resiliency work, when the infrastructure team needed automated ways to test behavior under slow or unavailable dependencies before the holiday traffic season. The official README says Shopify had been using it in all development and test environments since October 2014.

The first public GitHub release, v1.0.0, was published in January 2015 as 'Public Release'. The project later moved through a 2.x line with a Go TCP proxy server, HTTP API, command-line client, metrics documentation, and multiple client libraries.

### 採用の歴史

Toxiproxy spread because it packaged a distributed-systems testing trick into a repeatable developer tool. Instead of requiring root-only Linux networking tools such as tc or iptables, developers could install a user-space proxy, declare upstream services, and manipulate faults from tests through HTTP or client libraries.

The official README lists clients for Ruby, Go, Python, .NET, PHP, Node.js, Java, Haskell, Rust, and Elixir. Homebrew, MacPorts, Nix, and Fedora packaging in the source facts show it being distributed as a standalone CLI/server tool rather than just as a Ruby testing helper.

### 使われ方

A typical test setup starts `toxiproxy-server`, populates proxy definitions for dependencies such as Redis or MySQL, points the application at the proxy listen ports, and uses a client or `toxiproxy-cli` to apply toxics around a test case.

The README's Rails example demonstrates taking down Redis or adding latency to MySQL to verify fallback behavior. The same model applies to any TCP dependency, which is why Toxiproxy fits CI and local development better than manually editing host networking rules.

### パッケージ好きにとっての重要性

For package nerds, Toxiproxy is a high-signal example of infrastructure testing becoming a simple package install. It turns failure injection into `brew install toxiproxy`, a server process, and a CLI/API surface that can be scripted from test suites.

It also helped normalize resilience testing in ordinary application repositories: package maintainers and application developers could add fault-injection checks without privileged networking setup or specialized chaos-testing platforms.

### タイムライン

- 2014: Shopify begins using Toxiproxy in development and test environments.
- 2015: v1.0.0 'Public Release' published on GitHub Releases.
- 2.x: README documents cross-platform binaries, Docker/GitHub container registry usage, HTTP API, metrics, toxics, and multiple language clients.

### Related projects

- The README positions Toxiproxy as a safer test/CI alternative to nc, tc, iptables, and similar low-level networking tools. Shopify engineering articles also connect it to resiliency work and circuit-breaker testing.

### ソース

- <https://api.github.com/repos/Shopify/toxiproxy/releases>
- <https://github.com/Shopify/toxiproxy#readme>
- <https://shopify.engineering/building-and-testing-resilient-ruby-on-rails-applications>
- source_facts.package-manager


## セキュリティノート

broad file, network, media, or database tool signal. formula declares a Homebrew service.

- **Geiger リスク:** orange / 中
- broad file, network, media, or database tool signal
- formula declares a Homebrew service


## 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/toxiproxy.json
## 他のパッケージマネージャ記録

- Nix - toxiproxy: normalized package name match | nixpkgs package indexes: pkgs/by-name/to/toxiproxy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- dnf - toxiproxy - 2.1.4-23.fc44: normalized package name match | Fedora Rawhide package metadata: toxiproxy from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | TCP proxy to simulate network and system conditions for resiliency testing | https://github.com/Shopify/toxiproxy
- MacPorts - toxiproxy: normalized package name match | MacPorts ports tree: net/toxiproxy/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/toxiproxy.yml](https://github.com/mxcl/pkgdb/blob/main/combined/toxiproxy.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
