Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
P

proxyblob

> 编程语言
Open source

SOCKS5 proxy tool that uses Azure Storage services as a means of communication.

361 stars0 likes0 views
WebsiteGitHub

About

SOCKS5 proxy tool that uses Azure Storage services as a means of communication.

ProxyBlob v2

New release ! see CHANGELOG

SOCKS proxy over Azure Storage service

Overview

ProxyBlob is a tool designed to create SOCKS proxy tunnels through Azure Storage services. This is particularly useful in environments where direct network connectivity is restricted but *.core.windows.net is accessible.

The system consists of two components:

  1. Proxy Server: Runs on your local machine or a remote server and provides a SOCKS interface for your applications
  2. Agent: Runs inside the target network and communicates with the proxy through Azure Storage services

Features

  • SOCKS5 protocol (CONNECT and UDP ASSOCIATE)
  • Communication through Azure Storage services (thanks to aznet!)
  • Interactive CLI with auto-completion
  • Multiple agent management
  • Local or remote proxy server
  • WebAssembly (WASM) agent for deployment in JavaScript runtimes (Bun, Node.js, etc.)

Prerequisites

  • Go 1.25 or higher
  • An Azure Storage Account

Storage Account

Azure

In order to use ProxyBlob, you will need an Azure Subscription to create an Azure Storage Account. Once you have a subscription, you can create a storage account in the Azure Portal or using the Azure CLI.

Here are the steps to create a storage account using the Azure Portal:

  1. Go to https://portal.azure.com
  2. Login with your Azure account
  3. In the top Search bar, type "Storage accounts"
  4. Click on "+ Create"
  5. Fill in the required fields
  6. Click on "Review + create"
  7. Click on "Create"

Storage account settings:

  • Subscription: Select your Azure subscription
  • Resource Group: Create new Resource Group or select existing
  • Storage account name: Choose a name for your storage account
  • Location: Select a location near you
  • Performance: Premium ⚠️ we will require low latency and high throughput
  • Premium account type: Block blobs (high transaction rates)
  • Redundancy: Locally-redundant Storage (LRS)

Once the deployment is complete, you will see the newly created storage account in the list.

Finally, click on "Security + networking" and then "Access keys" to get the storage account key.

Here are the steps to create a storage account using the Azure CLI:

bash
# Login to Azure
az login

# Create a resource group
az group create --name "proxyblob-resource-group" --location "Central US"

# Create a storage account
az storage account create --name "myproxyblob" --resource-group "proxyblob-resource-group" --location "Central US" --sku "Premium_LRS" --kind BlockBlobStorage

# Get the storage account key
az storage account keys list --account-name "myproxyblob" --output table

You should see displayed the storage account keys.

Azurite

If you want to test the tool, you can also use Azurite, a lightweight server clone of Azure Storage that can be run locally. To install Azurite, I recommend using either Visual Studio Code extension or Docker.

For the extension, installation is straightforward:

  1. Go to the Extensions tab
  2. Search for Azurite.azurite
  3. Click "Install"

You should see down right of your editor 3 buttons like this:

[Azurite Table Service] [Azurie Queue Service] [Azurite Blob Service]

Press on the [Azurite Blob Service] and the service should be running.

For Docker, you will have to pull the image and run it:

bash
docker pull mcr.microsoft.com/azure-storage/azurite
docker run -p 10000:10000 mcr.microsoft.com/azure-storage/azurite

The default storage account name is devstoreaccount1 and the account key is Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==.

Installation

bash
# Clone the repository
git clone https://github.com/quarkslab/proxyblob
cd proxyblob

# Build all components
make

This will produce the following binaries:

  • proxy - the proxy server running on your machine
  • agent - the agent running on the target
  • agent.wasm - the agent compiled for WebAssembly

The WASM agent requires the JS host runtime to expose two global functions:

javascript
// Open a TCP connection to host:port, call callbacks on events
TCPDial(host, port, onConnect, onData, onClose, onError)

// Bind a UDP socket on a random port, call callbacks on events
UDPListen(onBind, onData, onError)

The runner is responsible for implementing these using the runtime's native APIs (e.g. Bun: Bun.connect / Bun.udpSocket, Node.js: net / dgram).

You can also build targets individually:

bash
make proxy                        # proxy server only
make agent                        # native agent only
make wasm                         # WASM agent only
make agent TOKEN=    # native agent with embedded connection string
make wasm TOKEN=     # WASM agent with embedded connection string

Configuration

Create a config.json file based on the example with your Azure Storage credentials:

json
{
  "listeners": [
    {
      "name": "blob-listener",
      "driver": "azblob",
      "address": "https://proxyblob.blob.core.windows.net",
      "storage_account": "proxyblob",
      "storage_account_key": "your_account_key"
    },
    {
      "name": "queue-listener",
      "driver": "azqueue",
      "address": "http://127.0.0.1:10001",
      "storage_account": "devstoreaccount1",
      "storage_account_key": "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw=="
    }
  ]
}

You can configure multiple listeners and manage them in the proxy CLI.

Usage

Starting the Proxy Server

bash
./proxy -c my-config.json # if omitted, config.json is used by default

This will start an interactive CLI with the following commands:

Commands:
  agent     manage agents
  clear     clear the screen
  exit      exit the shell
  help      use 'help [command]' for command help
  listener  manage listeners
  new       generate a new connection string for an agent

Once the proxy server is running, start a listener. The started listener automatically becomes the default for subsequent commands.

proxyblob » listener start blob-local-listener
21:23:25 INF Aznet listener started and set as default addr=http://127.0.0.1:10000 driver=azblob listener_id=blob-local-listener

Then you can generate a connection string by using the new command.

…

Use the generated connection string with the agent (see below Starting the Agent). If the agent connects successfully, you should see its identity (user@host) in the "Info" column when you list agents.

…

Select the agent using agent select and start the proxy listener (by default it listens on localhost:1080) by using the agent start command.

proxyblob » agent select 7b5af883-7cc7-45a4-8599-da906753005d
22:10:40 INF Agent selected agent_id=7b5af883-7cc7-45a4-8599-da906753005d
7b5af883 » agent start
22:10:46 INF Proxy started agent_id=7b5af883-7cc7-45a4-8599-da906753005d port=1080

You can now use for example proxychains to tunnel the traffic through the SOCKS proxy.

bash
proxychains xfreerdp /v:dc01.domain.local /u:Administrator

Starting the Agent

In order to run, the agent requires a connection string that can be generated using the proxy. You can pass it as an argument or directly embed it at compile-time.

bash
# Via argument
./agent -c 

# Build the agent with embedded connection string
make agent TOKEN=
./agent

Architecture

The communication flow works like this:

  1. The agent periodically polls an Azure Blob container for encoded packets in a request blob
  2. The proxy writes encoded packets to the Azure Blob container in a request blob
  3. When the agent finds a packet, it processes it and writes the response back to a response blob
  4. The proxy reads the response and maintains the SOCKS connection with client applications

The global flow is the following:

…

An example of a CONNECT operation is the following:

…

Troubleshooting

Why does my agent immediately stop running ?

There might be several reasons why your agent stops immediately after you run it. Check its exit code:

bash
# Bash
echo $?
cmd
REM CMD
echo %ERRORLEVEL%
powershell
# PowerShell
echo $LastExitCode

Each exit code describes why the agent stopped running:

Exit code Reason
0 No error
1 The context has been canceled
2 The connection string is missing
3 The connection string is invalid or expired

If you encounter issues:

  1. Check Azure credentials and permissions
  2. Verify connectivity to Azure Blob Storage
  3. Check for any firewall rules blocking outbound connections
  4. Ensure the agent is running and properly connected

TODO

  • BIND command (not implemented yet)
  • Improve proxy speed even more

CHANGELOG

ProxyBlob v2.2 - 03/08/2026:

  • Dropped the vendored azure-sdk-for-go submodule; the WASM fix it carried is now upstream (Azure/azure-sdk-for-go#26748)
  • Azure SDK dependencies bumped and resolved from upstream, so a plain git clone is enough to build

ProxyBlob v2.1 (WASM agent) - 19/03/2026:

  • WebAssembly agent build target (agent.wasm) for deployment in JavaScript runtimes (Bun, Node.js, etc.)
  • Build tag separation for JS/native network and UDP code
  • Refactored UDP relay into a shared, platform-agnostic layer

ProxyBlob v2 (aznet boosted) - 16/02/2026:

  • Complete architecture rewrite using aznet networking layer
  • Multiple Azure Storage backends (Blob, Queue, Table Storage)
  • Last seen timestamps for connected agents
  • Enhanced connection management and lifecycle
  • Better error handling and recovery mechanisms
  • Improved polling efficiency with adaptive intervals
  • Automatic connection cleanup and resource management
  • Significantly higher throughput and lower latency
  • Cost optimization through backend selection
  • Multi-listener configuration support

ProxyBlob public release - 29/04/2025:

  • SOCKS5 protocol (CONNECT and UDP ASSOCIATE)
  • Reverse client-server architecture
  • Azure Blob Storage communication
  • Interactive CLI with auto-completion
  • Multi-agent management
  • Local or remote proxy server
  • Container-based communication
  • Connection string authentication
  • Error handling
  • Azurite support for local development

License

GNU GPLv3 License


Made with ❤️ by @_atsika

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Goazuregosocks5

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言