# Installer toxiproxy avec Homebrew, dnf, MacPorts, Nix

Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de toxiproxy pour les workflows d'agents IA.

## installation

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

Commandes d'installation supplémentaires:

### macOS

- Homebrew (100%):

```sh
brew install toxiproxy
```

  Preuve: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install toxiproxy
```

  Preuve: 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
```

  Preuve: 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
```

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

## Faits du paquet

- **Clé du paquet:** brew:toxiproxy
- **Gestionnaire de paquets:** Homebrew
- **Version:** 2.12.0
- **Résumé source:** TCP proxy to simulate network & system conditions for chaos & resiliency testing
- **Page d'accueil:** <https://github.com/shopify/toxiproxy>
- **Dépôt:** <https://github.com/Shopify/toxiproxy>
- **Dernière mise à jour:** 2026-07-26T00:51:26+02:00
- **Généré:** 2026-08-03T19:37:03+00:00

## exécutables

- toxiproxy-cli (alias)
- toxiproxy-server (alias)

## Comportement d'installation

- Bouteille: non disponible

## Version et fraîcheur

- page générée: 2026-08-03
- version du gestionnaire: 2.12.0
## Historique du projet et usages

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.

### Historique du projet

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.

### Historique d'adoption

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.

### Modes d'utilisation

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.

### Pourquoi les passionnés de paquets s'y intéressent

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.

### Chronologie

- 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.

### Sources

- <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


## Notes de sécurité

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

- **Risque Geiger:** orange / moyen
- 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
## Autres enregistrements de gestionnaires de paquets

- 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)


## Sources

- 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
