code-scan starred Stowaway
2021-04-07 13:31:43 Author: github.com(查看原文) 阅读量:132 收藏

stowaway.png

GitHub issues GitHub forks GitHub stars GitHub license

English

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

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

PS:谢谢大家的star，同时欢迎大家使用后提出问题 😘。

PPS:请在使用前详细阅读使用方法及文末的注意事项！

PPPS:本项目的2.0版本正在积极重构中，敬请期待～

此工具仅限于安全研究和教学，用户承担因使用此工具而导致的所有法律和相关责任！ 作者不承担任何法律和相关责任！

特性

  • 一目了然的节点树管理
  • 丰富的节点信息展示及长久保存
  • 节点间正向/反向连接
  • 节点间可通过socks5代理进行反向连接
  • ssh隧道连接
  • 多平台适配
  • 多级socks5流量代理转发(支持UDP/TCP,IPV4/IPV6)
  • ssh代理连接
  • 远程交互式shell
  • 上传及下载文件
  • 端口本地/远程映射
  • 端口复用
  • 自由开关各类服务
  • 节点间相互认证
  • 节点间流量以AES-256(CBC模式)进行加密

下载及演示

  • 不想编译的盆油可以直接用release下编译完成的程序.其中Uncompressed 是未经压缩的程序合集，若需要更小体积的程序合集以此方便上传至服务器，请下载Compressed
  • 演示视频：Youtube

使用方法

角色

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

  • admin 渗透测试者使用的主控端
  • startnode 入口节点
  • node 普通节点

startnode与node节点启动参数几乎完全一致，两者参数区别请详细查看下方的例子

举个栗子

  • 第一种情况： admin端监听，等待startnode连接

    • admin端：./stowaway_admin -l 9999 -s 123

      命令解析：

   -l 参数代表监听端口(监听在0.0.0.0)

   -s 参数代表节点通信加密密钥(admin端与所有node必须一致!)

    • startnode端： ./stowaway_agent -c 127.0.0.1:9999 -l 10000 --startnode -s 123 --reconnect 5

      命令解析：

   -c 代表上一级节点的地址

   -l 代表监听端口(也可同时指定监听的ip,形如192.168.0.1:9999，如果不指定ip，默认监听0.0.0.0;如果暂时不需要监听，也可直接省略-l选项,后续如果需要开启，可参见listen命令的用法)

   -s 参数代表节点通信加密密钥

   --startnode 代表此节点是startnode（注意，一个网络中有且仅有一个startnode，且startnode必须加上--startnode）

   --reconnect 代表startnode将在admin下线后主动尝试不断重连（此例子中为每5秒重连一次）注意：若需要重连功能，只需要在startnode使用此参数即可，node无需此参数

    • 此时若后续的node希望以passive模式启动

      后续node启动命令为：./stowaway_agent -l 10001 -s 123 -r

         命令解析：

      -r 代表以passive模式启动（即本节点等待上一级节点的主动连接，若正向连接可以去除此选项）

      -l 同上

      此时在admin端输入命令use 1-->connect 127.0.0.1:10001即可将后续节点加入网络

    • 若后续node希望以active模式启动

      后续node启动命令改为：./stowaway_agent -c 127.0.0.1:10000 -s 123 即可

      其余node同理

  • 第二种情况：admin端主动连接startnode端

    • admin端: ./stowaway_admin -s 123 -c 127.0.0.1:9999

      命令解析：

   -s 同上

   -c 代表startnode所在的地址

    • startnode端: ./stowaway_agent -l 9999 -s 123 --startnode -r

      命令解析：

   -l，-s ，--startnode同上

   -r/--reverse：代表此节点以passive模式启动

      后续node同第一种情况中的node启动方法一致

      下一次想要重连时，再次执行./stowaway_admin -s 123 -c 127.0.0.1:9999，即可重建网络

SOCKS5代理连接机制

Stowaway可以通过socks5代理进行节点间的反向连接

需要用到以下三个参数--proxy,--proxyu, --proxyp

简单示例

假设有一台socks5服务器A,ip为6.6.6.6，代理端口为1080，用户名为ph4ntom，密码为just4fun

startnode需要通过A服务器与admin相连接,admin部署在7.7.7.7上，startnode的内网地址为192.168.0.200

admin端: ./stowaway_admin -l 9999 -s 123

startnode端: ./stowaway_agent -c 7.7.7.7:9999 --startnode -s 123 -l 10000 --proxy 6.6.6.6:1080 --proxyu ph4ntom --proxyp just4fun

此时如果内网有一台socks5服务器B,ip为192.168.0.2，代理端口为1080，无用户名密码

有一个新的子节点希望通过B连接到startnode节点

node端: ./stowaway_agent -c 192.168.0.200:10000 -s 123 --proxy 192.168.0.2:1080

以上

端口复用机制

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

  • 在linux下可以大部分的功能端口

  • 在windows下不可复用iis，rdp端口，可以复用mysql，apache服务的端口

  • nginx在默认状态下不可复用

复用方式

  • SO_REUSEPORT和SO_REUSEADDR模式

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

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

    • admin端：./stowaway_admin -c 192.168.0.105:80 -s 123 --rhostreuse

      命令解析：

   -c/-s 同上，不再赘述

   --rhostreuse 此选项被设置时，代表需要连接的节点正在端口复用的模式下运行(如果被连接的节点处于端口复用模式，必须设置此选项)

    • startnode端： ./stowaway_agent -s 123 --startnode --report 80 --rehost 192.168.0.105

      命令解析：

   -s/--startnode 同上

   --report 代表需要被复用的端口

   --rehost 代表复用端口时需要监听的本机ip（不可用0.0.0.0）

      如果后续有node想要连接startnode,则node命令为: ./stowaway_agent -s 123 -c 192.168.0.105:80 --rhostreuse

  • IPTABLES模式

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

    仅支持linux环境下的复用，需要root权限

    此复用不是纯粹的“复用”，主要是靠设置iptables规则，使得流量在路由决策之前被处理，从而将流量从目标“report”导向“listenport(-l)”，递交给agent端进行处理分发，实现某种意义上的端口“复用”

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

      命令解析：

   -s/--startnode/--report同上

   -l 代表复用端口时需要监听的端口（渗透测试者所有访问report端口的流量将会导向这个端口）

      在startnode启动后，使用script目录下的reuse.py,先设置SECRET的值(SECRET的值就是在启动各个节点时所设置的通信密钥，即-s选项),之后打开复用：python reuse.py --start --rhost 192.168.0.105 --rport 22

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

      命令解析：

   -c/-s/--rhostreuse 同上，不再赘述

    如果后续有node想要连接startnode: ./stowaway_agent -s 123 -c 192.168.0.105:22 --rhostreuse

注意

  • 如果startnode被ctrl-c或者kill命令杀死，程序将会自动清理iptables规则，但如果被kill -9 杀死，则无法自动清除

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

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

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

  • 如果使用IPTABLES模式下的端口复用模式，将会强制监听在0.0.0.0，无法由-l参数来指定ip+port

几个值得注意的点

  1. 除了admin节点以外，普通的agent以及startnode节点可以被多个agent端连接，以组成树状网络

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

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

示例

一个简单的例子：

  • admin端：

admin

  • startnode端：

startnode

  • 第一个Node(设置为反向连接模式)：

node

此时，进入(use命令，本例中为use 1）此节点的上级节点（即startnode），利用命令connect 127.0.0.1:10001 即可将此反向模式节点加入网络

  • 命令startnode监听端口，接受后续节点的连接

node

listen命令可使当前节点监听指定的端口，并在此端口上接受后续节点的连接,格式为listen <ip:>port,如果ip不指定，默认监听0.0.0.0

  • 第二个Node：

node

  • admin端查看节点拓扑：

node

  • admin端查看节点详细信息：

node

  • 为此节点设置备忘：

node

备忘在设置之后，只要被设置备忘的节点没有掉线，那么哪怕admin掉线，一旦admin成功重连回网络，所有备忘就可以自动恢复，不用担心丢失备忘的情况。

  • 为此节点删除备忘：

node

  • 此时在admin端操控第二个node节点：

node

  • 打开远程shell：

node

此时就可以在admin端操纵第二个node的shell

  • 打开socks5代理：

node

此时用户即可以将admin端的7777端口作为socks5代理端口，将流量代理至第二个node节点

如果需要设置socks5用户名密码，例如需要设置用户名为ph4ntom，密码为11235，则可将输入命令改为socks 7777 ph4ntom 11235(PS：切勿在用户名以及密码中使用冒号）

  • 关闭socks5代理：

node

  • 打开ssh：

node

此时第二个node会作为ssh客户端发起ssh连接来访问指定的ssh服务，并将ssh数据回传至admin端(arm以及mipsel客户端不支持此功能)

PS: 在ssh模式下，你可以用pwd来判断自己所处的文件夹（好吧，其实就是没法把banner传回来。。）

  • 此时若还有节点需要加入网络，可使用sshtunnel命令：

node node

此时将可以利用sshtunnel将节点加入网络，这一方法适用于当防火墙做了流量限制，只有ssh流量能够通过的情况.一般情况下推荐使用connect命令即可，不需要使用sshtunnel.(arm以及mipsel客户端不支持此功能)。

  • 上传/下载文件：

node

node

上传下载功能命令为 upload/download 后加文件路径,此时就可以上传文件至指定节点/下载指定节点的文件(注意，同时只能传输一个文件，请务必等之前一个传输完成再进行下一步操作)

  • 本地端口映射至远程端口

node node

此时连接127.0.0.1的8888端口，就相当于连接至127.0.0.1的22端口（本地映射至远程）

  • 如果不想forward了，可以关闭

node

  • 远程端口映射至本地

node node

此时外部访问127.0.0.1的80端口，就相当于访问127.0.0.1的22端口（远程映射至本地）

  • 如果不想reflect了，可以关闭

node

  • 如果想让节点主动下线，可以输入offline来强制命令节点下线

具体命令使用可输入help查询

TODO

  • 节点间通信流量加密
  • 加强功能健壮性，解决了因为节点掉线、误操作带来的程序及网络崩溃
  • 对可使用的各项功能同时提供开启/关闭操作
  • 自动重连功能
  • 清理代码，优化逻辑
  • 节点反向连接
  • 端口映射
  • 支持端口复用
  • 避免了同类程序所出现的内存泄露问题在本程序上出现

注意事项

  • 此程序仅是闲暇时开发学习，结构及代码结构不够严谨，功能可能存在bug，请多多谅解
  • 本程序编译出来稍微有一些大，但是实测实际占有内存空间并不大，仅会比尽量压缩文件大小的情况下多出0.5m左右（在macos上大概一共占用5-7m内存空间）
  • upx压缩后的文件虽然变小很多，方便上传，但实际上在使用中所占据的内存会比原版未压缩文件更大一些，故而可根据目标实际情况来选择upx压缩版或者未压缩版
  • admin不在线时，新节点将不允许加入
  • 本程序仅支持标准的基于RFC1928所阐述的UDP ASSOCIATE(即支持UDP代理)，请在使用socks5 udp代理时注意您所使用的程序(例如扫描器等)，包构造方式必须遵守标准的RFC1928，并且需要自行处理丢包状况。
  • 如需从源代码编译本项目，请运行build_admin.sh/build_agent.sh文件来编译对应类型的Stowaway(注意！！！！！！默认编译的是agent模式，此时请运行build_agent.sh,如需编译admin，请查看main.go文件中的提示，按照提示进行操作后，运行build_admin.sh文件)

致谢


文章来源: https://github.com/ph4ntonn/Stowaway
如有侵权请联系:admin#unsafe.sh