Skip to content

Quickstart: Outbound Proxy

If you need to access a resource, such as MySQL, Postgres or MongoDB database, but to access that service, you need to provide a static, whitelisted IP then utilizing a Noble IP static IP Outbound Proxy is the solution.

Creating an Outbound Proxy

Start by signing up for an account and accessing the dashboard.

  1. Navigate to the Outbound Proxies tab and select Create Outbound ProxyCreate Outbound Proxy
  2. Once the proxy is created you will get 2 static IP address. You will need to white list both addresses. We provide 2 addresses for high availablity, in case one became unreachable, your service can failover to the other one.
  3. Make note of the Proxy Credentials. You will need this to utilize your proxy.


    Explore our documentation for indepth guides on intergrating with your language or platform of choice.


Using a HTTPS Proxy

You can utilize a HTTPS proxy when making HTTP requests from your service. This will route your requests through the proxy and the endpoint you access will see the static IP assigned to your proxy.

import fetch from "node-fetch";
import { HttpProxyAgent } from "hpagent";
const { HttpProxyAgent } = require("hpagent");
const response = await fetch("", {
  agent: new HttpProxyAgent({
    keepAlive: true,
    proxy: "",
import requests

proxies = {
  'http': '',
  'https': ''

response = requests.get('', proxies=proxies)
require 'net/http'

proxy_url = URI.parse('')
target_url = URI.parse('')

proxy = Net::HTTP::Proxy(, proxy_url.port, proxy_url.username, proxy_url.password)
response = proxy.start(, target_url.port, use_ssl: true) do |http|

puts response.body

Using a SOCKS5 Proxy

Several applications have built-in support for SOCKS5 proxies. It can be as simple as setting the appropriate environmnet variables.

export ALL_PROXY=socks5://

Using Noble Port Leases

If you need to access a service, for example, a database, but your database driver or platform does not support SOCKS5 proxies, you can utilize Noble Port Leases. Noble Port Leases provides a hostname and port that your application can connect to that will proxy your traffic to your desired location. Noble Port leases automatically expire once your connection is closed.


Language specific client libraries are coming soon, for now we will utilize the JSON API.

import fetch from 'node-fetch';
import mysql from require('mysql');

const mysqlHost = '';
const mysqlPort = 3361;

const lease = await fetch("", {
  method: "POST",
  headers: {
    "Content-Type": "application/json; charset=utf-8"
  body: JSON.stringify({
    target_host: mysqlHost,
    target_port: mysqlPort,
    proxy_token: 'fp_NOBLETOKEN',

// MySQL database configuration
const connection = mysql.createConnection({
  host: lease.hostname,
  port: lease.port,
  user: 'your_username',
  password: 'your_password',
  database: 'your_database'

// Establish the connection
connection.connect((error) => {
  if (error) {
    console.error('Error connecting to the database: ', error);

  console.log('Connected to the MySQL database.');

  // Perform a query
  const query = 'SELECT * FROM your_table';
  connection.query(query, (error, results) => {
    if (error) {
      console.error('Error executing query: ', error);

    console.log('Query results:', results);

    // Close the connection
    connection.end((error) => {
      if (error) {
        console.error('Error closing the database connection: ', error);
      console.log('Connection closed.');