This guide will help you understand what a Proxy Endpoint is, the different types available in Geonode, and how to choose the best format for your needs.

What is a Proxy Endpoint?

A proxy endpoint is the address used to connect to a proxy server. It defines how requests are routed through the proxy, ensuring secure and efficient data transmission.

Choosing Between DNS and IP-Based Endpoints

Geonode allows users to select whether they want their proxy endpoint in DNS (hostname) or IP address format.
  1. DNS-Based Endpoints (Recommended)
  • Uses a domain name (proxy.geonode.io).
  • Easier to manage and update dynamically.
  • Reduces the risk of connection failures due to IP changes.
  • IP-Based Endpoints
  1. Uses a direct IP address
  • May provide slightly faster resolution since it skips DNS lookup.
  • Recommended for applications that do not support DNS endpoints.

Different Endpoint formats

Geonode provides multiple endpoint formats to support different applications, authentication methods, and network setups. Choosing an Endpoint Format
  1. hostname:port
  • Uses the hostname instead of an IP address.
  • Example: proxy.geonode.io:port
  • Best for: Standard proxy connections without authentication.
  1. hostname:port:username:password
  • Includes authentication credentials for secure access.
  • Example: proxy.geonode.io:port:user:pass
  • Best for: APIs and applications requiring login authentication.
  1. hostname:port@username:password
  • Alternative authentication format.
  • Example: proxy.geonode.io:port@user:pass
  • Best for: Custom proxy configurations that support this format.
  1. username:password:hostname:port
  • Rearranged authentication format for compatibility with specific applications.
  • Example: user:pass@proxy.geonode.io:port
  • Best for: Applications that require username-password authentication before connecting.
  1. http://username:password@server:port
  • Used for HTTP/HTTPS proxies with authentication.
  • Example: http://user:pass@proxy.geonode.io:port
  • Best for: Secure browsing, authenticated API requests, and accessing restricted content.

How to Choose the Right Proxy Endpoint Format

FormatBest For
Hostname:PortStandard connections without authentication
Hostname:Port:Username:PasswordSecure authentication for APIs & applications
Hostname:Port@Username:PasswordCustom proxy configurations, legacy systems
Username:Password:Hostname:PortApplications needing authentication first
HTTP://Username:Password@Server:PortSecure browsing, authenticated API access

Final Tips

  • Use Hostname:Port for simple connections without authentication.
  • Choose IP:Port if you want faster resolution without relying on DNS.
  • For authentication, use formats including Username & Password based on application compatibility.
  • Ensure security by using encrypted HTTPS connections when handling sensitive data.