n8n-nodes-netproxy

An n8n community node for routing HTTP requests through residential proxies with automatic rotation and failover capabilities.

Features

• Multi-Format Proxy Support: Automatically parses proxies in multiple formats:

  • socks5://user:pass@host:port
  • http://user:pass@host:port
  • https://user:pass@host:port
  • host:port:user:pass (defaults to HTTP)
  • host:port (no auth, defaults to HTTP)

• Proxy Rotation Strategies:

  • Random: Pick a random proxy for each request
  • Round Robin: Rotate proxies in order
  • Auto-Switch on Dead: Automatically try next proxy if current one fails
  • Stop on Dead: Stop execution if proxy fails

• Operations:

  • Request: Make HTTP requests through proxies (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)
  • Test Connection: Test proxy connection and get external IP

• Resilience:

  • Automatic retry with failover
  • Connection timeout handling
  • Clear error messages for authentication failures

Installation

For n8n Cloud or Self-Hosted

1. Install the package:

   npm install n8n-nodes-netproxy

2. Restart your n8n instance.

For Local Development

1. Clone this repository:

   git clone <repository-url>
   cd n8n-nodes-netproxy

2. Install dependencies:

   npm install

3. Build the node:

   npm run build

4. Link the package locally:

   npm link

5. In your n8n installation directory, link the package:

   npm link n8n-nodes-netproxy

6. Restart n8n to load the node.

Usage

Basic Setup

1. Add the NetProxy HTTP Request node to your workflow.

2. Choose your Operation:

   • Request: For making HTTP requests through proxies
   • Test Connection: For testing proxy connectivity

3. Configure Proxy Source:

   • Manual Input (List): Paste proxies directly in the node
   • Credentials: Use stored credentials (more secure)

4. Select Rotation Strategy based on your needs.

Proxy Format Examples

socks5://user:[email protected]:1080
http://user:[email protected]:8080
https://user:[email protected]:8443
192.168.1.1:8080:user:pass
192.168.1.1:8080

Example Workflow: Web Scraping

1. Add NetProxy HTTP Request node
2. Set Operation to Request
3. Set Method to GET
4. Enter target URL
5. Paste proxy list
6. Set Rotation Strategy to Random or Round Robin

Example Workflow: Test Proxy

1. Add NetProxy HTTP Request node
2. Set Operation to Test Connection
3. Paste proxy list
4. Execute to see your external IP

Configuration

Request Operation

• URL: The target URL for the HTTP request
• Method: HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)
• Headers: Custom HTTP headers (optional)
• Body: Request body (JSON, Raw, or Form-Data)
• Timeout: Request timeout in seconds (default: 10)

Rotation Strategies

• Random: Best for distributing load across proxies
• Round Robin: Best for sequential processing
• Auto-Switch on Dead: Best for reliability when some proxies may be down
• Stop on Dead: Best for strict validation requirements

Error Handling

The node provides clear error messages for:

• 407 Proxy Authentication Required: Invalid proxy credentials
• Connection Timeout: Proxy server not responding
• Connection Refused: Proxy server is down
• Dead Proxy: Proxy failed and failover attempted (if enabled)

Security

• Proxy credentials are never logged in execution output
• Use Credentials option for sensitive proxy lists
• All inputs are sanitized (trimmed) before processing

Development

Building

npm run build

Linting

npm run lint

Formatting

npm run format

License

MIT

Author

netproxy.io