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

# グローバル代理接続説明

> Global Rotation Agent 集成指南 - Ace Data Cloud

本文書は、Ace Data Cloud グローバル代理の接続説明を主に紹介し、申請方法、使用方法などの具体的な内容を含みます。

## 申請方法

グローバルサービスを使用するには、まず「[申請ページ](https://platform.acedata.cloud/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」にアクセスして申請を行います。初回申請には 1 ポイントの無料枠があります。

![](https://cdn.acedata.cloud/cyzvmz.png)

まだログインしていない場合は、自動的にログインページにリダイレクトされます。ログイン後、申請を続けてください。

## 使用方法

申請が完了したら、「コントロールパネル」で自分の申請結果を確認できます。以下の図のように：

![](https://cdn.acedata.cloud/y9boi5.png)

「Credentials」をクリックすると、グローバル代理サービスのユーザー名とパスワードをコロンで区切って確認できます。ユーザー名は 8 桁、パスワードは 32 桁です。以下の図のように：

![](https://cdn.acedata.cloud/ixwm85.png)

この代理は回転プロキシ（Rotating Proxy）であるため、使用する際は固定のプロキシアドレスとポートを設定するだけで済みます。プロキシのアドレスとポートはそれぞれ `global.proxy.acedata.cloud` と `30007` です。このプロキシは HTTP/HTTPS/SOCKS プロトコルのプロキシであり、HTTP および HTTPS プロトコルのウェブサイトへのリクエストに使用できます。

> 注意：このプロキシは中国国外のネットワーク環境でのみ使用できます。中国本土では使用できません。

## コマンドテスト

プロキシのユーザー名とパスワードを取得したら、最も便利な方法は curl コマンドラインを使用してテストすることです。まだインストールしていない場合は、[https://curl.se/](https://curl.se/) を参照してインストールしてください。

現在のプロキシのユーザー名とパスワードが `1f78266a:eff0896726224fa2a99fe82dd1f07562` の場合、以下の curl コマンドを使用してテストできます：

```shell theme={null}
curl -x 1f78266a:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007 https://ipinfo.io
```

ここでは、curl の `-x` パラメータを使用してプロキシアドレスを指定しました。プロキシプロトコルはデフォルトで HTTP/HTTPS であり、ここでリクエストしている URL は [https://ipinfo.io](https://ipinfo.io) です。このサイトは、リクエストを行ったサイトの実際の IP アドレスとその地域を返すことができます。

> 注意：上記のユーザー名とパスワードは無効な場合がありますので、自分のユーザー名とパスワードに置き換えてください。

実行結果は以下の通りです：

```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"
}
```

返された結果の country は CA で、カナダを示しています。再度実行すると、異なる結果が得られます。毎回のリクエストはランダムな IP 出口です。

## コード接続

以下に Python を例にして、このプロキシの設定方法を示します：

```python theme={null}
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 変数を宣言し、2 つのキーと値のペアを設定しました。キー名はそれぞれ http と https で、値はどちらも proxy であり、HTTP および HTTPS プロトコルのウェブサイトに対して、proxy 変数で定義されたプロキシを使用してリクエストを行います。次に、3 回のループを定義してプロキシのテストを行います。

実行結果は以下の通りです：

```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"
}
```

毎回の実行結果で得られるプロキシ IP はランダムであり、IP の所在地域は確かに世界の異なる国や都市からのものであることがわかります。

もちろん、上記のプロキシ設定方法は実際には比較的簡潔な設定方法です。

実際には、上記のコードはリクエスト時に追加のヘッダー - Proxy Authorization を設定しているため、上記のコードは次のように書き換えることもできます：

```python theme={null}
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 でも、同様の設定方法を使用できます：

```javascript theme={null}
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));
}
```

実行結果はすべて同じです。

他の言語の設定方法については、上記を参考にして自分で書き換えてください。

## 地域フィルタリング

ユーザー名に地域を追加することで地域のフィルタリングを行うことができます。例えば、アメリカのプロキシを選択したい場合、元のユーザー名が `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 固定

和上述内容一样，我们可以通过在 username 里面添加 `session` 并添加一个 5 位固定数字，来实现一段时间内的 IP 固定，有效期大约 10 分钟。

例如如果要实现一段时间内的 IP 固定，原来的 username 是 `1f78266a`，则可以把 username 修改为 `1f78266a-session-12345`，其中的 `12345` 如果不变，那么一段时间内 IP 就不变，上述的 curl 就可以改写如下：

```
curl -x 1f78266a-session-12345:eff0896726224fa2a99fe82dd1f07562@global.proxy.acedata.cloud:30007 https://ipinfo.io
```

## 购买更多

如您的套餐已经耗尽，您需要购买更多才能继续使用该代理服务。

要购买更多，请到「[申请页面](https://platform.acedata.cloud/services/87ae4a5a-59d9-4c50-86d4-c0b5d393e5af)」直接点击「购买更多」按钮即可选购，单次购买更多，单价越便宜。