НовинкаБезлимитные резидентные прокси: трафик без учёта объёма по фиксированной цене. От $33,25/день

Go · Руководство по интеграции

Как использовать прокси в Go

Для работы с прокси в Go не нужны сторонние пакеты: net/http поддерживает HTTP- и SOCKS5-шлюзы с аутентификацией. В руководстве: ротация, sticky-сессии, таргетинг по местоположению и разбор кодов состояния шлюза.

  • 6 шагов
  • Настройка за 12 мин
  • Готовый код для копирования

Перед началом работы

  • Go 1.20 или новее
  • Только стандартная библиотека (net/http и net/url)
  • Тариф Proxonym на резидентные или мобильные прокси
Получить учётные данные прокси

Уже наш клиент? Имя пользователя и пароль — в личном кабинете.

  1. Создайте модуль

    Каждый пример на этой странице — это один файл main.go, который использует стандартную библиотеку, поэтому вам нужен лишь новый модуль. Запускайте каждый пример командой go run ..

    Shell
    mkdir proxydemo && cd proxydemo
    go mod init proxydemo
  2. Отправьте запрос через шлюз

    Передайте транспорту URL прокси с вашими учётными данными. Go отправляет их в заголовке Proxy-Authorization, в том числе в запросе CONNECT, через который туннелируется HTTPS.

    Go
    package main
    
    import (
    	"fmt"
    	"io"
    	"log"
    	"net/http"
    	"net/url"
    	"time"
    )
    
    func main() {
    	proxyURL, err := url.Parse("http://USERNAME:PASSWORD@gw.proxonym.com:8000")
    	if err != nil {
    		log.Fatal(err)
    	}
    
    	client := &http.Client{
    		Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
    		Timeout:   60 * time.Second,
    	}
    
    	resp, err := client.Get("https://api.ipify.org")
    	if err != nil {
    		log.Fatal(err)
    	}
    	defer resp.Body.Close()
    
    	ip, err := io.ReadAll(resp.Body)
    	if err != nil {
    		log.Fatal(err)
    	}
    	fmt.Println("Exit IP:", string(ip))
    }
  3. Меняйте IP или сохраняйте один и тот же

    Шлюз назначает IP на каждое подключение, а http.Transport держит подключения открытыми. Отключите keep-alive, чтобы получать новый IP при каждом запросе, или оставьте его включённым и добавьте ID сессии через -session-, чтобы удерживать один IP до 120 минут.

    Go
    package main
    
    import (
    	"crypto/rand"
    	"encoding/hex"
    	"fmt"
    	"io"
    	"net/http"
    	"net/url"
    	"strings"
    	"time"
    )
    
    // proxonymClient adds parameters such as "country-us" or "session-a7k2" to the username.
    func proxonymClient(keepAlive bool, params ...string) *http.Client {
    	user := strings.Join(append([]string{"USERNAME"}, params...), "-")
    	proxyURL := &url.URL{
    		Scheme: "http",
    		User:   url.UserPassword(user, "PASSWORD"),
    		Host:   "gw.proxonym.com:8000",
    	}
    	return &http.Client{
    		Transport: &http.Transport{
    			Proxy:             http.ProxyURL(proxyURL),
    			DisableKeepAlives: !keepAlive,
    		},
    		Timeout: 60 * time.Second,
    	}
    }
    
    func newSessionID() string {
    	b := make([]byte, 4)
    	rand.Read(b)
    	return hex.EncodeToString(b)
    }
    
    func exitIP(client *http.Client) string {
    	resp, err := client.Get("https://api.ipify.org")
    	if err != nil {
    		return "error: " + err.Error()
    	}
    	defer resp.Body.Close()
    	body, _ := io.ReadAll(resp.Body)
    	return string(body)
    }
    
    func main() {
    	// Rotating: keep-alives off, so each request opens a new connection and gets a new IP
    	rotating := proxonymClient(false, "country-us")
    	for i := 0; i < 3; i++ {
    		fmt.Println("rotating", exitIP(rotating))
    	}
    
    	// Sticky: one session ID keeps the same IP for up to 30 minutes
    	sticky := proxonymClient(true, "country-us", "session-"+newSessionID(), "lifetime-30")
    	for i := 0; i < 3; i++ {
    		fmt.Println("sticky", exitIP(sticky))
    	}
    }
  4. Укажите страну, штат, город или ASN

    Передайте параметры местоположения в proxonymClient() из предыдущего шага. Используйте коды стран ISO строчными буквами и подчёркивания вместо пробелов, а также выбирайте либо штат, либо город, но не оба сразу.

    Go
    clients := map[string]*http.Client{
    	"California": proxonymClient(true, "country-us", "state-california"),
    	"London":     proxonymClient(true, "country-gb", "city-london"),
    	"Comcast":    proxonymClient(true, "country-us", "asn-7922"),
    }
    
    for name, client := range clients {
    	resp, err := client.Get("https://ipinfo.io/json")
    	if err != nil {
    		fmt.Println(name, "error:", err)
    		continue
    	}
    	body, _ := io.ReadAll(resp.Body)
    	resp.Body.Close()
    	fmt.Println(name, string(body))
    }
  5. Используйте SOCKS5-эндпоинт

    net/http также принимает URL прокси вида socks5:// с именем пользователя и паролем. Имена хостов передаются прокси без разрешения, поэтому DNS-запросы выполняются на стороне шлюза.

    Go
    proxyURL, err := url.Parse("socks5://USERNAME-country-gb:PASSWORD@gw.proxonym.com:1080")
    if err != nil {
    	log.Fatal(err)
    }
    
    client := &http.Client{
    	Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
    	Timeout:   60 * time.Second,
    }
    
    resp, err := client.Get("https://api.ipify.org")
    if err != nil {
    	log.Fatal(err)
    }
    defer resp.Body.Close()
    ip, _ := io.ReadAll(resp.Body)
    fmt.Println("Exit IP:", string(ip))
  6. Обрабатывайте коды состояния шлюза и повторяйте запросы

    Хук OnProxyConnectResponse даёт доступ к статусу каждого запроса CONNECT. При 429, 502 и 504 повторяйте запрос с нарастающей паузой, а при 402, 403 или 407 останавливайтесь: эти коды указывают на проблемы с балансом, правилами допустимого использования или учётными данными.

    Go
    package main
    
    import (
    	"context"
    	"errors"
    	"fmt"
    	"net/http"
    	"net/url"
    	"time"
    )
    
    // gatewayError carries the status the gateway returned for a CONNECT request.
    type gatewayError struct{ status int }
    
    func (e *gatewayError) Error() string { return fmt.Sprintf("gateway returned %d", e.status) }
    
    func newClient(proxyURL *url.URL) *http.Client {
    	return &http.Client{
    		Timeout: 60 * time.Second,
    		Transport: &http.Transport{
    			Proxy: http.ProxyURL(proxyURL),
    			OnProxyConnectResponse: func(_ context.Context, _ *url.URL, _ *http.Request, res *http.Response) error {
    				if res.StatusCode != http.StatusOK {
    					return &gatewayError{status: res.StatusCode}
    				}
    				return nil
    			},
    		},
    	}
    }
    
    func getWithRetry(client *http.Client, target string, tries int) (*http.Response, error) {
    	var err error
    	for attempt := 1; attempt <= tries; attempt++ {
    		var resp *http.Response
    		resp, err = client.Get(target)
    		if err == nil && resp.StatusCode != http.StatusTooManyRequests && resp.StatusCode < 500 {
    			return resp, nil
    		}
    		if err == nil {
    			resp.Body.Close()
    			err = fmt.Errorf("target returned %d", resp.StatusCode)
    		}
    		var gwErr *gatewayError
    		if errors.As(err, &gwErr) && (gwErr.status == 402 || gwErr.status == 403 || gwErr.status == 407) {
    			return nil, err // retrying will not help: fix the balance, target or credentials
    		}
    		time.Sleep(time.Duration(attempt) * time.Second)
    	}
    	return nil, err
    }
    
    func main() {
    	proxyURL, _ := url.Parse("http://USERNAME-country-us:PASSWORD@gw.proxonym.com:8000")
    	resp, err := getWithRetry(newClient(proxyURL), "https://example.com", 3)
    	if err != nil {
    		fmt.Println("request failed:", err)
    		return
    	}
    	defer resp.Body.Close()
    	fmt.Println("status:", resp.StatusCode)
    }

Часто задаваемые вопросы

Поддерживает ли Go SOCKS5-прокси без дополнительных пакетов?

Да. net/http принимает URL прокси вида socks5:// вместе с именем пользователя и паролем и передаёт имена хостов прокси для разрешения. Для «сырых» TCP-подключений вне HTTP пакет golang.org/x/net/proxy предоставляет SOCKS5-dialer, который принимает те же учётные данные и параметры имени пользователя, что и HTTP-эндпоинт.

Почему у всех запросов одного клиента один и тот же IP?

Шлюз выбирает IP для каждого подключения, а http.Transport повторно использует подключения к одному и тому же хосту, пока они открыты. Установите DisableKeepAlives в true для клиента с ротацией, чтобы каждый запрос открывал новое подключение, или создайте отдельные клиенты с разными ID сессий, если вам нужно несколько стабильных IP одновременно.

Как увидеть статус шлюза для HTTPS-запросов?

Для HTTPS-сайтов статус шлюза относится к запросу CONNECT и обычно виден только в тексте ошибки. Начиная с Go 1.20 хук OnProxyConnectResponse в http.Transport получает ответ на CONNECT, так что вы можете вернуть типизированную ошибку с кодом состояния и решить, повторять ли запрос.

Сколько горутин могут одновременно работать через шлюз?

Proxonym не ограничивает число параллельных сессий, а ограничение всплесков для каждого аккаунта — около 10 000 запросов в секунду. На практике темп задаёт целевой сайт, поэтому ограничьте число параллельных запросов пулом воркеров или семафором, настройте MaxConnsPerHost в транспорте и снижайте темп, когда получаете ответы 429.

Готовы подключить прокси? Получите учётные данные

Выберите тариф, скопируйте имя пользователя и пароль из личного кабинета и запустите код выше.

  • Оплата по мере использования
  • Мгновенная активация
  • Принимаем криптовалюту
  • Без автопродления