# 使用 Homebrew, Nix, pacman 安装 tuntox

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

## 安装

```sh
sudo av install brew:tuntox
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install tuntox
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#tuntox
```

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

- pacman (92%):

```sh
sudo pacman -S tuntox
```

  证据: Arch Linux sync databases: tuntox from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## 软件包事实

- **软件包键:** brew:tuntox
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/tuntox>
- **版本:** 0.0.10.1
- **来源摘要:** Tunnel TCP connections over the Tox protocol
- **主页:** <https://gdr.name/tuntox/>
- **仓库:** <https://github.com/gjedeer/tuntox>
- **上游文档:** <https://gdr.name/tuntox/>
- **许可证:** GPL-3.0-only
- **源码归档:** <https://github.com/gjedeer/tuntox/archive/refs/tags/0.0.10.1.tar.gz>
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- tuntox (cli)
- tuntox (别名)

## 依赖

- toxcore

## 构建依赖

- cscope
- pkgconf

## 安装行为

- 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.10.1
- 本地数据: OK
- 上游仓库: https://github.com/gjedeer/tuntox
- 信息: No package-manager update timestamp was available.
- 信息: No cached GitHub release or tag data was available.
## 项目历史与用法

tuntox is a small command-line networking tool for forwarding TCP connections over the Tox peer-to-peer protocol, aimed at reaching machines behind NAT or dynamic addresses without router port forwarding.

### 项目历史

The project appeared publicly in December 2014 in the official GitHub repository. Its README framed it as early work in progress and described a single binary that can run in either server or client mode, with the server publishing a Tox ID and the client forwarding local ports to services behind that Tox identity.

The early releases developed the core tunneling workflow and added shared-secret authentication by version 0.0.4. Later official releases continued into 2021, while the README and FAQ kept the focus on practical NAT traversal, SSH-style local forwarding, and operational cautions around Tox connectivity and security.

### 采用历史

tuntox stayed niche but was packaged beyond Homebrew. The supplied package metadata lists Homebrew, Nix, and Arch pacman entries, and the official FAQ lists additional distribution packaging such as Arch, Homebrew, NixOS, Pentoo, Void, and work-in-progress Debian packaging.

### 使用方式

A typical use is to run `tuntox` on a remote laptop, home machine, or Raspberry Pi behind NAT, save its Tox identity under `/etc/tuntox/` or a `-C` directory, and connect from another machine with an SSH-like `-L` forwarding rule.

Package-manager users mostly encounter it as a tiny tunnel binary: install it, run the server without root, then use local port forwarding or SSH `ProxyCommand` mode to reach a private service over the Tox overlay.

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

For package nerds, tuntox is interesting less as a mainstream remote-access product and more as a packaged example of the Tox ecosystem being used as infrastructure: a peer-to-peer overlay repurposed for TCP forwarding, NAT traversal, and occasional Tor/proxy-aware experiments.

### 时间线

- 2014: GitHub repository created and 0.0.1 initial release published.
- 2015: 0.0.4 release introduced the shared-secret security mode documented in the README.
- 2018: FAQ documented relay-versus-UDP behavior and distro packaging status.
- 2021: 0.0.10 release published.

### Related projects

- Tox
- c-toxcore
- uTox
- OpenSSH local port forwarding

### 来源

- GitHub API for gjedeer/tuntox: repository created 2014-12-11 and releases 0.0.1 through 0.0.10.
- <https://github.com/gjedeer/tuntox README: TCP forwarding over Tox, NAT-traversal use case, server/client mode, `/etc/tuntox/`, `-C`, `-L`, ProxyCommand, and security notes.>
- <https://github.com/gjedeer/tuntox/blob/master/FAQ.md FAQ: Tox relay behavior, proxy/Tor support, Docker notes, and distribution package list.>
- source_facts.package-manager: Homebrew, Nix, and pacman package-manager presence.


## 安全说明

narrow executable package without higher-risk signals.

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


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


## Credential files

- Unix: /etc/tuntox/, directory passed with -C
## 源数据库详情

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

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

- Nix - tuntox: normalized package name match | nixpkgs package indexes: pkgs/by-name/tu/tuntox/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman - tuntox - 0.0.10.1-2: normalized package name match | Arch Linux sync databases: tuntox from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Tunnel TCP connections over the Tox protocol | https://github.com/gjedeer/tuntox


## 相关链接

- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow 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.
- [toxcore](https://pkg.so/zh-hans/brew/toxcore/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://pkg.so/zh-hans/brew/pkgconf/) - Build dependency declared by Homebrew.
- [cscope](https://pkg.so/zh-hans/brew/cscope/) - Build dependency declared by Homebrew.
- [rathole](https://pkg.so/zh-hans/brew/rathole/) - Shares pkgdb curated category or tags: cli, nat-traversal, networking, tunneling.
- [openiothub-server](https://pkg.so/zh-hans/brew/openiothub-server/) - Shares pkgdb curated category or tags: cli, nat-traversal, networking, tunneling.
- [pwnat](https://pkg.so/zh-hans/brew/pwnat/) - Shares pkgdb curated category or tags: cli, nat-traversal, networking, tunneling.
- [openvpn](https://pkg.so/zh-hans/brew/openvpn/) - Shares pkgdb curated category or tags: cli, networking, tunneling.
- [sshuttle](https://pkg.so/zh-hans/brew/sshuttle/) - Shares pkgdb curated category or tags: cli, networking, tunneling.
- [wireguard-tools](https://pkg.so/zh-hans/brew/wireguard-tools/) - Shares pkgdb curated category or tags: cli, networking, tunneling.
- [miniupnpc](https://pkg.so/zh-hans/brew/miniupnpc/) - Shares pkgdb curated category or tags: cli, nat-traversal, networking.
- [transmission-cli](https://pkg.so/zh-hans/brew/transmission-cli/) - Shares pkgdb curated category or tags: cli, networking, p2p.

## Combined YAML source

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


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph