# Installer tun2proxy avec Homebrew, Nix

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

## installation

```sh
sudo av install brew:tun2proxy
```

Commandes d'installation supplémentaires:

### macOS

- Homebrew (100%):

```sh
brew install tun2proxy
```

  Preuve: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#tun2proxy
```

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

## Faits du paquet

- **Clé du paquet:** brew:tun2proxy
- **Gestionnaire de paquets:** Homebrew
- **Version:** 0.8.3
- **Résumé source:** Tunnel (TUN) interface for SOCKS and HTTP proxies
- **Page d'accueil:** <https://github.com/tun2proxy/tun2proxy>
- **Dépôt:** <https://github.com/tun2proxy/tun2proxy>
- **Dernière mise à jour:** 2026-07-23T03:45:27Z
- **Généré:** 2026-08-03T19:37:03+00:00

## exécutables

- tun2proxy-bin (alias)
- udpgw-server (alias)

## Comportement d'installation

- Bouteille: non disponible

## Version et fraîcheur

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

tun2proxy is a Rust networking tool that exposes a tunnel interface for routing traffic through HTTP and SOCKS proxies on Linux, Android, macOS, iOS, and Windows. It sits in the niche between VPN-style TUN devices and ordinary application-level proxy settings.

### Historique du projet

The README presents tun2proxy as a cross-platform TUN interface for HTTP and SOCKS proxies, with support for SOCKS4, SOCKS4a, SOCKS5, SOCKS5h, HTTP proxy authentication modes, IPv4, IPv6, UDP handling, virtual DNS, DNS-over-TCP proxying, UdpGW, Android per-app routing metadata, and automated setup.

The project has evolved toward operational deployment rather than only library use. Official documentation covers building Apple XCFrameworks, installing binaries from GitHub releases, installing from source with cargo, verifying release artifacts through GitHub build provenance attestations since v0.2.23, and running tun2proxy as a Docker sidecar for other containers.

### Historique d'adoption

Official installation paths include GitHub release binaries and `cargo install tun2proxy`; the input package facts record Homebrew and Nix packages. That mix is typical for lower-level networking tools: source builds for Rust users, binary releases for operators, and package-manager formulas for workstation or server bootstrap.

The README's Docker and Docker Compose examples show adoption beyond interactive CLI use. The documented pattern is to run tun2proxy with NET_ADMIN and /dev/net/tun, then share the resulting network namespace with another container, similar to a sidecar proxy pattern.

### Modes d'utilisation

Users provide a proxy URL with `--proxy`, optionally create or name a TUN interface with `--tun`, use `--setup` to configure routing automatically, and choose DNS handling with `--dns direct`, `--dns over-tcp`, or `--dns virtual`. Manual setup examples route broad IPv4 and optional IPv6 ranges through tun0 while bypassing the proxy server itself to avoid routing loops.

For Android 10+ per-app routing, the README documents embedding protocol, source IP, and source port into the SOCKS5 username field by appending `+info` to the username. For container workflows, tun2proxy can become the network namespace provider for another container.

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

tun2proxy is significant to package nerds because it solves a classic mismatch: many programs obey system routes or TUN devices, while many cheap or specialized proxy providers expose only HTTP or SOCKS endpoints. A package-installable tun2proxy lets users turn a proxy URL into something that looks closer to a VPN path.

Its appeal is strongest among users who understand TUN devices, routing tables, DNS leaks, Docker namespaces, Wintun, and SOCKS variants. That makes it a very package-nerd package: obscure in general app catalogs, but useful in reproducible network stacks and privacy, testing, mobile, or proxy-routing setups.

### Chronologie

- Current README: Documents cross-platform support for Linux, Android, macOS, iOS, and Windows.
- v0.2.23 and later: README documents GitHub build provenance attestations for release artifacts.
- Current README: Documents Docker and Docker Compose sidecar-style usage.

### Related projects

- Wintun is named by the README as a Windows runtime requirement when installing from cargo.
- SOCKS4, SOCKS4a, SOCKS5, SOCKS5h, HTTP proxies, UdpGW, Docker, and GitHub artifact attestations are part of the documented operational context.
- dnsproxy is mentioned as an optional companion when direct DNS handling needs another TCP-capable resolver.

### Sources

- <https://github.com/tun2proxy/tun2proxy README: project description, supported platforms, proxy protocols, DNS modes, setup, CLI, Docker, installation, attestations.>
- <https://github.com/tun2proxy/tun2proxy/wiki: official additional documentation linked from README.>
- input source_facts.package-manager: Homebrew and Nix package coverage.


## Notes de sécurité

Aucun manifest local de gestion des secrets correspondant n'a été trouvé pour tun2proxy. Les métadonnées de paquet Nucleus restent publiées ici afin que la couverture future dispose d'une URL stable.


## Autres enregistrements de gestionnaires de paquets

- Nix - tun2proxy: normalized package name match | nixpkgs package indexes: pkgs/by-name/tu/tun2proxy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/tun2proxy.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tun2proxy.yml)


## Sources

- 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