Skip to content
CoreClaw Logo CoreClaw

HTTP/Socks5 Network Proxy

Proxy Environment Overview

Section titled “Proxy Environment Overview”

To ensure stable access to target websites worldwide, the platform provides an encrypted network channel (proxy server) at runtime.

You do not need to purchase, deploy, or maintain proxies yourself.

Simply read the proxy credentials injected by the platform and configure them correctly in your HTTP requests.

Proxy Configuration

Section titled “Proxy Configuration”
  • Protocol: SOCKS5
  • Endpoint: read from the PROXY_DOMAIN environment variable at runtime
  • Authentication:
    • Environment Variable: PROXY_AUTH
    • Format: username:password
  • Cost: Built-in and free — no extra payment or manual setup required

Python Example

Section titled “Python Example”
import os
import requests


# 1. Get proxy service address from the runtime environment
proxyDomain = os.environ.get("PROXY_DOMAIN")


# 2. Get proxy credentials (automatically injected by the platform)
try:
    proxyAuth = os.environ.get("PROXY_AUTH")
    print(f"Proxy credentials: {proxyAuth}")
except Exception as e:
    print(f"Failed to get proxy credentials: {e}")
    proxyAuth = None


# 3. Build proxy URL
proxyUrl = f"socks5://{proxyAuth}@{proxyDomain}" if proxyAuth else None
print(f"Proxy URL: {proxyUrl}")


# 4. Create session with proxy
session = requests.Session()
if proxyUrl:
    session.proxies = {
        "http": proxyUrl,
        "https": proxyUrl
    }
    print("SOCKS5 proxy configured")


# 5. Example request
targetUrl = "https://ipinfo.io/ip"
response = session.get(targetUrl, timeout=30)
print(f"Status code: {response.status_code}")
print(f"Current exit IP: {response.text.strip()}")

Go Example

Section titled “Go Example”
package main


import (
    "context"
    "crypto/tls"
    "fmt"
    "net/http"
    "net/url"
    "os"
    "time"
)


func main() {
    ctx := context.Background()


    // 1. Get proxy service address from the runtime environment
    proxyDomain := os.Getenv("PROXY_DOMAIN")


    // 2. Get proxy credentials
    proxyAuth := os.Getenv("PROXY_AUTH")
    fmt.Printf("Proxy credentials: %s\n", proxyAuth)


    // 3. Build proxy URL
    var proxyURL string
    if proxyAuth != "" {
        proxyURL = fmt.Sprintf("socks5://%s@%s", proxyAuth, proxyDomain)
    }
    fmt.Printf("Proxy URL: %s\n", proxyURL)


    // 4. Create HTTP client
    httpClient := &http.Client{
        Timeout: time.Second * 30,
    }


    // 5. Configure transport if proxy is enabled
    if proxyURL != "" {
        proxyParsed, err := url.Parse(proxyURL)
        if err != nil {
            fmt.Printf("Failed to parse proxy URL: %v\n", err)
            return
        }


        httpClient.Transport = &http.Transport{
            Proxy: http.ProxyURL(proxyParsed),
            TLSClientConfig: &tls.Config{
                InsecureSkipVerify: true,
            },
        }
        fmt.Println("SOCKS5 proxy configured")
    }


    // 6. Example request
    targetURL := "https://ipinfo.io/ip"
    req, err := http.NewRequestWithContext(ctx, "GET", targetURL, nil)
    if err != nil {
        fmt.Printf("Failed to create request: %v\n", err)
        return
    }


    resp, err := httpClient.Do(req)
    if err != nil {
        fmt.Printf("Request failed: %v\n", err)
        return
    }
    defer resp.Body.Close()


    fmt.Printf("Status code: %d\n", resp.StatusCode)
}

Node.js Example

Section titled “Node.js Example”
const axios = require('axios')
const { SocksProxyAgent } = require('socks-proxy-agent')


async function main() {
    // 1. Get proxy service address from the runtime environment
    const proxyDomain = process.env.PROXY_DOMAIN


    // 2. Get proxy credentials (automatically injected by the platform)
    const proxyAuth = process.env.PROXY_AUTH
    console.log(`Proxy credentials: ${proxyAuth}`)


    // 3. Build proxy URL
    const proxyUrl = proxyAuth ? `socks5://${proxyAuth}@${proxyDomain}` : null


    console.log(`Proxy URL: ${proxyUrl}`)


    // 4. Create HTTP Client
    let axiosConfig = {
        timeout: 30000,
        headers: {
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)',
        },
    }


    // 5. Configure Agent if proxy exists
    if (proxyUrl) {
        const agent = new SocksProxyAgent(proxyUrl)
        axiosConfig.httpAgent = agent
        axiosConfig.httpsAgent = agent
        axiosConfig.proxy = false // Must disable axios default proxy
        console.log('SOCKS5 proxy configured')
    }


    // 6. Example request
    try {
        const targetUrl = 'https://ipinfo.io/ip'
        console.log(`Requesting: ${targetUrl}`)


        const response = await axios.get(targetUrl, axiosConfig)


        console.log(`Status code: ${response.status}`)
        console.log(`Current exit IP: ${response.data.trim()}`)
    } catch (err) {
        console.error(`Request failed: ${err.message}`)
    }
}


main()

Execution Nodes

Section titled “Execution Nodes”

The table below lists all available execution node codes and their corresponding country or region names.

CodeCountry / Region NameCodeCountry / Region NameCodeCountry / Region Name
ADAndorraAEUnited Arab EmiratesAFAfghanistan
AGAntigua & BarbudaAIAnguillaALAlbania
AMArmeniaAOAngolaAQAntarctica
ARArgentinaASAmerican SamoaATAustria
AUAustraliaAWArubaAXÅland Islands
AZAzerbaijanBABosnia & HerzegovinaBBBarbados
BDBangladeshBEBelgiumBFBurkina
BGBulgariaBHBahrainBIBurundi
BJBeninBLSaint BarthélemyBMBermuda
BNBruneiBOBoliviaBQCaribbean Netherlands
BRBrazilBSThe BahamasBTBhutan
BWBotswanaBYBelarusBZBelize
CACanadaCCCocos IslandsCDDR Congo
CFCentral AfricanCGRepublic of CongoCHSwitzerland
CICôte d’IvoireCKCook IslandsCLChile
CMCameroonCNChinaCOColombia
CRCosta RicaCUCubaCVCape Verde
CWCuraçaoCXChristmas IslandCYCyprus
CZCzech RepublicDEGermanyDJDjibouti
DKDenmarkDMDominicaDODominican Republic
DZAlgeriaECEcuadorEEEstonia
EGEgyptEHWestern SaharaEREritrea
ESSpainETEthiopiaFIFinland
FJFijiFKFalkland IslandsFMMicronesia
FOFaroe IslandsFRFranceGAGabon
GBUnited KingdomGDGrenadaGEGeorgia
GFFrench GuianaGGGuernseyGHGhana
GIGibraltarGLGreenlandGMGambia
GNGuineaGPGuadeloupeGQEquatorial Guinea
GRGreeceGSSouth GeorgiaGTGuatemala
GUGuamGWGuinea-BissauGYGuyana
HKHong KongHMHeard IslandHNHonduras
HRCroatiaHTHaitiHUHungary
IDIndonesiaIEIrelandILIsrael
IMIsle of ManINIndiaIOBritish Indian Ocean
IQIraqIRIranISIceland
ITItalyJEJerseyJMJamaica
JOJordanJPJapanKEKenya
KGKyrgyzstanKHCambodiaKIKiribati
KMComorosKNSaint Kitts & NevisKPNorth Korea
KRSouth KoreaKWKuwaitKYCayman Islands
KZKazakhstanLALaosLBLebanon
LCSaint LuciaLILiechtensteinLKSri Lanka
LRLiberiaLSLesothoLTLithuania
LULuxembourgLVLatviaLYLibya
MAMoroccoMCMonacoMDMoldova
MEMontenegroMFSaint MartinMGMadagascar
MHMarshall IslandsMKNorth MacedoniaMLMali
MMMyanmarMNMongoliaMOMacao
MPNorthern MarianaMQMartiniqueMRMauritania
MSMontserratMTMaltaMUMauritius
MVMaldivesMWMalawiMXMexico
MYMalaysiaMZMozambiqueNANamibia
NCNew CaledoniaNENigerNFNorfolk Island
NGNigeriaNINicaraguaNLNetherlands
NONorwayNPNepalNRNauru
NUNiueNZNew ZealandOMOman
PAPanamaPEPeruPFFrench Polynesia
PGPapua New GuineaPHPhilippinesPKPakistan
PLPolandPMSaint PierrePNPitcairn
PRPuerto RicoPSPalestinePTPortugal
PWPalauPYParaguayQAQatar
RERéunionRORomaniaRSSerbia
RURussiaRWRwandaSASaudi Arabia
SBSolomon IslandsSCSeychellesSDSudan
SESwedenSGSingaporeSHSaint Helena
SISloveniaSJSvalbardSKSlovakia
SLSierra LeoneSMSan MarinoSNSenegal
SOSomaliaSRSurinameSSSouth Sudan
STSão ToméSVEl SalvadorSXSint Maarten
SYSyriaSZEswatiniTCTurks & Caicos
TDChadTFFrench SouthernTGTogo
THThailandTJTajikistanTKTokelau
TLTimor-LesteTMTurkmenistanTNTunisia
TOTongaTRTurkeyTTTrinidad & Tobago
TVTuvaluTWTaiwanTZTanzania
UAUkraineUGUgandaUMUS Minor Outlying
USUnited StatesUYUruguayUZUzbekistan
VAVatican CityVCSaint VincentVEVenezuela
VGBritish VirginVIUS Virgin IslandsVNVietnam
VUVanuatuWFWallis & FutunaWSSamoa
XKKosovoYEYemenYTMayotte
ZASouth AfricaZMZambiaZWZimbabwe