macOS
Homebrew已验证 · 100%
brew install toxiproxylocal Homebrew formula metadata
MacPorts已验证 · 94%
sudo port install toxiproxyMacPorts ports tree · net/toxiproxy/Portfile · 来源: api.github.com
安装
其他安装命令
Linux
Fedora dnf已验证 · 92%
sudo dnf install toxiproxyFedora Rawhide package metadata · toxiproxy · 来源: dl.fedoraproject.org
Nix已验证 · 92%
nix profile install nixpkgs#toxiproxynixpkgs package indexes · pkgs/by-name/to/toxiproxy/package.nix · 来源: api.github.com
概览
软件包摘要
TCP proxy to simulate network & system conditions for chaos & resiliency testing
历史
项目历史与用法
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.
来源
安全态势
风险级别：orange
broad file, network, media, or database tool signal. formula declares a Homebrew service.
风险分类器
orange 风险 · 中 置信度 · infrastructure
原因
- broad file, network, media, or database tool signal
- formula declares a Homebrew service
信号
- metadata:service
- text:network,server
安装行为
- formula 元数据中未记录 Homebrew post-install 钩子。
- formula 元数据声明了服务或守护进程块。
- Homebrew bottle 元数据适用于 8 个平台目标。
- 构建元数据列出 1 个构建依赖。
建议审查
在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。
local files
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
Config paths the tool may read or write during local use.
- Unix
config/toxiproxy.json
可执行文件
已安装的可执行文件
| 命令 | 类型 | 暴露范围 | 备注 |
|---|---|---|---|
toxiproxy-cli | cli | 全局可执行文件 | |
toxiproxy-server | cli | 全局可执行文件 |
新鲜度
版本和新鲜度
这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。
页面生成时间2026-08-04
管理器版本2.12.0
管理器更新时间2026-07-26
本地数据OK
上游当前
检测到的最新版本v2.12.0
https://github.com/Shopify/toxiproxy
- OK没有生成新鲜度警告。
安装元数据
软件包元数据
| 软件包键 | brew:toxiproxy |
|---|---|
| 版本 | 2.12.0 |
| 软件包管理器 | Homebrew |
| 软件包管理器页面 | https://formulae.brew.sh/formula/toxiproxy |
| 主页 | https://github.com/shopify/toxiproxy |
| 仓库 | https://github.com/shopify/toxiproxy |
| 许可证 | MIT |
| 源码归档 | https://github.com/Shopify/toxiproxy/archive/refs/tags/v2.12.0.tar.gz |
| 最后更新 | 2026-07-26T00:51:26+02:00 |
| Pulse | updated |
| 构建依赖 | go |
| Bottle | 可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux) |
| Homebrew post-install | 未定义 |
| 服务 | declared |
注册表事实
源数据库详情
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | toxiproxy |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
源数据库匹配
其他软件包管理器记录
匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。
Nix95%
toxiproxy
nix profile install nixpkgs#toxiproxy- normalized package name match
- 匹配方式：Toxiproxy
dnf95%
toxiproxy 2.1.4-23.fc44
TCP proxy to simulate network and system conditions for resiliency testing
https://github.com/Shopify/toxiproxy
sudo dnf install toxiproxy- License: MIT
- Category: Unspecified
- Architecture: x86_64
- Source Package: golang-github-shopify-toxiproxy
- 6 依赖
- 2 提供
- normalized package name match
- 匹配方式：Toxiproxy
MacPorts95%
toxiproxy
sudo port install toxiproxy- normalized package name match
- 匹配方式：Toxiproxy
来源线索
由仓库数据生成
此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。
Combined YAML source
View the package source record on GitHub.
使用的来源
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment
- pkg.so package database
- pkgdb category and tag curation