Obfs4-bridge
Obfs4-bridge is a Docker container for running a Tor obfs4 bridge relay, obfuscating Tor traffic so users in censored regions can connect to the Tor network…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
31/100 Low
- Maintained
- 0last commit 1136 days ago
- Popular
- 621,252 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 95512 MB minimum RAM, runs on ARM
- Security check
- 08 serious findings, 3 minor, tests, OpenSSF Scorecard 1.9/10
Security check: 8 serious findings
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
- Uses golang.org/x/crypto v0.14.0, which has a known critical vulnerability (Go)
Automated checks on commit c3e2d44, 26 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 53 days ago
- GitHub stars
- 1,252
- Open issues
- 2
- Last commit
- 2023-10-12
- Activity
- stale
Checked 20 days ago - source: GitHub (Yawning/obfs4)
Resources & Compatibility
Minimum requirements: 512 MB RAM, 1 CPU core(s). ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Port Forwarding & Data Directory Forward both the OR_PORT and PT_PORT through your firewall. Set the OR_PORT (Tor port), PT_PORT (obfs4 port), and EMAIL (contact address) environment variables. The bridge's data directory stores key material and must persist across upgrades; create it and set ownership before first run (Unraid: mkdir /mnt/user/appdata/tor && chown 101:101 /mnt/user/appdata/tor). source
Fetched 37 days ago - each note links to its source
Variants
Alternatives (12)
- Brave Origin - Brave Origin is a self-hosted Brave browser container you can open in a web browser over HTTPS.
- Chromium - Chromium is a LinuxServer.io Docker container that packages the open-source Chromium browser for headless automation, web scraping, and bro…
- Ecosia Browser - Ecosia Browser is the newest product from Ecosia an eco-friendly, fast, ad-free browsing experience that supports reforestation.
- Fifo - Fifo is a fast, free, and secure web browser designed to respect your privacy.
- Google Chrome - Web browser built on an open-source platform featuring multiple account support, integrated password manager, dark mode, real-time translat…
- Helium Browser - Chromium-based browser with preinstalled open-source blockers, default anti-tracking features, no data collection, full extension support,…
- InviZible Pro - InviZible Pro uses DNSCrypt Protocol, Tor and i2pd (I2P Daemon) (PurpleI2P) to achieve maximum security, privacy and comfortable use of the…
- IronFox - IronFox is a fork of DivestOS's Mull Browser based on Firefox.
- Mullvad Browser - Mullvad Browser is a privacy-focused web browser developed in collaboration between Mullvad VPN and the Tor Project.
- Myst - Mysterium Node is a cross-platform decentralized VPN node for hosting or joining the Mysterium Network, a blockchain-based network.
- Opera - Opera is a multi-platform web browser built on the Chromium engine and developed by its namesake company, Opera, that distinguishes itself…
- Orbot - Orbot is a freely licensed open-source application developed for the Android platform.
Checked 40 days ago - source: AlternativeTo
Common questions
How do I deploy the obfs4-bridge container with Docker?
Create a .env file next to the docker-compose.yml file containing OR_PORT, PT_PORT, and EMAIL. Then run docker-compose up -d obfs4-bridge. Make sure both ports are forwarded in your firewall.
Where are the autogenerated obfs4 bridge parameters stored?
They are placed in DataDir/pt_state/obfs4_state.json.
What common issues should I check if the obfs4 bridge is not working?
Check for port binding failures and whether clients are not receiving your bridge's descriptor. Use the relevant log messages to identify the fix.
Answers sourced from anubizhost.com, community.torproject.org, github.com
Community
- Obfs4 bridge configuration - Relay Operator - Tor Project Forum (forum)
- Run Tor service with obfs4 : r/TOR - Reddit (reddit)
- If I use a private obfs4 bridge for my own use of tor is this ... - Reddit (reddit)
- Tor Project | Bridge (other)
- Obfs4 bridged using dual stack. ipv4 and ipv6 - Relay Operator - Tor ... (forum)
- A question about the Obfs4 bridge - Tor Project Forum (forum)
Collected 53 days ago - public community threads