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. 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 を通ることはなく、顧客はあなたのプロキシに直接接続します。
販売を始めるには?
コネクターをインストールします。プロキシのパネルまたはパスワードファイルにアクセスできるサーバーに入れます。
bashcurl -fsSL https://x-proxy.io/pm-connector/install.sh | sh pm-connector versionIntel/AMD(amd64)と ARM(arm64、armv7)の Linux サーバーや box 向けです。スクリプトがダウンロードを検証し、
pm-connectorを/usr/local/binに配置します。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スクリプトを書くか、用意されたものから始めます。コネクターは注文ごとにあなたのプログラムを 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.yamlapi_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)言語に関係なく、コネクターがスクリプトに求めることは、下のスクリプト標準にまとめています。
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サービスとして常に動かします。サーバーと一緒に起動し、クラッシュしても復帰します。
bashsudo pm-connector service install journalctl -u pm-connector -f # watch the logサーバーと一緒に起動し、止まったときは再起動します。
プランを追加します。プランは顧客が購入できる商品 1 つです。Vendor Dashboard で My Plans → New plan を開き、名前、国、価格、期間、顧客が接続するプロキシの IP とポートを入力します。API Key / Server にはあなたのキーを設定します。各項目の意味。
自分にテスト注文を送ります。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 delete1. 単語 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_USERNAME | pm_9b1c2d3e4f506172 | コネクターが注文ごとに新しく作成します。必ず pm_ で始まります |
PM_PASSWORD | k7m2xq4wyhn3bt5d | コネクターが注文ごとに新しく作成します |
PM_PORT | 31001 | 顧客が購入したプランに入力した Proxy Port。どのモデムまたはポートが売れたかをシステムに伝えます |
PM_HOST | 203.0.113.5 | そのプランに入力した Proxy IP |
PM_PLAN | modem-7 | そのプランの Your ID(入力した場合) |
PM_ORDER_ID、PM_EXPIRES_AT | 注文番号と終了時刻 | ProxyMarket の注文 |
PM_IP_WHITELIST | 198.51.100.7,198.51.100.8 | whitelist のときだけ:顧客が許可した IP(カンマ区切り)。空なら全員を許可します |
各アクションが受け取る値:
| アクション | 値 |
|---|---|
create | PM_USERNAME, PM_PASSWORD, PM_PORT, PM_HOST, PM_PLAN, PM_ORDER_ID, PM_EXPIRES_AT |
delete | PM_USERNAME, PM_PORT, PM_HOST, PM_PLAN, PM_ORDER_ID |
rotate | PM_PORT, PM_HOST, PM_PLAN, PM_USERNAME, PM_ORDER_ID |
whitelist | PM_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 として、最後の行に出力します:
{"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、シェルのスクリプトには、これらのアクションがすでに入っています。システムでできるものは残し、それ以外は削除してください。どれがあるかは、コネクターがスクリプトに問い合わせます。自作のスクリプトでも同じように追加します。
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, Price | 1 回の購入の期間と価格 |
| 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 にあなたのアドレスを入力します。
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 rejected | pm_ で始まるキーを全部貼り付けてください。それでも失敗する場合、キーが API Keys で削除または無効化されています。新しく作成してください |
| ❌ This key is not a ProxyMarket hook key | No と答えたのに Custom webhook のキーを貼り付けています。ProxyMarket hook タイプのキーを新しく作成するか、init をもう一度実行して Yes と答えてください |
| ❌ ProxyMarket cannot reach http://…:8787 | Yes と答えたのにポートが開いていません。ポート転送とファイアウォールを確認するか、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 there | create は成功と言ったのにログインがありません。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 で販売をご覧ください。
次はどうする?
ダッシュボードを開いてキーを取得するか、ほかの販売方法をご覧ください。

