> ## 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. # Globale Proxy-Integration Anleitung > Global Rotation Agent 集成指南 - XHuoAPI Dieses Dokument beschreibt die Integration des XHuoAPI globalen Proxys, einschließlich Antragsmethoden, Nutzungsmethoden und weiteren spezifischen Inhalten. ## Antragsmethoden Um die globalen Dienste nutzen zu können, können Sie zunächst die „[Antragsseite](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)“ besuchen, um einen Antrag zu stellen. Bei der ersten Antragstellung gibt es ein kostenloses Kontingent von 1 Punkt. ![](https://cdn.xhuoapi.ai/cyzvmz.png) Wenn Sie noch nicht eingeloggt sind, werden Sie automatisch zur Anmeldeseite weitergeleitet. Nach dem Einloggen können Sie mit dem Antrag fortfahren. ## Nutzungsmethoden Nach dem Antrag können Sie in der „Konsole“ die Ergebnisse Ihres Antrags einsehen, wie im Bild gezeigt: ![](https://cdn.xhuoapi.ai/y9boi5.png) Klicken Sie auf „Credentials“, um den Benutzernamen und das Passwort für die Nutzung des globalen Proxy-Dienstes anzuzeigen, die durch einen Doppelpunkt getrennt sind. Der Benutzername besteht aus 8 Zeichen, das Passwort aus 32 Zeichen, wie im Bild gezeigt: ![](https://cdn.xhuoapi.ai/ixwm85.png) Dieser Proxy ist ein Rotating Proxy, daher müssen Sie beim Gebrauch nur eine feste Proxy-Adresse und einen Port einstellen. Die Adresse und der Port des Proxys sind `global.proxy.xhuoapi.ai` und `30007`. Dieser Proxy unterstützt die Protokolle HTTP/HTTPS/SOCKS und kann für Anfragen an Websites, die HTTP- und HTTPS-Protokolle verwenden, genutzt werden. > Hinweis: Dieser Proxy kann nur außerhalb des chinesischen Netzwerks verwendet werden. In Festlandchina ist die Nutzung nicht möglich. ## Befehls-Test Nachdem Sie den Benutzernamen und das Passwort des Proxys haben, ist die einfachste Methode, dies über den curl-Befehlszeilenbefehl zu testen. Wenn Sie curl noch nicht installiert haben, können Sie sich an [https://curl.se/](https://curl.se/) orientieren. Angenommen, der aktuelle Benutzername und das Passwort des Proxys sind `1f78266a:eff0896726224fa2a99fe82dd1f07562`, können wir den folgenden curl-Befehl zum Testen verwenden: ```shell theme={null} curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Hier verwenden wir den `-x` Parameter von curl, um die Proxy-Adresse anzugeben. Das Proxy-Protokoll ist standardmäßig HTTP/HTTPS. Die angeforderte URL ist [https://ipinfo.io](https://ipinfo.io), diese Seite kann die echte IP-Adresse und den Standort der IP zurückgeben, die die Seite anfordert. > Hinweis: Der oben genannte Benutzername und das Passwort könnten ungültig sein. Bitte ersetzen Sie sie durch Ihren Benutzernamen und Ihr Passwort. Das Ergebnis sieht wie folgt aus: ```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" } ``` Wie zu sehen ist, ist das zurückgegebene Land CA, was Kanada bedeutet. Wenn Sie den Befehl erneut ausführen, können Sie unterschiedliche Ergebnisse erhalten, da jede Anfrage eine zufällige IP-Adresse verwendet. ## Code-Integration Im Folgenden wird anhand von Python gezeigt, wie der Proxy eingerichtet wird: ```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) ``` Hier haben wir zunächst die URL des Proxys deklariert und als proxy-Variable definiert. Das Protokoll ist HTTP, gefolgt von dem Benutzernamen und Passwort des Tunnel-Proxys (d.h. dem in der Konsole angezeigten Benutzernamen und Passwort, die durch einen Doppelpunkt getrennt sind), gefolgt von einem `@`-Symbol und dann der Adresse und dem Port des Proxys. > Hinweis: Sie müssen `{proxy_username}:{proxy_password}` in dem obigen Code durch Ihren Benutzernamen und Ihr Passwort ersetzen. Das endgültige Ergebnis sieht ähnlich aus wie `proxy = 'http://1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007'`, beachten Sie, dass keine `{` und `}` Zeichen vorhanden sind. Dann haben wir eine proxies-Variable deklariert, die zwei Schlüssel-Wert-Paare konfiguriert, wobei die Schlüssel `http` und `https` sind und beide den Wert proxy haben, was bedeutet, dass für Websites, die HTTP- und HTTPS-Protokolle verwenden, der über die proxy-Variable definierte Proxy verwendet wird. Anschließend haben wir eine Schleife mit drei Durchläufen definiert, um den Proxy zu testen. Das Ergebnis sieht wie folgt aus: ```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" } ``` Wie zu sehen ist, sind die Proxy-IP-Adressen, die bei jedem Lauf zurückgegeben werden, zufällig, und die IPs stammen tatsächlich aus verschiedenen Ländern und Städten weltweit. Natürlich ist die oben beschriebene Methode zur Proxy-Einrichtung tatsächlich eine relativ einfache Methode. Tatsächlich ist der obige Code äquivalent dazu, bei der Anfrage einen zusätzlichen Header - Proxy Authorization - einzustellen, sodass der obige Code auch wie folgt umgeschrieben werden kann: ```python theme={null} import requests import base64 proxy_host = 'global.proxy.xhuoapi.ai' proxy_port = '30007' proxy_username = '{proxy_username}' # 8-stelliger Benutzername proxy_password = '{proxy_password}' # 32-stelliges Passwort 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) ``` Hier haben wir durch den Header Proxy-Authorization zusätzlich den Benutzernamen und das Passwort des Proxys festgelegt (die Base64-Kodierung ist erforderlich). Das Ergebnis der Ausführung des Codes ist dasselbe. Für andere Sprachen, wie z.B. JavaScript mit axios, kann eine ähnliche Einstellungsmethode verwendet werden: ```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-stelliger Benutzername const proxy_password = "{proxy_password}"; // 32-stelliges Passwort 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)); } ``` Die Ausführungsergebnisse sind alle gleich. Für die Einstellungen in anderen Sprachen können Sie sich auf den obigen Text beziehen und ihn entsprechend umschreiben. ## Regionale Filterung Wir können durch das Hinzufügen von region im Benutzernamen eine regionale Filterung vornehmen. Wenn wir beispielsweise einen Proxy in den USA auswählen möchten und der ursprüngliche Benutzername `1f78266a` ist, können wir den Benutzernamen in `1f78266a-region-us` ändern. Der obige curl kann dann wie folgt umgeschrieben werden: ``` curl -x 1f78266a-region-us:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` Regionenliste: | Länder- oder Regionsname | Länder-/Regionscode | | ----------------------------------------- | ------------------- | | Vereinigte Staaten | us | | Hongkong | hk | | Andorra | ad | | Vereinigte Arabische Emirate | ae | | Afghanistan | af | | Antigua und Barbuda | ag | | Anguilla | ai | | Albanien | al | | Armenien | am | | Angola | ao | | Antarktis | aq | | Argentinien | ar | | Amerikanisch-Samoa | as | | Österreich | at | | Australien | au | | Aruba | aw | | Ålandinseln | ax | | Aserbaidschan | az | | Bosnien und Herzegowina | ba | | Barbados | bb | | Bangladesch | bd | | Belgien | be | | Burkina Faso | bf | | Bulgarien | bg | | Bahrain | bh | | Burundi | bi | | Benin | bj | | Saint-Barthélemy | bl | | Bermuda | bm | | Brunei | bn | | Bolivien | bo | | Niederländische Karibik | bq | | Brasilien | br | | Bahamas | bs | | Bhutan | bt | | Bouvetinsel | bv | | Botswana | bw | | Weißrussland | by | | Belize | bz | | Kanada | ca | | Kokosinseln | cc | | Zentralafrikanische Republik | cf | | Schweiz | ch | | Chile | cl | | Kamerun | cm | | Kolumbien | co | | Costa Rica | cr | | Kuba | cu | | Kap Verde | cv | | Weihnachtsinsel | cx | | Zypern | cy | | Tschechische Republik | cz | | Deutschland | de | | Dschibuti | dj | | Dänemark | dk | | Dominica | dm | | Dominikanische Republik | do | | Algerien | dz | | Ecuador | ec | | Estland | ee | | Ägypten | eg | | Westsahara | eh | | Eritrea | er | | Spanien | es | | Finnland | fi | | Fidschi | fj | | Vereinigte Staaten von Mikronesien | fm | | Färöer | fo | | Frankreich | fr | | Gabun | ga | | Grenada | gd | | Georgien | ge | | Französisch-Guayana | gf | | Ghana | gh | | Gibraltar | gi | | Grönland | gl | | Guinea | gn | | Guadeloupe | gp | | Äquatorialguinea | gq | | Griechenland | gr | | Guatemala | gt | | Guam | gu | | Guinea-Bissau | gw | | Guyana | gy | | Heard und McDonald-Inseln | hm | | Honduras | hn | | Kroatien | hr | | Haiti | ht | | Ungarn | hu | | Indonesien | id | | Irland | ie | | Israel | il | | Isle of Man | im | | Indien | in | | Britisches Territorium im Indischen Ozean | io | | Irak | iq | | Iran | ir | | Island | is | | Italien | it | | Jersey | je | | Jamaika | jm | | Jordanien | jo | | Japan | jp | | Kambodscha | kh | | Kiribati | ki | | Komoren | km | | Kuwait | kw | | Kaimaninseln | ky | | Libanon | lb | | Liechtenstein | li | | Sri Lanka | lk | | Liberia | lr | | Lesotho | ls | | Litauen | lt | | Luxemburg | lu | | Lettland | lv | | Libyen | ly | | Marokko | ma | | Monaco | mc | | Moldawien | md | | Montenegro | me | | Französisch-Guadeloupe | mf | | Madagaskar | mg | | Marshallinseln | mh | | Nordmazedonien | mk | | Mali | ml | | Myanmar | mm | | Macao | mo | | Martinique | mq | | Mauretanien | mr | | Montserrat | ms | | Malta | mt | | Malediven | mv | | Malawi | mw | | Mexiko | mx | | Malaysia | my | | Namibia | na | | Niger | ne | | Norfolkinsel | nf | | Nigeria | ng | | Nicaragua | ni | | Niederlande | nl | | Norwegen | no | | Nepal | np | | Nauru | nr | | Oman | om | | Panama | pa | | Peru | pe | | Französisch-Polynesien | pf | | Papua-Neuguinea | pg | | Philippinen | ph | | Pakistan | pk | | Polen | pl | | Pitcairninseln | pn | | Puerto Rico | pr | | Palästina | ps | | Palau | pw | | Paraguay | py | | Katar | qa | | Réunion | re | | Rumänien | ro | | Serbien | rs | | Russland | ru | | Ruanda | rw | | Salomonen | sb | | Seychellen | sc | | Sudan | sd | | Schweden | se | | Singapur | sg | | Slowenien | si | | Slowakei | sk | | Sierra Leone | sl | | San Marino | sm | | Senegal | sn | | Somalia | so | | Suriname | sr | | Südsudan | ss | | São Tomé und Príncipe | st | | El Salvador | sv | | Syrien | sy | | Eswatini | sz | | Turks- und Caicosinseln | tc | | Tschad | td | | Togo | tg | | Thailand | th | | Tokelau | tk | | Osttimor | tl | | Tunesien | tn | | Tonga | to | | Türkei | tr | | Tuvalu | tv | | Tansania | tz | | Ukraine | ua | | Uganda | ug | | Uruguay | uy | | Vatikanstadt | va | | Venezuela | ve | | Britische Jungferninseln | vg | | Amerikanische Jungferninseln | vi | | Vietnam | vn | | Wallis und Futuna | wf | | Samoa | ws | | Jemen | ye | | Mayotte | yt | | Südafrika | za | | Sambia | zm | | Simbabwe | zw | | Kongo (Republik) | cg | | Kongo (Demokratische Republik) | cd | | Mosambik | mz | | Guernsey | gg | | Gambia | gm | | Nördliche Marianen | mp | | Äthiopien | et | | Neukaledonien | nc | | Vanuatu | vu | | Französische Südgebiete | tf | | Niue | nu | | US-amerikanische Überseeinseln | um | | Cookinseln | ck | | Vereinigtes Königreich | gb | | Trinidad und Tobago | tt | | St. Vincent und die Grenadinen | vc | | **###** | tw | | Neuseeland | nz | | Saudi-Arabien | sa | | Laos | la | | Nordkorea | kp | | Südkorea | kr | | Portugal | pt | | Kirgisistan | kg | | Kasachstan | kz | | Tadschikistan | tj | | Turkmenistan | tm | | Usbekistan | uz | | St. Kitts und Nevis | kn | | St. Pierre und Miquelon | pm | | St. Helena | sh | | St. Lucia | lc | | Mauritius | mu | | Côte d'Ivoire | ci | | Kenia | ke | | Mongolei | mn | ## IP Fixierung Wie im obigen Inhalt beschrieben, können wir durch das Hinzufügen von `session` im Benutzernamen und einer 5-stelligen festen Zahl eine IP-Fixierung für eine gewisse Zeit erreichen, die etwa 10 Minuten gültig ist. Wenn wir beispielsweise eine IP-Fixierung für eine gewisse Zeit erreichen möchten und der ursprüngliche Benutzername `1f78266a` ist, können wir den Benutzernamen in `1f78266a-session-12345` ändern, wobei `12345` unverändert bleibt, sodass die IP für eine gewisse Zeit gleich bleibt. Der obige curl-Befehl kann wie folgt umgeschrieben werden: ``` curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.xhuoapi.ai:30007 https://ipinfo.io ``` ## Mehr kaufen Wenn Ihr Paket bereits aufgebraucht ist, müssen Sie mehr kaufen, um diesen Proxy-Dienst weiterhin nutzen zu können. Um mehr zu kaufen, gehen Sie bitte zur „[Antragsseite](https://api.xhuoapi.ai/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)“ und klicken Sie direkt auf die Schaltfläche „Mehr kaufen“, um auszuwählen. Je mehr Sie auf einmal kaufen, desto günstiger ist der Einzelpreis.