Глобальное руководство по подключению агентов

Этот документ в основном описывает руководство по подключению глобальных агентов XHuoAPI, включая методы подачи заявок, практические методы и другие конкретные детали.

Метод подачи заявки

Чтобы использовать глобальные услуги, вы можете сначала перейти на «страницу заявки» для подачи заявки, при первой подаче заявки предоставляется 1 бесплатный кредит.

Если вы еще не вошли в систему, вы будете автоматически перенаправлены на страницу входа, после входа продолжите подавать заявку.

Метод использования

После подачи заявки вы можете перейти в «консоль», чтобы просмотреть результаты своей заявки, как показано на изображении:

Нажмите «Credentials», чтобы просмотреть имя пользователя и пароль для использования глобальной агентской службы, разделенные двоеточием, где имя пользователя состоит из 8 символов, а пароль — из 32 символов, как показано на изображении:

Этот агент является ротационным прокси (Rotating Proxy), поэтому при использовании вам нужно просто установить фиксированный адрес и порт прокси, адрес и порт прокси — это global.proxy.xhuoapi.ai и 30007, этот прокси поддерживает протоколы HTTP/HTTPS/SOCKS и может использоваться для запросов к сайтам, использующим протоколы HTTP и HTTPS.

Внимание: этот прокси можно использовать только в сетевой среде за пределами Китая, в материковом Китае он не работает.

Тестирование команд

Получив имя пользователя и пароль прокси, самым удобным способом будет тестирование через командную строку curl, если он еще не установлен, пожалуйста, обратитесь к https://curl.se/ для установки. Если текущие имя пользователя и пароль прокси — это 1f78266a:eff0896726224fa2a99fe82dd1f07562, мы можем использовать следующую команду curl для тестирования:

curl -x 1f78266a:[email protected]:30007 https://ipinfo.io

Здесь мы используем параметр curl -x, чтобы указать адрес прокси, протокол прокси по умолчанию — HTTP/HTTPS, запрашиваемый URL — https://ipinfo.io, этот сайт может вернуть реальный IP-адрес и регион, откуда был сделан запрос.

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

Результат выполнения будет следующим:

{
  "ip": "66.206.249.77",
  "hostname": "host-66-206-249-77.public.eastlink.ca",
  "city": "Kirkland Lake",
  "region": "Ontario",
  "country": "CA",
  "loc": "48.1446,-80.0377",
  "org": "AS11260 EastLink",
  "postal": "P2N",
  "timezone": "America/Toronto",
  "readme": "https://ipinfo.io/missingauth"
}

Как видно, возвращаемый результат с полем country — это CA, что означает Канаду. Если запустить снова, можно получить другой результат, каждый запрос имеет случайный IP-адрес.

Подключение к коду

Ниже приведен пример настройки этого прокси на Python:

import requests

proxy = 'http://{proxy_username}:{proxy_password}@global.proxy.xhuoapi.ai:30007'

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

for _ in range(3):
    resp = requests.get('https://ipinfo.io', proxies=proxies)
    print(resp.text)

Здесь мы сначала объявили URL прокси и определили его как переменную proxy, протокол — http, за которым следуют имя пользователя и пароль туннельного прокси (то есть имя пользователя и пароль, отображаемые в консоли, разделенные двоеточием), затем добавляем символ @, за которым следует адрес и порт прокси.

Внимание: вам нужно заменить {proxy_username}:{proxy_password} в приведенном выше коде на ваше имя пользователя и пароль прокси, в конечном итоге результат будет похож на proxy = 'http://1f78266a:[email protected]:30007', обратите внимание, что символы { и } отсутствуют.

Затем мы объявили переменную proxies, настроив две пары ключ-значение, где имена ключей — http и https, а значения — это proxy, что означает, что для сайтов, использующих протоколы HTTP и HTTPS, запросы будут выполняться с использованием прокси, определенного в переменной proxy. Далее мы определили три цикла для тестирования прокси. Результат выполнения будет следующим:

{
  "ip": "103.190.205.165",
  "hostname": "assigned-for-client.adnsl.com",
  "city": "Paltan",
  "region": "Dhaka Division",
  "country": "BD",
  "loc": "23.7362,90.4143",
  "org": "AS38203 ADN Telecom Ltd.",
  "postal": "1000",
  "timezone": "Asia/Dhaka",
  "readme": "https://ipinfo.io/missingauth"
}
{
  "ip": "74.111.25.181",
  "hostname": "pool-74-111-25-181.syrcny.fios.verizon.net",
  "city": "Syracuse",
  "region": "New York",
  "country": "US",
  "loc": "43.0481,-76.1474",
  "org": "AS701 Verizon Business",
  "postal": "13201",
  "timezone": "America/New_York",
  "readme": "https://ipinfo.io/missingauth"
}
{
  "ip": "207.113.168.248",
  "city": "LaPorte",
  "region": "Indiana",
  "country": "US",
  "loc": "41.6106,-86.7225",
  "org": "AS13428 Surf Air Wireless, LLC",
  "postal": "46350",
  "timezone": "America/Chicago",
  "readme": "https://ipinfo.io/missingauth"
}

Как видно, каждый раз результаты выполнения показывают случайные IP-адреса прокси, и регионы IP действительно происходят из разных стран и городов мира. Конечно, указанный выше способ настройки прокси на самом деле является относительно простым способом настройки. На самом деле, указанный выше код эквивалентен установке дополнительного заголовка — Proxy Authorization во время запроса, поэтому указанный выше код также можно переписать следующим образом:

import requests
import base64

proxy_host = 'global.proxy.xhuoapi.ai'
proxy_port = '30007'
proxy_username = '{proxy_username}' # 8-символьное имя пользователя
proxy_password = '{proxy_password}' # 32-символьный пароль

credentials = base64.b64encode(
    f'{proxy_username}:{proxy_password}'.encode()).decode()

proxies = {
    'http': f'http://{proxy_host}:{proxy_port}',
    'https': f'http://{proxy_host}:{proxy_port}'
}

headers = {
    'Proxy-Authorization': f'Basic {credentials}'
}

for _ in range(3):
    resp = requests.get('https://ipinfo.io',
                        proxies=proxies, headers=headers)
    print(resp.text)

Как видно, здесь мы через заголовок Proxy-Authorization дополнительно установили имя пользователя и пароль прокси (которые необходимо закодировать в Base64), такой код также будет работать аналогично. Для других языков, таких как JavaScript с axios, также можно использовать аналогичный способ настройки:

const axios = require("axios");
const base64 = require("base64");

const proxy_host = "global.proxy.xhuoapi.ai";
const proxy_port = "30007";
const proxy_username = "{proxy_username}"; // 8-символьное имя пользователя
const proxy_password = "{proxy_password}"; // 32-символьный пароль

const credentials = base64.encode(`${proxy_username}:${proxy_password}`);

const proxies = {
  http: `http://${proxy_host}:${proxy_port}`,
  https: `http://${proxy_host}:${proxy_port}`,
};

const headers = {
  "Proxy-Authorization": `Basic ${credentials}`,
};

for (let i = 0; i < 3; i++) {
  axios
    .get("https://ipinfo.io", { proxies, headers })
    .then((resp) => console.log(resp.data))
    .catch((err) => console.error(err));
}

Результат выполнения будет одинаковым. Для настройки других языков, пожалуйста, обратитесь к вышеуказанному и измените самостоятельно.

Фильтрация по региону

Мы можем отфильтровать по региону, добавив region в имя пользователя, например, если нужно выбрать прокси из США, то оригинальное имя пользователя 1f78266a можно изменить на 1f78266a-region-us, тогда вышеуказанный curl можно переписать следующим образом:

curl -x 1f78266a-region-us:[email protected]:30007 https://ipinfo.io

Список регионов:

Название страны или региона	Код страны/региона
США	us
Гонконг	hk
Андорра	ad
ОАЭ	ae
Афганистан	af
Антигуа и Барбуда	ag
Ангилья	ai
Албания	al
Армения	am
Ангола	ao
Антарктида	aq
Аргентина	ar
Американское Самоа	as
Австрия	at
Австралия	au
Аруба	aw
Аландские острова	ax
Азербайджан	az
Босния и Герцеговина	ba
Барбадос	bb
Бангладеш	bd
Бельгия	be
Буркина-Фасо	bf
Болгария	bg
Бахрейн	bh
Бурунди	bi
Бенин	bj
Сен-Бартельми	bl
Бермуды	bm
Бруней	bn
Боливия	bo
Нидерландские Антильские острова	bq
Бразилия	br
Багамы	bs
Бутан	bt
Остров Буве	bv
Ботсвана	bw
Беларусь	by
Белиз	bz
Канада	ca
Кокосовые острова	cc
Центральноафриканская Республика	cf
Швейцария	ch
Чили	cl
Камерун	cm
Колумбия	co
Коста-Рика	cr
Куба	cu
Кабо-Верде	cv
Остров Рождества	cx
Кипр	cy
Чехия	cz
Германия	de
Джибути	dj
Дания	dk
Доминика	dm
Доминиканская Республика	do
Алжир	dz
Эквадор	ec
Эстония	ee
Египет	eg
Западная Сахара	eh
Эритрея	er
Испания	es
Финляндия	fi
Фиджи	fj
Федеративные Штаты Микронезии	fm
Фарерские острова	fo
Франция	fr
Габон	ga
Гренада	gd
Грузия	ge
Французская Гвиана	gf
Гана	gh
Гибралтар	gi
Гренландия	gl
Гвинея	gn
Гваделупа	gp
Экваториальная Гвинея	gq
Греция	gr
Гренада	gt
Гуам	gu
Гвинея-Бисау	gw
Гайана	gy
Остров Херд и острова Макдональд	hm
Гондурас	hn
Хорватия	hr
Гаити	ht
Венгрия	hu
Индонезия	id
Ирландия	ie
Израиль	il
Остров Мэн	im
Индия	in
Британская территория в Индийском океане	io
Ирак	iq
Иран	ir
Исландия	is
Италия	it
Остров Джерси	je
Ямайка	jm
Иордания	jo
Япония	jp
Камбоджа	kh
Кирибати	ki
Коморы	km
Кувейт	kw
Каймановы острова	ky
Ливан	lb
Лихтенштейн	li
Шри-Ланка	lk
Либерия	lr
Лесото	ls
Литва	lt
Люксембург	lu
Латвия	lv
Ливия	ly
Марокко	ma
Монако	mc
Молдова	md
Черногория	me
Французский Сен-Мартен	mf
Мадагаскар	mg
Маршалловы Острова	mh
Македония	mk
Мали	ml
Мьянма	mm
Макао	mo
Мартиника	mq
Мавритания	mr
Остров Монсеррат	ms
Мальта	mt
Мальдивы	mv
Малави	mw
Мексика	mx
Малайзия	my
Намибия	na
Нигер	ne
Остров Норфолк	nf
Нигерия	ng
Никарагуа	ni
Нидерланды	nl
Норвегия	no
Непал	np
Науру	nr
Оман	om
Панама	pa
Перу	pe
Французская Полинезия	pf
Папуа - Новая Гвинея	pg
Филиппины	ph
Пакистан	pk
Польша	pl
Острова Питкэрн	pn
Пуэрто-Рико	pr
Палестина	ps
Палау	pw
Парагвай	py
Катар	qa
Реюньон	re
Румыния	ro
Сербия	rs
Россия	ru
Руанда	rw
Соломоновы Острова	sb
Сейшелы	sc
Судан	sd
Швеция	se
Сингапур	sg
Словения	si
Словакия	sk
Сьерра-Леоне	sl
Сан-Марино	sm
Сенегал	sn
Сомали	so
Суринам	sr
Южный Судан	ss
Сан-Томе и Принсипи	st
Сальвадор	sv
Сирия	sy
Свазиленд	sz
Острова Теркс и Кайкос	tc
Чад	td
Того	tg
Таиланд	th
Токелау	tk
Восточный Тимор	tl
Тунис	tn
Тонга	to
Турция	tr
Тувалу	tv
Танзания	tz
Украина	ua
Уганда	ug
Уругвай	uy
Ватикан	va
Венесуэла	ve
Британские Виргинские острова	vg
Американские Виргинские острова	vi
Вьетнам	vn
Уоллис и Футуна	wf
Самоа	ws
Йемен	ye
Майотта	yt
Южноафриканская Республика	za
Замбия	zm
Зимбабве	zw
Республика Конго (Браззавиль)	cg
Республика Конго (Киншаса)	cd
Мозамбик	mz
Гернси	gg
Гамбия	gm
Северные Марианские острова	mp
Эфиопия	et
Новая Каледония	nc
Вануату	vu
Французские Южные территории	tf
Нуйе	nu
Удаленные острова США	um
Острова Кука	ck
Великобритания	gb
Тринидад и Тобаго	tt
Сент-Винсент и Гренадины	vc
###	tw
Новая Зеландия	nz
Саудовская Аравия	sa
Лаос	la
Северная Корея	kp
Южная Корея	kr
Португалия	pt
Кыргызстан	kg
Казахстан	kz
Таджикистан	tj
Туркменистан	tm
Узбекистан	uz
Сент-Китс и Невис	kn
Сен-Пьер и Микелон	pm
Остров Святой Елены	sh
Сент-Люсия	lc
Маврикий	mu
Кот-д’Ивуар	ci
Кения	ke
Монголия	mn

Фиксация IP

Как и в вышеупомянутом содержании, мы можем зафиксировать IP на некоторое время, добавив в имя пользователя session и добавив 5-значное фиксированное число, срок действия которого составляет примерно 10 минут. Например, если вы хотите зафиксировать IP на некоторое время, исходное имя пользователя 1f78266a, вы можете изменить имя пользователя на 1f78266a-session-12345, где 12345, если не изменится, то IP останется неизменным на некоторое время, вышеупомянутый curl можно переписать следующим образом:

curl -x 1f78266a-session-12345:[email protected]:30007 https://ipinfo.io

Покупка больше

Если ваш пакет уже исчерпан, вам необходимо купить больше, чтобы продолжить использовать этот прокси-сервис. Чтобы купить больше, перейдите на «страницу заявки» и просто нажмите кнопку «Купить больше», чтобы выбрать, чем больше вы покупаете за раз, тем дешевле цена за единицу.

Documentation Index

​Метод подачи заявки

​Метод использования

​Тестирование команд

​Подключение к коду

​Фильтрация по региону

​Фиксация IP

​Покупка больше