الانتقال إلى المحتوى الرئيسي
تتناول هذه الوثيقة توضيح الربط مع وكلاء Ace Data Cloud العالميين، بما في ذلك طرق التقديم وطرق الاستخدام وغيرها من المحتويات المحددة.

​
طرق التقديم

لاستخدام الخدمة العالمية، يمكنك أولاً الذهاب إلى 「صفحة التقديم」 لتقديم الطلب، حيث يوجد رصيد مجاني قدره 1 نقطة للتقديم الأول. إذا لم تكن قد قمت بتسجيل الدخول بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول، وبعد تسجيل الدخول يمكنك متابعة التقديم.

​
طرق الاستخدام

بعد تقديم الطلب، يمكنك الذهاب إلى 「لوحة التحكم」 لرؤية نتائج طلبك، كما هو موضح في الصورة: انقر على 「Credentials」، لرؤية اسم المستخدم وكلمة المرور لاستخدام خدمة الوكيل العالمي، مفصولة بنقطتين، حيث يكون اسم المستخدم مكونًا من 8 أحرف، وكلمة المرور مكونة من 32 حرفًا، كما هو موضح في الصورة: هذا الوكيل هو نوع من الوكلاء المتناوبين (Rotating Proxy)، لذا عند الاستخدام، تحتاج فقط إلى إعداد عنوان وكيل ثابت ورقم منفذ، حيث أن عنوان الوكيل ورقم المنفذ هما global.proxy.acedata.cloud و 30007، هذا الوكيل يدعم بروتوكولات HTTP/HTTPS/SOCKS، ويمكن استخدامه لطلب مواقع الويب التي تدعم بروتوكولات HTTP و HTTPS.
ملاحظة: هذا الوكيل يمكن استخدامه فقط في بيئات الشبكة خارج الصين، ولا يمكن استخدامه في البر الرئيسي للصين.

​
اختبار الأوامر

بعد الحصول على اسم المستخدم وكلمة المرور للوكيل، فإن أسهل طريقة هي استخدام أمر curl للاختبار، إذا لم تكن قد قمت بتثبيته، يرجى الرجوع إلى https://curl.se/ للتثبيت. إذا كانت اسم المستخدم وكلمة المرور الحالية للوكيل هي 1f78266a:eff0896726224fa2a99fe82dd1f07562، يمكننا استخدام أمر curl التالي للاختبار: 
curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007 https://ipinfo.io
هنا نستخدم معامل -x في curl لتحديد عنوان الوكيل، وبروتوكول الوكيل هو 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.acedata.cloud: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:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud: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.acedata.cloud'
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.acedata.cloud";
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:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud: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:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007 https://ipinfo.io

​
شراء المزيد

إذا كانت باقتك قد نفدت، ستحتاج إلى شراء المزيد للاستمرار في استخدام خدمة الوكيل هذه. لشراء المزيد، يرجى الذهاب إلى 「صفحة الطلب」 والنقر مباشرة على زر 「شراء المزيد」 لاختيار، كلما زادت الكمية المشتراة، كان السعر أقل.