Burp suite Extension SocksServerExtension

Language/Japanese

This tool is an extension of PortSwigger product, Burp Suite. Supports Burp suite Professional/Community.

Overview

This extension is a tool that provides a SOCKS5 proxy server. It accepts SOCKS5 client connections and relays them through an upstream HTTP(S) proxy (for example, the Burp Suite proxy listener), allowing tools that only support a SOCKS5 proxy to route their traffic through Burp Suite.

About the latest version

The main repository (main) may contain code under development. Please download the stable release version from the following.

• https://github.com/raise-isayan/SocksServerExtension/releases

Please use the following versions

• Burp suite v2024.2.1.3 or above

How to Use

The Burp Suite Extension can be loaded by following the steps below.

1. Click [add] on the [Extensions] tab
2. Click [Select file ...] and select SocksServerExtension.jar
3. Click [Next], confirm that no error is occurring, and close the dialog with [Close].

Socks Server Tab

SocksServerExtension tab will be added to Burp Suite.

[Start] Button:

Press this button to start the SOCKS4 or SOCKS5 server. Press it again to stop.

listen port:

Specify the port on which the SOCKS4 or SOCKS5 server listens.

redirect port:

Specify the port of the upstream HTTP(S) proxy (for example, the Burp Suite proxy listener) to relay connections to.

redirect host:

Specify the host of the upstream HTTP(S) proxy to relay connections to.

Log

[Extensions] -> [Output]:

Outputs status messages, including server start/stop logs.

[Extensions] -> [Error]:

Outputs error message, including logs of exceptions.

CLI Option

There is a CLI mode that can be launched from the command line.

java -jar SocksServerExtension.jar -h

Usage: java -jar SocksServerExtension.jar [option]
[option]
        -h, --help - help show
        -v, --version - version show
        -gui - GUI Mode
[command]
        -L, --listenport <listenerPort> - Specify the socks listener port
        -P, --redirectPort <redirectPort> - Specify the redirect port
        -H, --redirectHost <redirectHost> - Specify the redirect host
        -T,--socksType <SOCKS4|SOCKS5> - Specify the socks protocol type (default: SOCKS5)

[command (ex)]

java -jar SocksServerExtension.jar -L 10080 -H 127.0.0.1 -P 8080

GUI Option

There is a standalone GUI mode that does not require Burp Suite.

java -jar SocksServerExtension.jar -gui

buid

gradlew release

Runtime environment

.Java

• JRE (JDK) 21 (Open JDK is recommended) (https://openjdk.java.net/)

.Burp suite

• v2024.2.1.3 or higher (http://www.portswigger.net/burp/)

Development environment

• NetBean 30 (https://netbeans.apache.org/)
• Gradle 9.6.1 (https://gradle.org/)

Required Library

Building requires a BurpExtensionCommons library.

• BurpExtensionCommons v3.2.18 or higher

Use Library

• netty (https://github.com/netty/netty)

  • Apache License 2.0
  • https://github.com/netty/netty/blob/4.1/LICENSE.txt

• Bouncy Castle (https://www.bouncycastle.org/)

  • MIT License
  • https://www.bouncycastle.org/licence.html

• slf4j (https://www.slf4j.org/)

  • MIT License
  • https://www.slf4j.org/license.html

Operation is confirmed with the following versions.

• Burp suite v2026.3.3

important

This tool developed by my own personal use, PortSwigger company is not related at all. Please do not ask PortSwigger about problems, etc. caused by using this tool.