# 使用 Homebrew, apt 安装 obfs4proxy

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

## 安装

```sh
sudo av install brew:obfs4proxy
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install obfs4proxy
```

  证据: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install obfs4proxy
```

  证据: Debian stable package indexes: obfs4proxy from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## 软件包事实

- **软件包键:** brew:obfs4proxy
- **软件包管理器:** Homebrew
- **版本:** 0.0.14
- **来源摘要:** Pluggable transport proxy for Tor, implementing obfs4
- **主页:** <https://gitlab.com/yawning/obfs4>
- **最后更新:** 2026-07-27T23:46:50+02:00
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- obfs4proxy (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

obfs4proxy is the executable from Yawning Angel's obfs4 project, a Go implementation of the obfs4 Tor pluggable transport. Its job is to transform Tor traffic between a censored client and a bridge so that network observers see obfuscated traffic rather than a recognizable Tor connection.

### 项目历史

The upstream README describes obfs4 as a "look-like nothing" obfuscation protocol that borrows concepts from Philipp Winter's ScrambleSuit while changing the handshake design. The protocol uses the Tor Project's ntor handshake with public keys obfuscated through Elligator 2, and the link layer uses NaCl secret boxes based on Poly1305 and XSalsa20.

The GitLab project record was created on 2019-01-16, but the protocol and proxy have older Tor ecosystem roots; Debian packaging and historical discussions predate that GitLab creation date. The executable kept compatibility paths for obfs2 and obfs3 client/server modes and ScrambleSuit client mode to ease migration while obfs4 became the main focus.

### 采用历史

Tor's bridge-operator documentation tells volunteers how to set up an obfs4 bridge for censored users and links platform-specific deployment guides across Linux distributions, BSD systems, Windows, and Docker. The same Tor page notes that the obfs4 project was renamed to lyrebird for source-building guidance, reflecting a handoff in anti-censorship transport maintenance while the `obfs4proxy` package name persists in distributions.

Debian packages obfs4proxy in the net section and describes it as compliant with the Tor pluggable transports specification, containing both client and bridge functionality in one program. Homebrew core packaged version 0.0.14 and recorded 532 installs over 365 days in the 2026-07-01 formula JSON.

### 使用方式

Operators run obfs4proxy from Tor configuration using `ServerTransportPlugin obfs4 exec ...` on bridges and `ClientTransportPlugin obfs4 exec ...` on clients. The upstream README also documents generated bridge parameters in Tor's pluggable-transport state directory and suggests using Linux capabilities when a bridge needs to bind low-numbered ports without running as root.

The Tor pluggable transport specification explains the broader architecture that obfs4proxy implements: Tor launches modular subprocesses that transform traffic for censorship circumvention. In practice, obfs4proxy is the subprocess that speaks the obfs4 transport while Tor handles relay and bridge behavior around it.

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

obfs4proxy is significant because it is not just another proxy binary; it is distribution-packaged anti-censorship infrastructure. Package managers make it easy for bridge operators and users to deploy the exact helper process Tor expects, while preserving a small single-executable interface around fairly specialized cryptographic and transport behavior.

### 时间线

- 2019-01-16: the GitLab project record for yawning/obfs4 was created.
- 2026-07-01: Homebrew core formula metadata listed stable version 0.0.14 and the `obfs4proxy` executable.
- 2026-07-01: Debian sid package metadata listed obfs4proxy 0.0.14-2 variants across multiple architectures.

### Related projects

- obfs4proxy belongs to Tor's pluggable-transport family and is related to older transports obfs2, obfs3, and ScrambleSuit, plus later Tor anti-censorship transports such as WebTunnel and Snowflake. The upstream project page and Tor bridge guide connect the historical obfs4 name with the lyrebird source project name used in newer Tor documentation.

### 来源

- <https://community.torproject.org/relay/setup/bridge/>
- <https://formulae.brew.sh/api/formula/obfs4proxy.json>
- <https://gitlab.com/api/v4/projects/yawning%2Fobfs4>
- <https://gitlab.com/yawning/obfs4>
- <https://packages.debian.org/unstable/net/obfs4proxy>
- <https://spec.torproject.org/pt-spec/index.html>


## 安全说明

narrow executable package without higher-risk signals.

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

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

- Debian apt - obfs4proxy - 0.0.14-2+b5: normalized package name match | Debian stable package indexes: obfs4proxy from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | pluggable transport proxy for Tor, implementing obfs4 | https://gitlab.com/yawning/obfs4
- Ubuntu apt - obfs4proxy - 0.0.14-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: obfs4proxy from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | pluggable transport proxy for Tor, implementing obfs4 | https://gitlab.com/yawning/obfs4


## Combined YAML source

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