MCPcopy Index your code
hub / github.com/d3mondev/burp-vps-proxy

github.com/d3mondev/burp-vps-proxy @v1.0.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.0.0 ↗ · + Follow
105 symbols 218 edges 11 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Burp VPS Proxy: Easy Cloud Proxies for Burp Suite

Getting Started » Features · Providers · Disclaimers # 📖 About Burp VPS Proxy is a BurpSuite extension that allows for the automatic creation and deletion of upstream SOCKS5 proxies on popular cloud providers from within BurpSuite. It automatically configures Burp to use the created proxy so that all outbound traffic comes from a cloud IP address. This is useful to prevent our main IP address from being blacklisted by popular WAFs while performing penetration testing and bug bounty hunting. Burp VPS Proxy was inspired by @honoki's awesome [DigitalOcean Droplet Proxy for Burp Suite](https://github.com/honoki/burp-digitalocean-droplet-proxy) idea. # 🛠 Features * Automatic creation, configuration and deletion of upstream SOCKS5 proxy on popular cloud services from within BurpSuite. * Support for multiple providers: AWS, Digital Ocean and Linode. * Each provider has its unique settings, including region selection. * Automatic destruction of proxy when closing Burp or unloading the extension, with an option to preserve the proxy across sessions instead. * Restores SOCKS5 proxy settings in Burp to their original values when the proxy is destroyed. * Compatibility across multiple devices, ensuring seamless use without interference from proxies generated on separate computers. # 🔎 How to use Visit the [release page](https://github.com/d3mondev/burp-vps-proxy/releases) and download the latest `burp-vps-proxy.jar` file. In BurpSuite, visit the Extensions tab and click Add. Set the extension type to Java, and select the `burp-vps-proxy.jar` file. Once loaded, access the extension via the new VPS Proxy tab in Burp. Select your provider, set your API keys and click Deploy. # 🌐 Providers ## Amazon Web Services (AWS) ![](assets/providers-aws.png) The extension will use the `t4g.nano` instance type to minimize costs. Note that not all regions support this instance type. The extension will also create a security group named `burp-vps-proxy` in the region selected to allow connections to port 1080. You will need an AWS Access Key and AWS Private Key in order to configure the extension. You'll also need to ensure the key pair gives access to at least the following permissions:
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EC2Permissions",
            "Effect": "Allow",
            "Action": [
                "ec2:RunInstances",
                "ec2:TerminateInstances",
                "ec2:DescribeInstances",
                "ec2:DescribeImages",
                "ec2:DescribeRegions",
                "ec2:CreateTags",
                "ec2:CreateSecurityGroup",
                "ec2:DescribeSecurityGroups",
                "ec2:AuthorizeSecurityGroupIngress"
            ],
            "Resource": "*"
        }
    ]
}
## Digital Ocean ![](assets/providers-do.png) Digital Ocean is a popular VPS provider among security researchers, pentesters and bug bounty hunters. If you don't already have an account, you can get a $200 in free credits by using my referral link to signup: [![DigitalOcean Referral Badge](https://web-platforms.sfo2.digitaloceanspaces.com/WWW/Badge%203.svg)](https://www.digitalocean.com/?refcode=e4681a7c61c6&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge) You will need to create an API key and enter it in the Burp VPS Proxy extension. Provisioning can take some time after the droplet is created. Wait a few minutes after the instance is up. ## Linode ![](assets/providers-linode.png) You will need to create an API key and enter it in the Burp VPS Proxy extension. This is done in the "My Settings -> API Tokens" section of your profile in your Linode dashboard. They call it a Personal Access Token. Ensure the API key has the Read/Write permission for "Linodes". Provisioning is done via SSH and the proxy is usually available as soon as the extension tells you. # ⚖ Disclaimers & License The author and contributors of this extension expressly disclaim any liability for any costs, damages, or consequences resulting from the use of cloud providers in connection with this software. Using this program for unauthorized or illegal activities, including attacking targets without consent, is strictly prohibited. Users must comply with all applicable laws and regulations. The developer and contributors assume no liability or responsibility for any misuse, damage, or harm caused by this software. It is the user's responsibility to utilize this program in an ethical and lawful manner. This repository's content is licensed under the GNU General Public License v3.0 (GPLv3).

Core symbols most depended-on inside this repo

log
called by 15
src/vpsproxy/Logger.java
getCallbacks
called by 9
src/vpsproxy/VPSProxy.java
generate
called by 8
src/vpsproxy/RandomString.java
log
called by 8
src/vpsproxy/providers/Provider.java
saveSetting
called by 6
src/vpsproxy/providers/AWSProvider.java
logf
called by 6
src/vpsproxy/providers/Provider.java
getPassword
called by 5
src/vpsproxy/ProxySettings.java
getSelectedProvider
called by 5
src/vpsproxy/VPSProxyTab.java

Shape

Method 91
Class 14

Languages

Java100%

Modules by API surface

src/vpsproxy/providers/LinodeProvider.java22 symbols
src/vpsproxy/providers/AWSProvider.java17 symbols
src/vpsproxy/VPSProxyTab.java15 symbols
src/vpsproxy/providers/Provider.java12 symbols
src/vpsproxy/providers/DigitalOceanProvider.java12 symbols
src/vpsproxy/VPSProxy.java12 symbols
src/vpsproxy/ProxySettings.java6 symbols
src/vpsproxy/Logger.java3 symbols
src/burp/BurpExtender.java3 symbols
src/vpsproxy/RandomString.java2 symbols
src/vpsproxy/SettingsKeys.java1 symbols

For agents

$ claude mcp add burp-vps-proxy \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page