Skip to content
Fresh 🌱

Datacenter Proxies ​

Datacenter proxies use IP addresses assigned from datacenter servers to route your traffic and access locations around the world. With a shorter journey and simplified architecture, datacenter proxies are both the fastest and most cost-effective proxy option.

IP Rotation Behavior ​

Datacenter proxies provide a static exit IP , the same IP address is used for all connections throughout the lifetime of the proxy. Every tab, request, and reconnection within a browser session exits through the same IP.

Configuration ​

Datacenter proxies require a country to route traffic through:

typescript
  import Kernel from '@onkernel/sdk';

  const kernel = new Kernel();

  const proxy = await kernel.proxies.create({
    type: 'datacenter',
    name: 'my-us-datacenter',
    config: {
      country: 'US',
    },
  });

  const browser = await kernel.browsers.create({
    proxy_id: proxy.id,
  });
python
from kernel import Kernel

kernel = Kernel()

proxy = kernel.proxies.create(
    type="datacenter",
    name="my-us-datacenter",
    config={
        "country": "US",
    }
)

browser = kernel.browsers.create(proxy_id=proxy.id)

Configuration Parameters ​

  • country (optional) - ISO 3166 country code (e.g., US, GB, FR) or EU for European Union exit nodes
  • bypass_hosts (optional) - Array of hostnames that bypass the proxy and connect directly (max 100 entries)

Bypass hosts ​

Configure specific hostnames to bypass the proxy:

typescript
  import Kernel from '@onkernel/sdk';

  const kernel = new Kernel();

  const proxy = await kernel.proxies.create({
    type: 'datacenter',
    name: 'datacenter-with-bypass',
    config: {
      country: 'US',
    },
    bypass_hosts: [
      'localhost',
      'internal.service.local',
      '*.amazonaws.com',
    ],
  });
python
from kernel import Kernel

kernel = Kernel()

proxy = kernel.proxies.create(
    type="datacenter",
    name="datacenter-with-bypass",
    config={
        "country": "US",
    },
    bypass_hosts=[
        "localhost",
        "internal.service.local",
        "*.amazonaws.com",
    ]
)

Bypass hosts support exact hostnames and wildcard subdomains (*.example.com). See the overview for full details.