# 使用 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
- **版本:** 0.0.10.1
- **来源摘要:** Tunnel TCP connections over the Tox protocol
- **主页:** <https://gdr.name/tuntox/>
- **仓库:** <https://github.com/gjedeer/tuntox>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- tuntox (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

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
## 其他软件包管理器记录

- 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


## 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
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph