> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Opis integracji mobilnego proxy komórkowego

> Cellular Rotation Proxy 集成指南 - XHuoAPI

W obliczu coraz intensywniejszej walki między botami a systemami przeciwdziałania botom, kontrola ryzyka na stronach internetowych i aplikacjach staje się coraz silniejsza, a jednym z działań jest blokada IP.

Aby rozwiązać problem blokady IP, skutecznym sposobem jest ustawienie proxy. Po skonfigurowaniu proxy, boty mogą korzystać z IP proxy, aby ukryć swoje prawdziwe adresy IP, co pozwala na obejście ograniczeń przeciwdziałania botom.

Jednak jakość proxy jest różna; na przykład, większość darmowych proxy dostępnych na rynku jest w zasadzie nieużyteczna lub zablokowana, a niektóre płatne, zwykłe proxy również zostały dodane do czarnych list kontrolnych wielu stron internetowych i aplikacji. Dlatego obecnie dostępnych jest coraz mniej proxy o wysokiej jakości, a wśród tych, które są dostępne, głównie wyróżniają się proxy dedykowane, proxy ADSL oraz mobilne proxy komórkowe.

Usługa proxy, którą oferujemy, opiera się na rotacyjnej usłudze proxy w sieci komórkowej (4G, 5G), a ten dokument opisuje sposób aplikacji i użytkowania tej usługi.

## Mobilne proxy komórkowe

Mobilne proxy komórkowe to usługa proxy oparta na ruchu danych z telefonów komórkowych, a wszystkie adresy IP proxy to prawdziwe adresy IP telefonów. Tego rodzaju proxy jest stosunkowo rzadko używane w dziedzinie botów, dlatego prawdopodobieństwo ich zablokowania jest mniejsze, co czyni je skutecznymi w przypadku pobierania danych z niektórych stron internetowych i aplikacji o wysokim poziomie kontroli ryzyka.

Nasza usługa proxy opiera się na dużej skali puli telefonów komórkowych, a cały ruch jest przekazywany przez prawdziwy ruch telefoniczny, co wspiera praktycznie wszystkie żądania danych na stronach internetowych i aplikacjach, zapewniając bardzo wysoką jakość proxy, co znacznie zmniejsza prawdopodobieństwo kontroli ryzyka.

## Metoda aplikacji

Aby skorzystać z usługi proxy komórkowego, można najpierw przejść do „[strony aplikacji](https://api.xhuoapi.ai/services/d8570fa7-8510-454e-913e-f1bd1b98338d)” w celu złożenia wniosku, a przy pierwszej aplikacji przysługuje 1 punkt darmowego limitu.

![](https://cdn.xhuoapi.ai/wed8yf.png)

Jeśli nie jesteś zalogowany, automatycznie zostaniesz przekierowany na stronę logowania, a po zalogowaniu możesz kontynuować aplikację.

## Metoda użytkowania

Po złożeniu wniosku można przejść do „Konsoli”, aby sprawdzić wyniki aplikacji, jak pokazano na obrazku:

![](https://cdn.xhuoapi.ai/db1js5.png)

Klikając „Credentials”, można zobaczyć nazwę użytkownika i hasło do korzystania z usługi proxy komórkowego, oddzielone dwukropkiem, gdzie nazwa użytkownika ma 8 znaków, a hasło 32 znaki, jak pokazano na obrazku:

![](https://cdn.xhuoapi.ai/54ffp0.png)

To mobilne proxy komórkowe jest rotacyjnym proxy, więc podczas korzystania wystarczy ustawić stały adres proxy i port, które wynoszą odpowiednio cellular.proxy.xhuoapi.ai i 30000. To proxy obsługuje protokoły HTTP/HTTPS/SOCKS i może być używane do żądań stron internetowych korzystających z protokołów HTTP i HTTPS.

## Testowanie poleceń

Po uzyskaniu nazwy użytkownika i hasła do proxy, najwygodniejszą metodą testowania jest użycie polecenia curl. Jeśli nie jest zainstalowane, proszę zapoznać się z [https://curl.se/](https://curl.se/) w celu instalacji.

Jeśli aktualna nazwa użytkownika i hasło proxy to `1f78266a:eff0896726224fa2a99fe82dd1f07562`, możemy użyć następującego polecenia curl do testowania:

```shell theme={null}
curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@cellular.proxy.xhuoapi.ai:30000 https://ipinfo.io
```

Tutaj używamy parametru `-x` w curl, aby określić adres proxy, a domyślnym protokołem proxy jest HTTP/HTTPS. Żądany adres URL to [https://ipinfo.io](https://ipinfo.io), a ta strona może zwrócić prawdziwy adres IP oraz lokalizację IP, która wysłała żądanie.

> Uwaga: powyższa nazwa użytkownika i hasło mogą być nieaktualne, proszę zastąpić je swoimi danymi.

Wynik działania wygląda następująco:

```json theme={null}
{
  "ip": "39.144.10.182",
  "city": "Shanghai",
  "region": "Shanghai",
  "country": "CN",
  "loc": "31.2222,121.4581",
  "org": "AS9808 China Mobile Communications Group Co., Ltd.",
  "postal": "200000",
  "timezone": "Asia/Shanghai",
  "readme": "https://ipinfo.io/missingauth"
}
```

Można zauważyć, że w zwróconym wyniku kraj to CN, co oznacza Chiny, a org to China Mobile, co oznacza sieć mobilną w Chinach, co potwierdza, że jest to wyjście z proxy komórkowego.

Jeśli uruchomisz ponownie, możesz uzyskać inny wynik, ponieważ każde żądanie korzysta z losowego wyjścia IP.

## Integracja kodu

Poniżej przedstawiamy przykład w Pythonie, jak skonfigurować to rotacyjne proxy komórkowe:

```python theme={null}
import requests

proxy = 'http://{proxy_username}:{proxy_password}@cellular.proxy.xhuoapi.ai:30000'

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

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

```

Najpierw deklarujemy URL proxy i definiujemy go jako zmienną proxy, protokół to http, a następnie podajemy nazwę użytkownika i hasło do rotacyjnego proxy (czyli nazwę użytkownika i hasło wyświetlane w konsoli, oddzielone dwukropkiem), a następnie dodajemy znak `@`, a po nim adres proxy i port.

Następnie deklarujemy zmienną proxies, konfigurując dwa klucze, których nazwy to http i https, a ich wartości to proxy, co oznacza, że dla stron internetowych korzystających z protokołów HTTP i HTTPS, używamy proxy zdefiniowanego w zmiennej proxy do wysyłania żądań.

Następnie definiujemy pętlę, która wykonuje testy proxy trzy razy, a żądany adres URL to [https://ipinfo.io](https://ipinfo.io), a ta strona może zwrócić prawdziwy adres IP oraz lokalizację IP, która wysłała żądanie.

Wynik działania wygląda następująco:

```json theme={null}
{
  "ip": "39.144.18.26",
  "city": "Szanghaj",
  "region": "Szanghaj",
  "country": "CN",
  "loc": "31.2222,121.4581",
  "org": "AS9808 China Mobile Communications Group Co., Ltd.",
  "postal": "200000",
  "timezone": "Asia/Szanghaj",
  "readme": "https://ipinfo.io/missingauth"
}
{
  "ip": "39.144.18.26",
  "city": "Szanghaj",
  "region": "Szanghaj",
  "country": "CN",
  "loc": "31.2222,121.4581",
  "org": "AS9808 China Mobile Communications Group Co., Ltd.",
  "postal": "200000",
  "timezone": "Asia/Szanghaj",
  "readme": "https://ipinfo.io/missingauth"
}
{
  "ip": "39.144.182.55",
  "city": "Zhanjiang",
  "region": "Guangdong",
  "country": "CN",
  "loc": "21.2339,110.3875",
  "org": "AS24445 Henan Mobile Communications Co.,Ltd",
  "postal": "524000",
  "timezone": "Asia/Szanghaj",
  "readme": "https://ipinfo.io/missingauth"
}
```

Można zauważyć, że wyniki uzyskiwane przy każdym uruchomieniu są losowe, a lokalizacja IP rzeczywiście pochodzi z prawdziwego ruchu mobilnego.

Oczywiście, powyższy sposób ustawienia proxy jest stosunkowo prosty.

W rzeczywistości powyższy kod jest równoważny ustawieniu dodatkowego nagłówka - Proxy Authorization podczas żądania, więc powyższy kod można również przepisać w następujący sposób:

```python theme={null}
import requests
import base64

proxy_host = 'cellular.proxy.xhuoapi.ai'
proxy_port = '30000'
proxy_username = '{proxy_username}' # 8-znakowa nazwa użytkownika
proxy_password = '{proxy_password}' # 32-znakowe hasło

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)

```

Można zauważyć, że tutaj dodatkowo ustawiliśmy nazwę użytkownika i hasło proxy za pomocą nagłówka Proxy-Authorization (które muszą być zakodowane w Base64), a efekt działania takiego kodu jest taki sam.

Dla innych języków, takich jak JavaScript z axios, można również użyć podobnego sposobu ustawienia:

```javascript theme={null}
const axios = require("axios");
const base64 = require("base64");

const proxy_host = "cellular.proxy.xhuoapi.ai";
const proxy_port = "30000";
const proxy_username = "{proxy_username}"; // 8-znakowa nazwa użytkownika
const proxy_password = "{proxy_password}"; // 32-znakowe hasło

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));
}
```

Efekt działania jest taki sam.

Dla metod ustawienia w innych językach proszę odwołać się do powyższego tekstu i samodzielnie przepisać.

## Zakup więcej

Jeśli Twój pakiet został już wyczerpany, musisz zakupić więcej, aby kontynuować korzystanie z tej usługi proxy.

Aby zakupić więcej, przejdź do „[strony zamówienia](https://api.xhuoapi.ai/services/d8570fa7-8510-454e-913e-f1bd1b98338d)” i kliknij przycisk „Kup więcej”, aby dokonać zakupu, im więcej kupisz jednorazowo, tym cena jednostkowa jest tańsza.