# 使用 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
- **软件包管理器页面:** <https://formulae.brew.sh/formula/obfs4proxy>
- **版本:** 0.0.14
- **来源摘要:** Pluggable transport proxy for Tor, implementing obfs4
- **主页:** <https://gitlab.com/yawning/obfs4>
- **上游文档:** <https://gitlab.com/yawning/obfs4>
- **许可证:** BSD-2-Clause
- **源码归档:** <https://gitlab.com/yawning/obfs4/-/archive/obfs4proxy-0.0.14/obfs4-obfs4proxy-0.0.14.tar.gz>
- **最后更新:** 2026-07-27T23:46:50+02:00
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- obfs4proxy (cli)
- obfs4proxy (别名)

## 构建依赖

- go

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 0.0.14
- 管理器更新时间: 2026-07-27
- 本地数据: OK
- 上游仓库: https://gitlab.com/yawning/obfs4
- 信息: Release/tag comparison is only available for GitHub repositories.
## 项目历史与用法

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

## 源数据库详情

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

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

- 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


## 相关链接

- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://pkg.so/zh-hans/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://pkg.so/zh-hans/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://pkg.so/zh-hans/brew/go/) - Build dependency declared by Homebrew.
- [meek](https://pkg.so/zh-hans/brew/meek/) - Shares pkgdb curated category or tags: censorship-circumvention, cli, networking, pluggable-transport, privacy.
- [mihomo](https://pkg.so/zh-hans/brew/mihomo/) - Shares pkgdb curated category or tags: cli, go, networking, proxy.
- [privoxy](https://pkg.so/zh-hans/brew/privoxy/) - Shares pkgdb curated category or tags: cli, networking, privacy, proxy.
- [dnscrypt-proxy](https://pkg.so/zh-hans/brew/dnscrypt-proxy/) - Shares pkgdb curated category or tags: cli, networking, privacy, proxy.
- [snowflake](https://pkg.so/zh-hans/brew/snowflake/) - Shares pkgdb curated category or tags: censorship-circumvention, cli, networking, pluggable-transport, proxy.
- [simple-obfs](https://pkg.so/zh-hans/brew/simple-obfs/) - Shares pkgdb curated category or tags: cli, networking, obfuscation, proxy.
- [dsocks](https://pkg.so/zh-hans/brew/dsocks/) - Shares pkgdb curated category or tags: cli, networking, proxy, tor.
- [onioncat](https://pkg.so/zh-hans/brew/onioncat/) - Shares pkgdb curated category or tags: cli, networking, privacy, tor.
- [geph4](https://pkg.so/zh-hans/brew/geph4/) - Local package facts share a topical domain. Shared terms: censorship, censorship-circumvention, circumvention, cli, networking.

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