tunnel下载 - tunnel源码下载

tunnel

其他类别

1.0.0

下载

隧道

使用 @nwtgck 的管道服务器作为中继的安全、多路复用 TCP/UDP 端口转发器。主要设计用于（多个）NAT/防火墙后面的对等点之间的 p2p 连接。

特征

对等体之间的 TCP/UDP 隧道，每个对等体可能位于（多个）NAT 后面，即无法从公共互联网访问。
防火墙不会造成问题，因为仅使用传出的 http(s) 连接。
安全性：要进行连接，对等点必须知道服务对等点的唯一 ID 和共享密钥。对等点和中继之间的流量经过加密 (TLS)。中继不存储任何内容。
多路复用：每个隧道支持多个并发连接。连接是全双工的。
多对一：转发节点充当客户端，转发节点充当服务器。服务器可以在任何给定时间支持多个客户端。每个节点都可以充当服务器和客户端。
弹性：面对间歇性连接，对等点会自动重新连接。
不需要超级用户权限。
选择托管您自己的中继服务器（轻松且免费）。
KISS：只是一个单一的、小型的、可移植的 shell 脚本。
内置安装程序和更新程序。

命令行

对于IPFS的特殊情况，请参阅下面的#examples。

ID：每个节点都有一个唯一的（base64）ID -

tunnel -i

ID 与硬件（MAC 地址）和环境变量 USER、HOME 和 HOSTNAME 绑定。与您的同行一劳永逸地分享。注意：同一台机器上的两个用户被赋予不同的节点 ID，因为他们的 USER 和 HOME 变量不同。

服务器模式：向与您共享任何秘密字符串的对等方公开您的本地端口 -

tunnel [options] [-u] [-k < shared-secret > ] < local-port >

客户端模式：将您的本地端口转发到对等方公开的本地端口 -

tunnel [options] [-u] [-k < shared-secret > ] [-b < local-port > ] [-I < IP > ] < peer-ID:peer-port >

如果使用-b选项未提供本地端口，则tunnel将使用随机未使用的端口。使用的端口始终在标准输出中报告。

当客户端在笔记本电脑上运行且偶尔连接到服务器所在的 LAN 时， -I选项非常方便。当可以在 LAN 上找到服务器且私有 IP = <IP>时， tunnel将通过 LAN 进行连接。

客户端和服务器必须使用相同的密钥才能相互连接。也可以使用环境变量TUNNEL_KEY传递秘密字符串。使用-k传递的秘密优先。

-u标志表示使用 UDP 而不是默认的 TCP。如果使用，则必须由双方使用。

默认情况下，所有日志都位于 stderr。然而，使用-l <logfile>选项，可以在后台（守护进程模式）启动tunnel ，并将日志转储到<logfile> 。守护进程进程 ID 在启动期间向用户显示，以便他可以随时终止守护进程

tunnel -K < procID >

选项：

有关选项的完整列表，请参阅： tunnel -h

安装和更新

下载：

curl -LO https://raw.githubusercontent.com/SomajitDey/tunnel/main/tunnel

使其可执行：

chmod +rx ./tunnel

然后在系统范围内安装：

./tunnel -c install

如果您没有sudo权限，您可以本地安装：

./tunnel -c install -l

安装后随时更新：

tunnel -c update

依赖性/可移植性

该程序只是一个可执行的bash脚本，依赖于标准GNU工具，包括socat 、 openssl 、 curl 、 mktemp 、 cut 、 awk 、 sed 、 flock 、 pkill 、 dd 、 xxd 、 base64等，这些工具在标准Linux发行版上很容易获得。

如果您的系统缺少任何这些工具，并且您没有从本机软件包存储库安装它所需的sudo权限（例如sudo apt-get install <package> ），请尝试下载便携式二进制文件并在本地安装它${HOME}/.bin 。

示例

SSH ：

对等点 A 公开本地 SSH 端口 -

tunnel -k " ${secret} " 22

对等点 B 连接 -

tunnel -b 67868 -k " ${secret} " -l /dev/null " ${peerA_ID} :22 " # Daemon due to -l
ssh -l " ${login_name} " -p 67868 localhost

IPFS ：

让对等点 A 具有 IPFS-peer-ID: 12orQmAlphanumeric 。她的 IPFS 守护进程侦听默认 TCP 端口 4001。她使用 - 公开它

tunnel -k " ${swarm_key} " ipfs

swarm_key只是对等点 A 可以用来控制谁可以使用tunnel swarm 连接到她的任何秘密字符串。

对等点 B 现在与对等点 A 连接以进行文件共享、pubsub 或 p2p -

tunnel -k " ${swarm_key} " 12orQmAlphanumeric

最后一个命令 swarm 通过管道服务器中继连接到对等点 A，并在后台每隔几秒保持 swarm 连接以保持连接处于活动状态。

tunnel会在后台启动 IPFS 守护进程（如果尚未激活）。

IPFS 存储库的路径可以使用选项-r传递。否则，照常使用环境变量IPFS_PATH或默认路径~/.ipfs 。示例： tunnel -r ~/.ipfs -i给出 IPFS 对等 ID。

远程外壳：

假设您经常需要从家用计算机在工作场所的 Linux 机器上启动命令。由于某种原因，您不想/不能通过tunnel使用 SSH。

在工作场所计算机上，公开一些随机的本地 TCP 端口，例如 49090 并将 shell 连接到该端口：

tunnel -l " /tmp/tunnel.log " -k " your secret " 49090 # Note the base64 node id emitted
socat TCP-LISTEN:49090,reuseaddr,fork SYSTEM: ' bash 2>&1 '

回到你家：

tunnel -l " /dev/null " -b 5000 -k " your secret " " node_id_of_workplace:49090 "
rlwrap nc localhost 5000

使用 rlwrap 不是必需的。但它确实让体验更加甜蜜，因为它使用 GNU Readline 并记住输入历史记录（可以使用向上/向下箭头键访问，类似于本地 bash 会话）。

雷迪斯：

需要连接到由同行或您自己托管的远程 Redis 实例？在远程主机上，使用tunnel公开redis-server运行的TCP端口（默认：6379）。

在本地计算机上，使用tunnel将 TCP 端口转发到远程端口。将您的redis-cli指向转发的本地端口。

应用领域

以下是我能想到的一些tunnel的随机用例。从广义上讲，任何涉及 NAT/防火墙穿越（例如不带 TURN 的 WebRTC）或加入远程 LAN 的内容都应该发现tunnel很有用。以下一些想法相当粗略，根本没有经过测试，并且可能行不通，但至少暂时记录在这里，只是为了获得灵感。如果您发现这些有用或无用，或者您发现了tunnel的全新应用程序，请在讨论中发帖。我测试过的那些案例被标记为“工作”。

连接到 IPFS 对等点（工作）。
P2P 聊天、邮件、VoIP、流媒体、游戏、屏幕共享、文件共享、赌博、故障排除等等。
连接物联网设备。
使用 SSH（工作）、RDP 或 VNC 将工作站与家用计算机或笔记本电脑连接。
铲壳（工作）。
使用自托管或同行提供的 VPN 突破防火墙。
通过互联网从家里加入内部网办公室聊天（通过办公室 LAN）。例如，BeeBEEP 和 LAN Messenger 可能使用已使用tunnel从办公室内的节点转发到的本地端口。
P2P（无服务器）音频/视频。例如，将本地 TCP/UDP 端口转发到对等点的本地主机，并将您的 p2p 客户端指向它。现成的 FOSS：Jami、Jitsi、Toxchat 和 Retroshare。
使用 Teamviewer 或 Anydesk 进行无服务器远程控制。将本地端口（例如 6000）转发到对等方的本地 TCP 端口 5938（对于 TV）和 7070（对于 Anydesk），并使用127.0.0.1:6000作为对等方的IP:port元组。
使本地（Web）端口可公开访问，也称为可从互联网访问的反向代理：只需在 Heroku 上运行tunnel （免费）并将存储在环境变量PORT中的端口转发到您想要公开的本地端口。您的公共 URL 为：https://your-app-name.herokuapp.com。
使用通用网络摄像头适配器访问远程 IP 网络摄像头的源：将本地端口转发到可以通过 WLAN 访问移动摄像头的远程节点。
使用 VLC 进行流式传输：电影和音乐、网络摄像头 [命令行]。只需使用tunnel连接服务器和客户端即可。

安全

如果中继使用 https， tunnel会使用 TLS 加密对等方与中继之间的所有流量。对等点之间本身不存在端到端加密。然而，管道服务器中继据称是无存储的。

仅当客户端使用相同的密钥 (TUNNEL_KEY) 时，客户端才能与服务对等点连接。密钥主要用于中继阶段的对等发现。对于转发的本地端口的每个新连接，客户端都会向服务对等方发送随机会话密钥。然后，对等方基于此随机密钥在另一个中继点形成新连接，以进行实际的数据传输。局外人，即。不知道 TUNNEL_KEY 的坏人应该无法破坏此流程。

但是，恶意对等方可以执行以下操作。因为他知道服务对等体的 TUNNEL_KEY 和节点 ID，所以他可以模拟后者。因此，来自毫无戒心的连接对等方的数据将被转发给模仿者，从而使真正的服务器陷入饥饿。 tunnel的未来更新/实现应该使用公钥加密来处理这种威胁。 [在这种情况下，为每个要转发的新连接生成的随机会话密钥将可由真正的服务器单独解密]。

鉴于tunnel本质上是传输层，以上几点不应令人沮丧，因为大多数应用程序（例如 SSH 和 IPFS）都是在应用层加密数据。对所有数据传输进行端到端加密tunnel只会增加延迟。但是，如果您选择的话，您始终可以在使用tunnel建立低级对等互连后创建 SSH 隧道。

中继

tunnel使用的默认中继是 https://ppg.io。您还可以使用此列表中的其他一些公共中继，或者在免费服务（例如 Heroku 提供的服务）上托管您自己的实例。不用说，要连接，两个对等点必须使用相同的中继。

如果您愿意，您还可以使用 sertain 等简单工具编写自己的中继以供tunnel使用。只需确保您的中继服务具有与管道服务器相同的 API。如果您的中继代码是开源的，非常欢迎您在讨论中介绍它。

参见

gsocket;启用电路中继的 ipfs p2p ； go-管道-双工；管道.me;上行链路；本地主机.运行;恩格罗克；本地隧道； sshreach.me（仅限限时免费试用）；更多的

笔记：

与管道服务器不同，其中大多数不提供简单、免费的最重要的中继或反向代理的自托管。如果这些服务出现故障，你就完蛋了。然而，使用tunnel和管道服务器，您可以简单地部署自己的中继实例，一劳永逸地与您的同行共享其公共 URL， export与.bashrc内的TUNNEL_RELAY相同的内容，然后就可以开始了。此外，多个公共管道服务器可用于冗余。
其中一些服务在免费层中为每个会话提供一个新的随机公共 URL，这对于间歇性连接（例如在物联网应用程序中）来说是有问题的。即使连接不空闲，某些免费计划也会在一定时间后使会话过期。
有些仅针对网络流量公开您的本地端口。通过 HTTP 传输非 Web 协议的责任由您和您的同事承担。

未来方向

IPFS（完成）：

连接到 IPFS 会简单得多：

tunnel -k <secret> ipfs用于公开， tunnel -k <secret> <IPFS_peerID>用于连接。

如果离线，它们将自行启动 IPFS 守护进程。后一个命令将以 30 秒的间隔重复集群连接到给定的对等点。 IPFS-peer-ID 将用作节点 ID，因此对等点不再需要单独共享其节点 ID。非默认 IPFS 存储库路径可以使用选项-r传递。或IPFS_PATH 。

SSH：

在本地端口和对等端口之间创建 SSH 隧道非常简单：

tunnel -k <secret> ssh公开 &

tunnel -sk <secret> -b <local-port> <peerID>:<peer-port>创建。

请注意，连接时不再需要提供登录名。默认以服务节点的${USER}作为登录名。但是，如果需要，始终可以使用环境变量或选项传递非默认登录名。

GPG：

虚拟机（例如云外壳和测功机使用的虚拟机）没有持久的、唯一的硬件地址。因此，对于此类 VM，节点 ID 在会话之间不断变化。未来的tunnel将有一个-g选项，它将 GPG 私钥传递给tunnel 。节点 ID 将从该密钥的指纹生成，类似于 IPFS 的做法。这也将使tunnel更加安全。

氩气2：

选项 [ -a ] 在使用前使用 argon2 对 TUNNEL_KEY 进行哈希处理，这样较弱的秘密就不会太容易受到攻击。