> ## 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. # Global Proxy Integration Instructions > Global Rotation Agent 集成指南 - XHuoAPI Dokument ten głównie przedstawia instrukcje dotyczące integracji globalnego agenta XHuoAPI, w tym metody aplikacji, metody użytkowania i inne szczegóły. ## Metoda aplikacji Aby korzystać z globalnych usług, można najpierw przejść do „[strony aplikacji](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)”, aby złożyć wniosek, pierwsza aplikacja ma 1 punkt darmowego limitu. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Jeśli nie jesteś zalogowany, automatycznie zostaniesz przekierowany na stronę logowania, 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 rysunku: ![](https://cdn.xhuoapi.ai/y9boi5.png) Klikając „Credentials”, można zobaczyć nazwę użytkownika i hasło do korzystania z globalnych usług proxy, oddzielone dwukropkiem, gdzie nazwa użytkownika ma 8 znaków, a hasło 32 znaki, jak pokazano na rysunku: ![](https://cdn.xhuoapi.ai/ixwm85.png) Ten agent to rodzaj agenta rotacyjnego (Rotating Proxy), dlatego podczas korzystania wystarczy ustawić stały adres proxy i port, które wynoszą odpowiednio `global.proxy.xhuoapi.ai` i `30007`. Ten agent obsługuje protokoły HTTP/HTTPS/SOCKS i może być używany do żądań stron internetowych protokołu HTTP i HTTPS. > Uwaga: Ten agent może być używany tylko w sieci poza Chinami, nie jest dostępny w Chinach kontynentalnych. ## Testowanie poleceń Mając nazwę użytkownika i hasło agenta, najwygodniejszą metodą jest przetestowanie za pomocą 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 agenta to `1f78266a:eff0896726224fa2a99fe82dd1f07562`, możemy przetestować za pomocą następującego polecenia curl: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Tutaj używamy parametru `-x` w curl, aby określić adres proxy, protokół proxy domyślnie to HTTP/HTTPS, a żądany URL to [https://ipinfo.io](https://ipinfo.io), ta strona może zwrócić prawdziwy adres IP i lokalizację IP żądającego tej strony. > Uwaga: Powyższa nazwa użytkownika i hasło mogą być nieaktualne, proszę zastąpić je swoimi danymi. Wynik działania jest następujący: ```json theme={null} { "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" } ``` Można zauważyć, że w zwróconym wyniku kraj to CA, co oznacza Kanadę. Jeśli uruchomisz ponownie, możesz uzyskać inny wynik, każde żądanie to losowe wyjście IP. ## Integracja kodu Poniżej przedstawiono przykład ustawienia tego agenta w Pythonie: ```python theme={null} 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) ``` Najpierw zadeklarowaliśmy URL agenta i zdefiniowaliśmy go jako zmienną proxy, protokół to http, a następnie podano nazwę użytkownika i hasło tunelowego agenta (czyli nazwę użytkownika i hasło wyświetlane w konsoli, oddzielone dwukropkiem), a następnie dodano znak `@`, a potem adres proxy i port. > Uwaga: Należy zastąpić `{proxy_username}:{proxy_password}` w powyższym kodzie swoimi danymi, a ostateczny wynik powinien wyglądać jak `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, pamiętaj, aby nie używać znaków `{` i `}`. Następnie zadeklarowano zmienną proxies, która konfiguruje dwa pary klucz-wartość, gdzie klucze to http i https, a ich wartości to proxy, co oznacza, że dla stron internetowych protokołu HTTP i HTTPS używany jest agent zdefiniowany w zmiennej proxy. Następnie zdefiniowano trzy pętle do testowania agenta. Wynik działania jest następujący: ```python theme={null} { "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" } ``` Można zauważyć, że za każdym razem, gdy uruchamiasz, uzyskujesz losowe IP agenta, a lokalizacja IP rzeczywiście pochodzi z różnych krajów i miast na całym świecie. Oczywiście, powyższa metoda ustawienia agenta jest stosunkowo prostą metodą. 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 = 'global.proxy.xhuoapi.ai' proxy_port = '30007' 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 agenta 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ć podobnej metody ustawienia: ```javascript theme={null} 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-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. W przypadku ustawień w innych językach, proszę odwołać się do powyższego i dostosować według własnych potrzeb. ## Filtrowanie według regionu Możemy filtrować według regionu, dodając region do nazwy użytkownika, na przykład, jeśli chcemy wybrać proxy z USA, oryginalna nazwa użytkownika to `1f78266a`, więc możemy zmienić nazwę użytkownika na `1f78266a-region-us`, powyższy curl można zmienić w następujący sposób: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Lista regionów: | Nazwa kraju lub regionu | Kod kraju/regionu | | ---------------------------------------- | ----------------- | | Stany Zjednoczone | us | | Hongkong | hk | | Andora | ad | | Zjednoczone Emiraty Arabskie | ae | | Afganistan | af | | Antigua i Barbuda | ag | | Anguilla | ai | | Albania | al | | Armenia | am | | Angola | ao | | Antarktyda | aq | | Argentyna | ar | | Amerykańska Samoa | as | | Austria | at | | Australia | au | | Aruba | aw | | Wyspy Alandzkie | ax | | Azerbejdżan | az | | Bośnia i Hercegowina | ba | | Barbados | bb | | Bangladesz | bd | | Belgia | be | | Burkina Faso | bf | | Bułgaria | bg | | Bahrajn | bh | | Burundi | bi | | Benin | bj | | Saint Barthélemy | bl | | Bermudy | bm | | Brunei | bn | | Boliwia | bo | | Karaiby Niderlandzkie | bq | | Brazylia | br | | Bahamy | bs | | Bhutan | bt | | Wyspa Bouvet | bv | | Botswana | bw | | Białoruś | by | | Belize | bz | | Kanada | ca | | Wyspy Kokosowe | cc | | Republika Środkowoafrykańska | cf | | Szwajcaria | ch | | Chile | cl | | Kamerun | cm | | Kolumbia | co | | Kostaryka | cr | | Kuba | cu | | Wyspy Zielonego Przylądka | cv | | Wyspa Bożego Narodzenia | cx | | Cypr | cy | | Czechy | cz | | Niemcy | de | | Dżibuti | dj | | Dania | dk | | Dominika | dm | | Dominikana | do | | Algieria | dz | | Ekwador | ec | | Estonia | ee | | Egipt | eg | | Sahara Zachodnia | eh | | Erytrea | er | | Hiszpania | es | | Finlandia | fi | | Fidżi | fj | | Stany Zjednoczone Mikronezji | fm | | Wyspy Owcze | fo | | Francja | fr | | Gabon | ga | | Grenada | gd | | Gruzja | ge | | Gujana Francuska | gf | | Ghana | gh | | Gibraltar | gi | | Grenlandia | gl | | Gwinea | gn | | Gwadelupa | gp | | Gwinea Równikowa | gq | | Grecja | gr | | Gwatemala | gt | | Guam | gu | | Gwinea Bissau | gw | | Gujana | gy | | Wyspa Heard i Wyspy McDonalda | hm | | Honduras | hn | | Chorwacja | hr | | Haiti | ht | | Węgry | hu | | Indonezja | id | | Irlandia | ie | | Izrael | il | | Wyspa Man | im | | Indie | in | | Brytyjskie Terytorium Oceanu Indyjskiego | io | | Irak | iq | | Iran | ir | | Islandia | is | | Włochy | it | | Wyspa Jersey | je | | Jamajka | jm | | Jordania | jo | | Japonia | jp | | Kambodża | kh | | Kiribati | ki | | Komory | km | | Kuwejt | kw | | Wyspy Kajman | ky | | Liban | lb | | Liechtenstein | li | | Sri Lanka | lk | | Liberia | lr | | Lesotho | ls | | Litwa | lt | | Luksemburg | lu | | Łotwa | lv | | Libia | ly | | Maroko | ma | | Monako | mc | | Mołdawia | md | | Czarnogóra | me | | Francuska Saint-Martin | mf | | Madagaskar | mg | | Wyspy Marshalla | mh | | Macedonia | mk | | Mali | ml | | Mjanma | mm | | Makau | mo | | Martynika | mq | | Mauretania | mr | | Montserrat | ms | | Malta | mt | | Malediwy | mv | | Malawi | mw | | Meksyk | mx | | Malezja | my | | Namibia | na | | Niger | ne | | Wyspa Norfolk | nf | | Nigeria | ng | | Nikaragua | ni | | Holandia | nl | | Norwegia | no | | Nepal | np | | Nauru | nr | | Oman | om | | Panama | pa | | Peru | pe | | Francuska Polinezja | pf | | Papua-Nowa Gwinea | pg | | Filipiny | ph | | Pakistan | pk | | Polska | pl | | Wyspy Pitcairn | pn | | Portoryko | pr | | Palestyna | ps | | Palau | pw | | Paragwaj | py | | Katar | qa | | Reunion | re | | Rumunia | ro | | Serbia | rs | | Rosja | ru | | Rwanda | rw | | Wyspy Salomona | sb | | Seszele | sc | | Sudan | sd | | Szwecja | se | | Singapur | sg | | Słowenia | si | | Słowacja | sk | | Sierra Leone | sl | | San Marino | sm | | Senegal | sn | | Somalia | so | | Surinam | sr | | Sudan Południowy | ss | | Wyspy Świętego Tomasza i Książęca | st | | Salwador | sv | | Syria | sy | | Eswatini | sz | | Wyspy Turks i Caicos | tc | | Czad | td | | Togo | tg | | Tajlandia | th | | Tokelau | tk | | Timor Wschodni | tl | | Tunezja | tn | | Tonga | to | | Turcja | tr | | Tuvalu | tv | | Tanzania | tz | | Ukraina | ua | | Uganda | ug | | Urugwaj | uy | | Watykan | va | | Wenezuela | ve | | Brytyjskie Wyspy Dziewicze | vg | | Amerykańskie Wyspy Dziewicze | vi | | Wietnam | vn | | Wallis i Futuna | wf | | Samoa | ws | | Jemen | ye | | Majotta | yt | | Republika Południowej Afryki | za | | Zambia | zm | | Zimbabwe | zw | | Kongo (B) | cg | | Kongo (DR) | cd | | Mozambik | mz | | Guernsey | gg | | Gambia | gm | | Wyspy Mariany Północne | mp | | Etiopia | et | | Nowa Kaledonia | nc | | Vanuatu | vu | | Francuskie Terytoria Południowe | tf | | Niue | nu | | Wyspy Amerykańskie (terytoria) | um | | Wyspy Cooka | ck | | Wielka Brytania | gb | | Trynidad i Tobago | tt | | Saint Vincent i Grenadyny | vc | | **###** | tw | | Nowa Zelandia | nz | | Arabia Saudyjska | sa | | Laos | la | | Korea Północna | kp | | Korea Południowa | kr | | Portugalia | pt | | Kirgistan | kg | | Kazachstan | kz | | Tadżykistan | tj | | Turkmenistan | tm | | Uzbekistan | uz | | Saint Kitts i Nevis | kn | | Saint Pierre i Miquelon | pm | | Wyspa Świętej Heleny | sh | | Saint Lucia | lc | | Mauritius | mu | | Wybrzeże Kości Słoniowej | ci | | Kenia | ke | | Mongolia | mn | ## IP stały Podobnie jak w powyższej treści, możemy uzyskać stały adres IP przez dodanie `session` do nazwy użytkownika i dodanie 5-cyfrowej stałej liczby, co zapewni stały adres IP przez około 10 minut. Na przykład, jeśli chcemy uzyskać stały adres IP przez pewien czas, a oryginalna nazwa użytkownika to `1f78266a`, możemy zmienić nazwę użytkownika na `1f78266a-session-12345`, gdzie `12345`, jeśli pozostanie niezmienione, zapewni stały adres IP przez pewien czas. Powyższe polecenie curl można zmienić w następujący sposób: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## 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 aplikacji](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)” i kliknij bezpośrednio przycisk „Kup więcej”, aby dokonać zakupu. Im więcej kupujesz jednorazowo, tym cena jednostkowa jest tańsza.