コンテンツにスキップ

ProxyMarket コネクター:コード不要でプロキシを販売

AIに質問

用意済みタスクサーバーにpm-connectorをインストールして設定する

コーディングエージェント

Claude Codeデスクトップアプリを開きますCodexデスクトップアプリを開きますCursorWebからアプリを開きます

チャットアシスタント

ChatGPTで開く新しいタブClaudeで開く新しいタブ

コピー

Markdownで表示AIツール向けのプレーンテキスト
プロンプトを見る
I run proxies on my own servers and want to sell them on ProxyMarket (market.xproxy.io) with pm-connector. Read https://xproxy.io/document/proxymarket-connector.md. If you cannot open links, download them with curl.
Then, on this machine:
1. Find out how a customer gets a proxy username and password here, and how they are deleted: the API of my panel or backend, or a password file of my proxy software. Ask me what you cannot find.
2. Install pm-connector and run pm-connector init with me. When it asks whether ProxyMarket can reach this server, answer No unless I tell you I forwarded a port or have a public address. I paste the key myself.
3. Write the script in the language my system already uses, following "the script standard" on the page, or start from the closest ready one (pm-connector sample shows them) and change it: the create and delete actions first, then rotate, whitelist and list only if my system can do them (delete the others).
4. Run pm-connector test and fix every ❌ line. Show me what my script printed when an action fails.
5. Install it as a service.
6. Tell me which plans to add in the Vendor Dashboard (name, country, price, proxy IP and port) and remind me to send a test order.
Never print or commit my API keys, passwords or customer logins. Ask me before you open firewall ports, restart services or change config files you did not create.
Other XProxy guides, each with a Markdown copy at its URL + .md, are listed in https://xproxy.io/llms.txt.
I am reading this page in Japanese: https://xproxy.io/ja/document/proxymarket-connector. The Markdown copy is in English. Answer in Japanese.

プロンプトが入力された状態でアプリが開きます。Enterを押すまで何も実行されません。

あなたはすでに自分のサーバーでプロキシを販売しています。pm-connector は、ProxyMarket があなたの代わりにそれを販売できるようにする小さなプログラムです。顧客が支払うと、その顧客をあなたのプロキシに入れます。レンタルが終わると、再び締め出します。ドメインやポートの開放は不要です。

必要なもの:market.xproxy.io のベンダーアカウント、プロキシのパネルまたはパスワードファイルにアクセスできる Linux か Windows のサーバー、インターネットから顧客が接続できるプロキシ。

仕組みは?

プロキシを手作業で販売するとき、やることは 2 つです。購入者のユーザー名とパスワードを作り、レンタルが終わったら削除します。コネクターは、あなたのスクリプト 1 つを使って、すべての注文で同じことを行います:

1 件の注文の始まりから終わりまで
1. A customer buys your plan "US T-Mobile, 30 days"
   (your proxy: 203.0.113.5, port 31001).

2. The connector makes up a login for this customer:
       username   pm_9b1c2d3e4f506172
       password   k7m2xq4wyhn3bt5d

3. It runs YOUR script and tells it to add that login:
       python3 panel.py create
           PM_USERNAME = pm_9b1c2d3e4f506172
           PM_PASSWORD = k7m2xq4wyhn3bt5d
           PM_PORT     = 31001

4. The customer gets 203.0.113.5:31001 with that username and password.

5. 30 days later it runs YOUR script again, to delete the login:
       python3 panel.py delete
           PM_USERNAME = pm_9b1c2d3e4f506172

顧客のユーザー名やパスワードをあなたが決めることはありません。コネクターが作成し、スクリプトに渡します。顧客の通信がコネクターや ProxyMarket を通ることはなく、顧客はあなたのプロキシに直接接続します。

販売を始めるには?

  1. コネクターをインストールします。プロキシのパネルまたはパスワードファイルにアクセスできるサーバーに入れます。

    bash
    curl -fsSL https://x-proxy.io/pm-connector/install.sh | sh
    pm-connector version

    Intel/AMD(amd64)と ARM(arm64、armv7)の Linux サーバーや box 向けです。スクリプトがダウンロードを検証し、pm-connector を /usr/local/bin に配置します。

  2. pm-connector init を実行します。質問は 1 つだけです:ProxyMarket はインターネットからこのサーバーに接続できますか?ProxyMarket は、注文を送るため、注文を終了するため、そして顧客の Change IP ボタンのためにこれを必要とします。

    • No, or not sure(いいえ、またはわからない。推奨)。何も開放しません。コネクターが ProxyMarket へ外向きに接続し、すべてがその接続を通って届きます。どんなルーター、NAT、4G 回線の内側でも動きます。作成するキー:ProxyMarket hook。
    • Yes(はい)。ルーターでポートを 1 つこのサーバーに転送するか、自分のパブリックアドレスをこのサーバーに向けます(方法)。作成するキー:Custom webhook (your server)。

    続いて、Vendor Dashboard の API Keys → New key で作成するキーが案内されます。求められたらキーを貼り付けてください。キーは一度しか表示されません。

    ターミナル
    $ pm-connector init
    pm-connector 1.0.0 setup: writes config.yaml
    
    ProxyMarket has to reach this server: to send you orders, to end them,
    and when a customer presses "Change IP".
    
    You already open your proxy ports to the internet. Can you open one more
    for ProxyMarket (port forwarding / NAT on your router, or a public address)?
      1) No, or not sure (recommended)
         Nothing to open. The connector connects out to ProxyMarket and
         everything arrives through that connection.
      2) Yes, I will forward a port or use my own public address
    Choose [1]: 1
    
    Create your key: Vendor Dashboard > API Keys > New key > "ProxyMarket hook"
    Paste it here: pm_live_3f9c...
    ✅ Key accepted. Connected to ProxyMarket. No port was opened.
    
    ✅ Wrote config.yaml
    Next:
      1. Write your script, in any language, or start from a ready one:
           pm-connector sample          (shows the list: python, node, php, 3proxy)
      2. pm-connector test
      3. sudo pm-connector service install
  3. スクリプトを書くか、用意されたものから始めます。コネクターは注文ごとにあなたのプログラムを 1 つ実行します。言語は自由で、名前もフォルダも自由です。コネクターに伝えるのは、それを起動するコマンドだけです。用意されたスクリプトは出発点です。自由に変更しても、一から自分で書いてもかまいません。

    panel.py
    #!/usr/bin/env python3
    # pm-connector script for a panel that has an API.
    # Python 3, nothing else to install. Change the lines marked CHANGE.
    import json
    import os
    import sys
    import urllib.error
    import urllib.request
    
    PANEL = "http://127.0.0.1:9000"   # CHANGE: your panel's address
    TOKEN = "YOUR_PANEL_TOKEN"        # CHANGE: your panel's API token
    
    
    def value(name):
        """What the connector passes for this order, for example value("USERNAME")."""
        return os.environ.get("PM_" + name, "")
    
    
    def call(method, path, body=None):
        req = urllib.request.Request(
            PANEL + path,
            method=method,
            data=None if body is None else json.dumps(body).encode(),
            headers={"Authorization": "Bearer " + TOKEN, "Content-Type": "application/json"},
        )
        with urllib.request.urlopen(req, timeout=20) as res:   # an error from the panel stops the script
            text = res.read().decode()
        return json.loads(text) if text else None
    
    
    def create():       # CHANGE: how your panel adds a login
        call("POST", "/api/users", {"username": value("USERNAME"), "password": value("PASSWORD"), "port": int(value("PORT"))})
    
    
    def delete():       # CHANGE: how your panel deletes a login
        try:
            call("DELETE", "/api/users/" + value("USERNAME"))
        except urllib.error.HTTPError as err:
            if err.code != 404:       # already deleted is fine
                raise
    
    
    def rotate():       # OPTIONAL: change the IP of the modem on this port, print the new IP
        print(call("POST", "/api/modems/" + value("PORT") + "/rotate")["ip"])
    
    
    def whitelist():    # OPTIONAL: only these IPs may use the customer's login
        ips = [ip for ip in value("IP_WHITELIST").split(",") if ip]
        call("PUT", "/api/users/" + value("USERNAME") + "/whitelist", {"ips": ips})
    
    
    def list_logins():  # OPTIONAL: print the logins that exist, one per line
        for user in call("GET", "/api/users")["data"]:
            print(user["username"])
    
    
    # Delete an OPTIONAL action here too if your panel cannot do it.
    ACTIONS = {"create": create, "delete": delete, "rotate": rotate, "whitelist": whitelist, "list": list_logins}
    
    action = sys.argv[1] if len(sys.argv) > 1 else ""
    if action == "actions":
        print("\n".join(ACTIONS))
    elif action in ACTIONS:
        ACTIONS[action]()
    else:
        sys.exit("unknown action: " + action)

    pm-connector sample python は、このファイルを config.yaml の隣に作成し、script: "python3 panel.py" を設定します。

    pm-connector sample python(または node、php、3proxy)を実行すると、config.yaml の隣にスクリプトが作成されます。その中の CHANGE の付いた行を変更します:パネルの場所、トークン、ログインを追加・削除する 2 つの呼び出しです。OPTIONAL の部分は後回しでかまいません(用途)。

    次に、スクリプトを起動するコマンドを config.yaml に書きます。ファイルの中身はこれだけです:

    config.yaml
    api_key: "pm_live_3f9c..."
    script: "python3 panel.py"
    
    # script: is any command that starts YOUR program. For example:
    #   script: "node panel.js"
    #   script: "php /opt/pm/panel.php"
    #   script: "/opt/pm/my-program"                      (Go, Rust, C#: a compiled program)
    #   script: "powershell -File C:\pm\panel.ps1"      (Windows)

    言語に関係なく、コネクターがスクリプトに求めることは、下のスクリプト標準にまとめています。

  4. pm-connector test を実行します。テスト用のログインでスクリプトを実行し、追加、確認、削除を行います。先に進む前に、❌ の行をすべて直してください(意味)。

    ターミナル
    $ pm-connector test
    ✅ config.yaml is valid
    ✅ Key accepted by ProxyMarket
    ✅ Connected to ProxyMarket: orders will reach this server
    ✅ Script runs: python3 panel.py (it can: create, delete, rotate, whitelist, list)
    No plans yet. Which of your proxy ports should the test use? 31001
    ✅ create: added the test login pm_test_4f2a
    ✅ list: pm_test_4f2a is there
    ✅ whitelist: set for pm_test_4f2a
    ✅ delete: removed pm_test_4f2a
    ℹ️  rotate was not run, it would change a modem's IP. Try it: pm-connector test --rotate 31001
    ℹ️  No plans use this key yet: add them in Vendor Dashboard > My Plans
    
    Ready. Keep it running: sudo pm-connector service install
  5. サービスとして常に動かします。サーバーと一緒に起動し、クラッシュしても復帰します。

    bash
    sudo pm-connector service install
    journalctl -u pm-connector -f      # watch the log

    サーバーと一緒に起動し、止まったときは再起動します。

  6. プランを追加します。プランは顧客が購入できる商品 1 つです。Vendor Dashboard で My Plans → New plan を開き、名前、国、価格、期間、顧客が接続するプロキシの IP とポートを入力します。API Key / Server にはあなたのキーを設定します。各項目の意味。

  7. 自分にテスト注文を送ります。Integration Status で Send test order を押します。無料で、顧客には表示されず、10 分後に自動で終了します。注文の送信、ログインの追加、ログインの動作、ログインの削除と、各ステップが ✅ になるのを確認できます。すべて緑なら販売開始です。

スクリプト標準:スクリプトは何をすればいい?

コネクターとスクリプトのやり取りはこれですべてです:コマンドラインの単語 1 つ、PM_ 値で渡される注文内容、そしてスクリプトの終わり方。ほかの引数も、インストールやインポートが必要なものもないので、どの言語でも動きます。用意されたスクリプトはすでにこれに従っています。

コネクターとまったく同じ方法で、スクリプトを手動で実行できます:

ターミナル
# Linux: add a test login, look in your panel, then delete it
PM_USERNAME=pm_test PM_PASSWORD=secret123 PM_PORT=31001 python3 panel.py create
PM_USERNAME=pm_test python3 panel.py delete

# Windows PowerShell
$env:PM_USERNAME="pm_test"; $env:PM_PASSWORD="secret123"; $env:PM_PORT="31001"
python panel.py create
python panel.py delete

1. 単語 1 つ(アクション)を付けて実行される

コネクターは script: のコマンドを実行し、何をするかを示す単語を 1 つ付けます。たとえば python3 panel.py create です。

アクションコネクターが実行するときスクリプトがすること必須?
create顧客が支払ったログイン PM_USERNAME / PM_PASSWORD を追加する必須
deleteレンタルが終わった、または注文がキャンセル・返金されたログイン PM_USERNAME を削除する。すでに削除済みでも完了とみなす必須
rotate顧客が Change IP を押したPM_PORT のモデムの IP を変更する。新しい IP を出力してもよい任意
whitelist顧客がプロキシを使える IP を設定したPM_IP_WHITELIST の IP だけがそのログインを使えるようにする任意
list後片付け。たとえばコネクターを再インストールした後存在するログインを 1 行に 1 つずつ出力する任意
actionsコネクターの起動時持っているアクションを 1 行に 1 つずつ出力する。これがないと、コネクターは create と delete だけを使う任意のアクションを使う場合

2. PM_ 値から注文を読み取る

コネクターは内容を環境変数(どの言語でも読める名前付きの値)で渡します。シェルでは $PM_USERNAME、Python では os.environ["PM_USERNAME"]、Node.js では process.env.PM_USERNAME、PowerShell では $env:PM_USERNAME です。

値例出どころ
PM_USERNAMEpm_9b1c2d3e4f506172コネクターが注文ごとに新しく作成します。必ず pm_ で始まります
PM_PASSWORDk7m2xq4wyhn3bt5dコネクターが注文ごとに新しく作成します
PM_PORT31001顧客が購入したプランに入力した Proxy Port。どのモデムまたはポートが売れたかをシステムに伝えます
PM_HOST203.0.113.5そのプランに入力した Proxy IP
PM_PLANmodem-7そのプランの Your ID(入力した場合)
PM_ORDER_ID、PM_EXPIRES_AT注文番号と終了時刻ProxyMarket の注文
PM_IP_WHITELIST198.51.100.7,198.51.100.8whitelist のときだけ:顧客が許可した IP(カンマ区切り)。空なら全員を許可します

各アクションが受け取る値:

アクション値
createPM_USERNAME, PM_PASSWORD, PM_PORT, PM_HOST, PM_PLAN, PM_ORDER_ID, PM_EXPIRES_AT
deletePM_USERNAME, PM_PORT, PM_HOST, PM_PLAN, PM_ORDER_ID
rotatePM_PORT, PM_HOST, PM_PLAN, PM_USERNAME, PM_ORDER_ID
whitelistPM_USERNAME, PM_IP_WHITELIST, PM_PORT, PM_ORDER_ID
list, actionsなし

3. 成功したかどうかを伝える

  • 成功:スクリプトが正常に終了します(終了コード 0)。
  • 失敗:スクリプトがエラーで終了し(0 以外の終了コード)、理由を出力します。コネクターはその内容をログと Integration Status に表示します。create が失敗すると、顧客に返金されます。
  • 1 回の実行は最大 120 秒です。コネクターはアクションを 1 つずつ実行するので、スクリプトにロック処理は不要です。

4. 伝えることがあれば 1 行出力する

ほとんどのスクリプトは何も出力しません。コネクターが知り得ないことをシステムが決めたときだけ、create がそれを 1 行の JSON として、最後の行に出力します:

create が出力できる内容
{"host": "203.0.113.5", "port": 31007}              you picked the modem yourself
{"username": "u8821", "password": "x7Kq2m"}         your panel made its own login
{"vpn_config": "...the whole config..."}            a VPN plan: this customer's config

任意:Change IP、IP ホワイトリスト、後片付け

Python、Node.js、シェルのスクリプトには、これらのアクションがすでに入っています。システムでできるものは残し、それ以外は削除してください。どれがあるかは、コネクターがスクリプトに問い合わせます。自作のスクリプトでも同じように追加します。

panel.py
def rotate():       # OPTIONAL: change the IP of the modem on this port, print the new IP
    print(call("POST", "/api/modems/" + value("PORT") + "/rotate")["ip"])


def whitelist():    # OPTIONAL: only these IPs may use the customer's login
    ips = [ip for ip in value("IP_WHITELIST").split(",") if ip]
    call("PUT", "/api/users/" + value("USERNAME") + "/whitelist", {"ips": ips})


def list_logins():  # OPTIONAL: print the logins that exist, one per line
    for user in call("GET", "/api/users")["data"]:
        print(user["username"])
  • rotate:これがあると、顧客に Change IP ボタンと自動ローテーションが提供されます。
  • whitelist:これがあると、顧客はプロキシを使える IP を制限できます。
  • list:これがあると、コネクターは再インストール後などに残った pm_ ログインも見つけて削除します。pm_ で始まらないログインには一切触れません。

プランの設定方法は?

プランは顧客が購入できる商品 1 つで、たとえば US T-Mobile 4G、30 日、$25 です。プランは Vendor Dashboard → My Plans で作成し、価格の変更や一時停止もいつでもそこで行えます。

項目入力する内容
Name, Country, Proxy Type, Protocol顧客に表示され、絞り込みに使われる内容
Duration, Price1 回の購入の期間と価格
Stock同時にプランを使える顧客の数。1 人に貸すモデムなら 1 を入力します。販売ごとに 1 つ減り、注文が終わると戻ります
Proxy IP, Proxy Port顧客が接続するパブリックアドレス。スクリプトには PM_HOST と PM_PORT として渡されます
API Key / Serverコネクターのキー。このプランの注文はそのコネクターに届きます
Your ID(任意)自分用の名前。たとえば modem-7。スクリプトには PM_PLAN として渡されます

Proxy Username、Proxy Password、Rotation Link は空のままにしてください。コネクターが注文ごとに新しいログインを作成します。

モデムがたくさんあります。1 台ずつプランが必要?

  • 顧客に特定のモデムを選ばせたい場合はモデム 1 台に 1 プラン。プランごとに別の Proxy Port と Stock 1 を設定します。
  • 空いているモデムならどれでもよい場合は全モデムで 1 プラン。Stock をモデムの台数にし、Proxy IP と Proxy Port は空にします。create が空いているモデムを選び、そのアドレスを出力します:{"host": "203.0.113.5", "port": 31007}。

何を販売できますか?

  • プロキシ:HTTP、SOCKS5 またはその両方。種類は問いません(モバイル、レジデンシャル、データセンター、ISP、IPv6)。顧客には、プロキシの IP とポート、コネクターが作成したユーザー名とパスワードが渡されます。
  • VPN:OpenVPN、WireGuard、VLESS。顧客にはログインの代わりに設定ファイルか vless:// リンクが渡されます。プランでは Proxy Type: VPN と VPN Protocol を選びます。

VPN の設定の渡し方は 2 つあります。プランの全顧客が同じ設定を使ってよいなら、プランの VPN Config 欄に貼り付ければ、スクリプトがすることはありません。顧客ごとに別の設定が必要なら、create が設定を作成して {"vpn_config": "…the whole config…"} を出力します。

「Yes」と答えました。ProxyMarket に開放するには?

この場合、ProxyMarket はコネクターの外向き接続を使わず、サーバーを直接呼び出します。どちらかを選んでください:

  • ポート転送(NAT)。プロキシのポートと同じように、ルーターで TCP ポート 8787 をこのサーバーに転送します。アドレスは http://YOUR_PUBLIC_IP:8787 です。顧客のログインは暗号化されたまま送られます。
  • 自分の HTTPS アドレス。HTTPS で応答し、リクエストをポート 8787 に渡せるものなら何でもかまいません:リバースプロキシ(Caddy、nginx、IIS)、Cloudflare Tunnel、Tailscale Funnel。アドレスはたとえば https://pm.example.com です。

init がこれを config.yaml に書き込み、そのポートで応答を始めるので、ProxyMarket が確認できます。次に、キーを Custom webhook (your server) として作成し、Webhook URL にあなたのアドレスを入力します。

config.yaml
api_key: "pm_live_..."          # a "Custom webhook (your server)" key
script: "python3 panel.py"

webhook:
  public_url: "http://203.0.113.5:8787"  # the Webhook URL you typed on the key
  listen: "0.0.0.0:8787"                 # the port you forwarded to this server

結局接続できなかった場合は、pm-connector init をもう一度実行して No と答えてください。このページのそれ以外の内容は、どちらの答えでも同じです。

テストのメッセージの意味は?

表示やること
❌ Key rejectedpm_ で始まるキーを全部貼り付けてください。それでも失敗する場合、キーが API Keys で削除または無効化されています。新しく作成してください
❌ This key is not a ProxyMarket hook keyNo と答えたのに Custom webhook のキーを貼り付けています。ProxyMarket hook タイプのキーを新しく作成するか、init をもう一度実行して Yes と答えてください
❌ ProxyMarket cannot reach http://…:8787Yes と答えたのにポートが開いていません。ポート転送とファイアウォールを確認するか、init をもう一度実行して No と答えてください
❌ Cannot reach ProxyMarketサーバーから market.xproxy.io と market-hook-service.xproxy.io への外向き HTTPS(ポート 443)が必要です。ファイアウォールと DNS を確認してください
❌ Script does not run: …script: のコマンドを起動できませんでした。パスと、python3 または node がインストールされているかを確認してください
❌ create failed: … または delete failed: …コロンの後はスクリプトが出力した内容で、たいていはパネルの応答です。CHANGE の付いた行(アドレス、トークン、2 つの呼び出し)を確認して、もう一度テストしてください
❌ list: the test login is not therecreate は成功と言ったのにログインがありません。create と list が同じパネルまたはファイルを使っているか確認してください
⚠️ Proxy IP … does not accept connections顧客が接続できません。ファイアウォールやルーターでポートを開くか、プランの Proxy IP と Proxy Port を修正してください
Vendor account not approved yetキーは有効ですが、ベンダーアカウントがまだ管理者に承認されていません。アカウントのメールアドレスを添えて @xproxyio に連絡してください

販売開始後は、Vendor Dashboard の Integration Status タブで、コネクターの接続状態、掲載中・非表示のプランとその理由、最近の注文と失敗した注文のエラーを確認できます。

よくある質問

顧客のユーザー名とパスワードは誰が決めますか?

コネクターです。注文ごとに新しいユーザー名(pm_ と 16 文字)と 16 文字のパスワードを作成し、PM_USERNAME と PM_PASSWORD としてスクリプトに渡します。どこかで設定する必要はありません。

パネルが独自にユーザー名とパスワードを作ります。それを使えますか?

はい。create でそれを {"username": "…", "password": "…"} のように出力すれば、顧客にはそちらが渡されます(ルール 4)。

プログラミングの知識は必要ですか?

いいえ。用意されたスクリプトで、パネルのアドレス、トークン、ログインを追加・削除する 2 つの呼び出しを変更するだけです。これらはパネルの API ドキュメントに載っています。このページ上部の Ask AI ボタンを使えば一緒に作業できます。

Windows でも動きますか?

はい。Python、Node.js、PHP のスクリプトは Windows でも同じです。たとえば script: "python C:\pm\panel.py" と設定します。標準に従っていれば、PowerShell や .bat のスクリプトも使えます。

システムが遅い場合や、コネクターが止まっている場合は?

create の制限時間は 120 秒です。それを過ぎると顧客に返金され、その売上は収益から差し引かれます。コネクターが止まっている間の注文も同じです。2 回続けて確認に失敗すると(確認は 10 分ごと)、復帰するまでプランは非表示になります。復帰すると、止まっていた間に終わった注文のログインを削除します。

サーバーが複数あります。コネクター 1 つで足りますか?

1 つのパネルまたはスクリプトですべてを管理しているなら、コネクターは 1 つで十分です。そうでなければ、各サーバーに専用のキーでコネクターをインストールし、各プランの API Key / Server にそのプランを担当するサーバーのキーを設定します。1 つのキーは同時に 1 つのコネクターでしか使えません。

注文を自分で終了できますか?

はい。pm-connector expire ORDER_ID で ProxyMarket 上の注文を終了し、ログインを削除します。顧客への返金は行われません。

コネクターをアップデートするには?

インストールコマンドをもう一度実行し、サービスを再起動します。config.yaml、スクリプト、顧客のログインはそのまま残ります。

XProxy を使っています。これは必要ですか?

いいえ。XProxy パネルはそれ自体で ProxyMarket に出品できます:XProxy で販売をご覧ください。

次はどうする?

ダッシュボードを開いてキーを取得するか、ほかの販売方法をご覧ください。

解決しませんか?技術者がワンタイム PIN でお使いのデバイスを確認できます。Telegram でチャットすることもできます。