Stowaway - 👻Stowaway -- Multi-hop Proxy Tool for pentesters

项目说明

!stowaway.png

Stowaway

![GitHub issues]()
![GitHub forks]()
![GitHub stars]()
![GitHub license]()

English

Stowaway是一个利用go语言编写、专为渗透测试工作者制作的多级代理工具

用户可使用此程序将外部流量通过多个节点代理至内网，突破内网访问限制，构造树状节点网络，并轻松实现管理功能

谢谢各位的star，同时欢迎大家使用后提出问题&&Bug :kissing_heart:

同时也请各位务必在使用前详细阅读使用方法及文末的注意事项

声明

> 本项目仅供网络安全研究与教学用途，严禁用于任何非法用途。请确保在使用本工具进行任何测试之前，已获得目标系统明确的授权，并严格遵守您所在国家/地区的相关法律法规。
使用本工具所带来的任何直接或间接后果（包括但不限于：数据丢失、系统损坏、法律责任等），由使用者自行承担，本项目作者不对任何滥用行为或由此引发的法律责任负责。
本工具的使用即表示您已阅读、理解并同意本免责声明的全部内容。

特性

编译及演示

使用方法

角色

Stowaway一共包含两种角色，分别是：

名词定义

快速启动

以下命令可以快速启动最简单的stowaway实例

参数解析

参数用法

#### -l

此参数admin&&agent用法一致，仅用在被动模式下

若不指定IP地址，则默认监听在0.0.0.0上

#### -s

此参数admin&&agent用法一致，可用在主动&&被动模式下

可选，若为空，则代表通信不被加密，反之则通信基于用户所给出的密钥加密

#### -c

此参数admin&&agent用法一致，仅用在主动模式下

代表了希望连接到的节点的地址

#### --socks5-proxy/--socks5-proxyu/--socks5-proxyp/--http-proxy

这四个参数admin&&agent用法一致，仅用在主动模式下

--socks5-proxy代表socks5代理服务器地址，--socks5-proxyu以及--socks5-proxyp可选

--http-proxy代表http代理服务器地址,与socks5使用方式相同

无用户名密码：

有用户名密码:

#### --up/--down

这两个参数admin&&agent用法一致，可用在主动&&被动模式下

但注意admin上没有--up参数

这两个参数可选，若为空，则代表上/下游流量为裸TCP流量

若希望上/下游流量为HTTP/WS流量，设置此两参数为http或ws即可

另外需要注意两点：

第一，当你设置了某一节点上/下游为TCP/HTTP/WS流量后，与其连接的父/子节点的下/上游流量必须设置为一致，如下

上面这种情况，agent必须设置--up为ws，否则会导致网络出错

agent间也一样

假设agent-1正在127.0.0.1:10000端口上等待子节点的连接，并且设置了--down ws

那么agent-2也必须设置--up为ws，否则会导致网络出错

第二，由于http是半双工的协议，并不是很适合stowaway全双工的通信性质，所以这里http协议仅实现了http消息格式，并不是完整功能的http工作流，所以你仍然可以使用这个协议，但是stowaway之间的流量在选择以http消息格式传输时无法通过nginx转发，这部分代码及功能保留一方面为了某些特殊情况下http协议的使用，另一方面也提供一个自定义流量的模版，方便用户自定义协议时拿来参考

如需通过nginx等反代，请使用ws协议，并搭配上TLS进行通讯

#### --reconnect

此参数仅用在agent，且仅用在主动模式下

参数可选，若不设置，则代表节点在网络连接断开后不会主动重连，若设置，则代表节点会每隔x(你设置的秒数)秒尝试重连至父节点

上面这种情况下，代表如果agent与admin之间的连接断开，agent会每隔十秒尝试重连回admin

agent之间也与上面情况一致

并且--reconnect参数可以与--socks5-proxy/--socks5-proxyu/--socks5-proxyp/--http-proxy一起使用，agent将会参照启动时的设置，通过代理尝试重连

#### --rehost/--report

这两个参数比较特别，仅用在agent端，详细请参见下方的端口复用机制

#### --cs

此参数仅用在agent，可用在主动&&被动模式下

主要旨在解决'shell'功能乱码问题，当用户将agent运行于控制台编码为gbk的平台上(例如一般情况下的Windows)并且同时admin运行于控制台编码为utf-8的平台上时，请务必将此参数设置为'gbk'

#### --tls-enable

这两个参数admin&&agent用法一致，可用在主动&&被动模式下

通过设置此选项，可以将节点间流量以TLS加密

示例如下

注意，当此参数启用时，aes加密将被默认禁用，-s参数将仅用于节点间相互验证&端口复用功能

另外，当此参数启用时，请保证网络中每一个节点(包括admin)都启用此参数

#### --domain

这两个参数admin&&agent用法一致，仅可用在主动模式下

通过设置此选项，可以设置当前此节点TLS协商时的SNI选项或者WebSocket的目标Host

示例如下

#### --heartbeat

这个参数仅用在admin端，可用在主动&被动模式下

通过设置此选项，可以使admin持续向第一个节点发送心跳包，从而在中间有反向代理的情况下维持长链接

假设admin和agent中有类似nginx的反向代理设备将8080端口代理至8000端口,示例如下

端口复用机制

当前Stowaway提供基于SO_REUSEPORT和SO_REUSEADDR特性的端口复用功能及基于IPTABLES的端口复用功能

复用方式

假设agent端采用端口复用机制复用80端口

此时agent端必须设置--rehost&&--report&&-s参数

- --rehost: 代表希望复用的IP地址，不可为0.0.0.0，普遍应当是网卡的外部地址

- --report: 代表希望复用的端口

- -s: 代表通信密钥

主要支持windows、mac环境下的复用，linux亦可，但限制较多

- admin端：./stowaway_admin -c 192.168.0.105:80 -s 123
- agent端：./stowaway_agent --report 80 --rehost 192.168.0.105 -s 123

假设agent端采用端口复用机制复用22端口

此时agent端必须设置-l&&--report&&-s参数

- -l: 代表无法被正常访问的端口，也就是你真正想让agent监听并接受连接的端口

- --report: 代表希望复用的端口

- -s: 代表通信密钥

仅支持linux环境下的复用，agent会自动修改IPTABLES，需要root权限

- agent端： ./stowaway_agent --report 22 -l 10000 -s 123

在agent启动后，请使用script目录下的reuse.py

先设置SECRET的值(SECRET的值就是在启动各个节点时所设置的通信密钥),

之后执行：python reuse.py --start --rhost xxx.xxx.xxx.xxx --rport xxx

- --rhost: 代表agent的地址

- --rport: 代表被复用的端口,在本例中应当为22

- 此时admin端就可以连接：./stowaway_admin -c 192.168.0.105:22 -s 123

注意

故而为了防止agent异常退出后，iptables规则没有被清理导致被复用的服务无法访问

所以当需要关闭时，需运行：python reuse.py --stop --rhost xxx.xxx.xxx.xxx --rport xxx

即可关闭转发规则，使得原服务能够被正常访问

如何组成多级网络？

从上面的例子可以看到，只有admin和一个agent出场

而多级网络才是核心

在stowaway中，组成多级网络需要借助admin中的listen、connect、 sshtunnel命令来实现

举一个简单的例子

此时agent-1已经连上admin

此时用户还想连接agent-2，如下

那么，此时用户可以通过admin,输入use 0 -> connect agent-2的IP:10000来将其加入网络，并成为agent-1的一个子节点

假如此时用户还希望连入一个节点agent-3，但是通过agent-1无法访问agent-3

那么，此时用户可以通过admin,输入use 0 -> listen -> 选择1.Normal Passive -> 输入10001 从而使得agent-1监听在10001端口上，并等待子节点的连接

等admin操作完成后，agent-3启动如下

就可以将agent-3作为agent-1的另一个子节点加入网络了

关于listen以及sshtunnel的详细介绍，可以参看下方的命令解析

如何重连？

Stowaway当前支持多种方式的重连，简单概括如下

首先，当父节点掉线后，只有一种节点会主动退出，那就是启动时为主动模式且没有设置重连的节点

如果设置了重连，那么节点将会在指定的时间间隔中尝试重连

另外，所有被动模式启动的节点都不会主动退出，而是会基于启动时的参数重新监听在指定端口上，此时用户仍然可以通过connect、sshtunnel来将这些节点连回网络

注意

1. 如因网络波动或中间节点掉线，导致某一个分支断开，在主动重连时请务必连接缺失链的头节点,举个例子，admin后接着node1，node1后分为两支，一支是node1->node 2 -> node 3 -> node 4, 一支是node1->node 5 ->node 6，那么如果node2掉线，node3及node4将不会掉线，而是继续保持存活。此时用户若想将node3及node4重新加入网络，那么用户有两种选择，一种是假如node1可以直接访问node3，那么用户可随时在node1将node3用connect或者sshtunnel命令重新加入网络（切记，就算node1同时也可以访问node4，也请不要直接连接node4，请连接整个缺失链(node3->node4)的头节点node3），这样就可以将node3及node4重新加入网络；另一种选择是当node1无法直接访问node3时（即必须经过node2），那么请先将node2重启并加入网络，之后再在node2上使用connect或者sshtunnel命令连接node3，从而将node3及node4加入网络

2. 当有节点掉线时，那么此时与此节点及其子节点有关的所有socks，backward，forward服务都会被强制停止

命令解析

在admin控制台中，用户可以用tab来补全命令，方向键上下左右来查找历史/移动光标

admin控制台分为两个层级，第一层为主panel，包含的命令如下

当用户使用use命令选择了一个agent后，进入第二层node panel，其包含的命令如下

注意，listen是比较特殊的一个命令，可以看到，listen命令有三种模式

1. Normal passive: 此选项意味着agent将会以普通的方式监听在目标端口，并等待子节点连入
2. IPTables Reuse：此选项意味着agent将会以IPTables Reuse的方式复用端口，并等待子节点连入
3. SOReuse：此选项意味着agent将会以SOReuse的方式复用端口，并等待子节点连入

第一个模式是最普遍使用的，若父节点以这种方式监听，那么子节点仅需要-c 父节点ip:port就可以加入网络

第二个和第三个模式是比较特殊的，若用户选择第二或第三个模式，那么用户必须保证当前操作的节点本身就是以端口复用的方式启动的，否则将无法使用这两个模式

第二和第三个模式将不需要用户输入任何信息，节点将会自动使用其自身启动时的参数来复用端口，并准备接受子节点的连接

另外，listen一次只能接受一个子节点的连入，若需要多个子节点连入，请执行相应次数的listen命令

在此模式下，tab键将被禁止

在此模式下，tab键将被禁止

注意一点，此处的7777端口不是在agent上开启的，而是在admin上开启

若需要设置用户名密码，可将上方命令改为socks 7777 <your username> <your password>

若需要指定监听的接口，可将上方命令改为socks xxx.xxx.xxx.xxx:7777

在严格受限的网络环境下，可以利用ssh隧道的方式来将stowaway的流量伪装为ssh流量，从而避开防火墙的限制

TODO

注意事项

404星链计划

Stowaway 现已加入 404星链计划

致谢

感谢以下师傅和项目在Stowaway开发过程中的帮助

项目信息

开发语言：Go

Star 数：3420

技术要点

该项目属于CTF思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕👻Stowaway -- Multi-hop Proxy Tool for pentesters展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。