Conector do ProxyMarket: venda os seus proxies sem código
Perguntar à IA
Tarefa prontaInstalar e configurar o pm-connector no seu servidor
Agentes de programação
Claude CodeAbre a aplicação de computadorCodexAbre a aplicação de computadorCursorAbre a aplicação na webAssistentes de chat
Abrir no ChatGPTNovo separadorAbrir no ClaudeNovo separadorCopiar
Ver em MarkdownTexto simples para ferramentas de IAVer o prompt
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 Portuguese: https://xproxy.io/pt/document/proxymarket-connector. The Markdown copy is in English. Answer in Portuguese.
A aplicação abre com o prompt preenchido. Nada é executado até premir Enter.
Já vende proxies a partir dos seus próprios servidores. O pm-connector é um pequeno programa que permite ao ProxyMarket vendê-los por si. Quando um cliente paga, dá-lhe acesso ao seu proxy. Quando o aluguer termina, volta a retirar-lhe o acesso. Não precisa de domínio nem de porta aberta para isso.
Precisa de: uma conta de vendedor em market.xproxy.io, um servidor Linux ou Windows que consiga chegar ao seu painel de proxies ou ao ficheiro de palavras-passe do seu proxy, e proxies acessíveis aos clientes a partir da internet.
Como funciona?
Quando vende um proxy manualmente, faz duas coisas: cria um nome de utilizador e uma palavra-passe para o comprador e apaga-os quando o aluguer termina. O conector faz o mesmo para cada encomenda, através de um script seu:
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_9b1c2d3e4f506172Nunca escolhe o nome de utilizador nem a palavra-passe de um cliente: o conector cria-os e entrega-os ao seu script. O tráfego dos clientes nunca passa pelo conector nem pelo ProxyMarket; os clientes ligam-se diretamente ao seu proxy.
Como começo a vender?
Instale o conector num servidor que consiga chegar ao seu painel de proxies ou ao ficheiro de palavras-passe do seu proxy.
bashcurl -fsSL https://x-proxy.io/pm-connector/install.sh | sh pm-connector versionPara Linux em servidores e boxes Intel/AMD (amd64) e ARM (arm64, armv7). O script verifica a transferência e coloca o
pm-connectorem/usr/local/bin.Execute
pm-connector init. Faz uma única pergunta: o ProxyMarket consegue chegar a este servidor a partir da internet? O ProxyMarket precisa disso para lhe enviar encomendas, para as terminar e para o botão Change IP do cliente.- No, or not sure (não, ou não sei; recomendado). Não abre nada. O conector liga-se ao ProxyMarket de dentro para fora e tudo chega por essa ligação. Funciona atrás de qualquer router, NAT ou linha 4G. Chave a criar: ProxyMarket hook.
- Yes (sim). Reencaminha uma porta do seu router para este servidor, ou aponta para ele o seu próprio endereço público (como). Chave a criar: Custom webhook (your server).
Depois indica-lhe que chave criar no Vendor Dashboard, em API Keys → New key. Cole a chave quando lhe for pedida: só é mostrada uma vez.
Terminal$ 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 installEscreva o seu script, ou parta de um pronto. O conector executa um programa seu para cada encomenda. Pode estar em qualquer linguagem, com qualquer nome, em qualquer pasta: basta indicar ao conector o comando que o inicia. Estes scripts prontos são pontos de partida; altere-os à vontade ou escreva o seu do zero.
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 pythonescreve este ficheiro ao lado doconfig.yamle definescript: "python3 panel.py".pm-connector sample python(ounode,php,3proxy) coloca um script pronto ao lado doconfig.yaml. Nele, altere as linhas marcadas comCHANGE: onde está o seu painel, o token e as duas chamadas que criam e apagam um acesso. As partes marcadas comOPTIONALpodem esperar (para que servem).Depois coloque no
config.yamlo comando que inicia o seu script. É o ficheiro inteiro: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)O que o conector espera de um script, seja qual for a linguagem, está na norma do script abaixo.
Execute
pm-connector test. Executa o seu script com um acesso de teste: cria-o, verifica-o e apaga-o. Corrija todas as linhas ❌ antes de continuar (o que significam).Terminal$ 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 installMantenha-o a correr como serviço, para que arranque com o servidor e volte após uma falha.
bashsudo pm-connector service install journalctl -u pm-connector -f # watch the logArranca com o servidor e reinicia se alguma vez parar.
Adicione os seus planos. Um plano é uma coisa que um cliente pode comprar. No Vendor Dashboard, abra My Plans → New plan e introduza o nome, o país, o preço, a duração e o IP e a porta do proxy a que os clientes se ligam. Defina API Key / Server com a sua chave. O que significa cada campo.
Envie a si próprio uma encomenda de teste. Em Integration Status, clique em Send test order. É gratuita, fica oculta aos clientes e termina sozinha após 10 minutos. Vê cada passo ficar ✅: encomenda enviada, acesso criado, acesso funciona, acesso apagado. Tudo verde significa que já está à venda.
A norma do script: o que tem o meu script de fazer?
Esta é toda a interface entre o conector e o seu script: uma palavra na linha de comandos, os detalhes da encomenda como valores PM_ e a forma como o script termina. Não há outros argumentos, nada para instalar e nada para importar, por isso funciona em qualquer linguagem. Os scripts prontos já a seguem.
Pode executar o seu script manualmente exatamente como o conector o faz:
# 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. É executado com uma palavra: a ação
O conector executa o comando de script: e acrescenta uma palavra que diz o que fazer, por exemplo python3 panel.py create.
| Ação | Quando o conector a executa | O que o seu script faz | Obrigatória? |
|---|---|---|---|
create | Um cliente pagou | Cria o acesso PM_USERNAME / PM_PASSWORD | Obrigatória |
delete | O aluguer terminou, ou a encomenda foi cancelada ou reembolsada | Apaga o acesso PM_USERNAME. Se já estiver apagado, conta como feito | Obrigatória |
rotate | O cliente clicou em Change IP | Muda o IP do modem em PM_PORT. Pode imprimir o novo IP | Opcional |
whitelist | O cliente definiu que IPs podem usar o proxy | Deixa apenas os IPs de PM_IP_WHITELIST usar esse acesso | Opcional |
list | Limpeza, por exemplo depois de reinstalar o conector | Imprime os acessos existentes, um por linha | Opcional |
actions | Quando o conector arranca | Imprime as ações que tem, uma por linha. Sem ela, o conector usa apenas create e delete | Para ações opcionais |
2. Lê a encomenda a partir dos valores PM_
O conector passa os detalhes como variáveis de ambiente: valores com nome que qualquer linguagem consegue ler. Em shell $PM_USERNAME, em Python os.environ["PM_USERNAME"], em Node.js process.env.PM_USERNAME, em PowerShell $env:PM_USERNAME.
| Valor | Por exemplo | De onde vem |
|---|---|---|
PM_USERNAME | pm_9b1c2d3e4f506172 | Criado pelo conector, novo em cada encomenda. Começa sempre por pm_ |
PM_PASSWORD | k7m2xq4wyhn3bt5d | Criado pelo conector, novo em cada encomenda |
PM_PORT | 31001 | A Proxy Port que escreveu no plano comprado pelo cliente. Indica ao seu sistema que modem ou porta foi vendido |
PM_HOST | 203.0.113.5 | O Proxy IP que escreveu nesse plano |
PM_PLAN | modem-7 | O Your ID desse plano, se o preencheu |
PM_ORDER_ID, PM_EXPIRES_AT | o número da encomenda e a hora de fim | A encomenda no ProxyMarket |
PM_IP_WHITELIST | 198.51.100.7,198.51.100.8 | Só para whitelist: os IPs que o cliente permite, separados por vírgulas. Vazio significa todos |
Valores recebidos por cada ação:
| Ação | Valores |
|---|---|
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 | nenhum |
3. Indica se funcionou
- Funcionou: o script termina normalmente (código de saída 0).
- Falhou: o script termina com um erro (qualquer outro código de saída) e imprime o motivo. O conector mostra esse texto no seu log e em Integration Status. Um
createfalhado devolve o dinheiro ao cliente. - Cada execução pode demorar até 120 segundos. O conector executa uma ação de cada vez, por isso o seu script não precisa de bloqueios.
4. Se tiver algo a dizer, imprime uma linha
A maioria dos scripts não imprime nada. Só quando o seu sistema decide algo que o conector não pode saber, o create imprime-o como uma linha de JSON, a última que imprime:
{"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 configOpcional: Change IP, whitelist de IPs, limpeza
Os scripts Python, Node.js e shell já contêm estas ações. Mantenha as que o seu sistema consegue fazer e apague as outras; o conector pergunta ao seu script quais tem. Num script seu, acrescente-as da mesma forma.
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: com ela, os clientes têm um botão Change IP e rotação automática.whitelist: com ela, os clientes podem limitar que IPs podem usar o seu proxy.list: com ela, o conector também encontra e apaga acessospm_que tenham ficado para trás, por exemplo depois de o reinstalar. Nunca mexe num acesso que não comece porpm_.
Como configuro os meus planos?
Um plano é uma coisa que um cliente pode comprar, por exemplo US T-Mobile 4G, 30 dias, $25. Cria os planos em Vendor Dashboard → My Plans e pode alterar o preço ou pausar um plano aí a qualquer momento.
| Campo | O que introduzir |
|---|---|
| Name, Country, Proxy Type, Protocol | O que os clientes veem e usam para filtrar |
| Duration, Price | Quanto tempo dura uma compra e quanto custa |
| Stock | Quantos clientes podem usar o plano ao mesmo tempo. Introduza 1 para um modem que aluga a uma só pessoa. Cada venda ocupa uma unidade; ela volta quando a encomenda termina |
| Proxy IP, Proxy Port | O endereço público a que os clientes se ligam. O seu script recebe-os como PM_HOST e PM_PORT |
| API Key / Server | A chave do seu conector. As encomendas deste plano vão para esse conector |
| Your ID (opcional) | O seu próprio nome para o plano, por exemplo modem-7. O seu script recebe-o como PM_PLAN |
Deixe Proxy Username, Proxy Password e Rotation Link vazios: o conector cria um novo acesso para cada encomenda.
Tenho muitos modems. Um plano para cada um?
- Um plano por modem, quando os clientes devem escolher um modem concreto. Dê a cada plano a sua própria Proxy Port e Stock 1.
- Um plano para todos, quando serve qualquer modem livre. Defina Stock com o número de modems e deixe Proxy IP e Proxy Port vazios. O seu
createescolhe um modem livre e imprime o endereço:{"host": "203.0.113.5", "port": 31007}.
O que posso vender?
- Proxies: HTTP, SOCKS5 ou ambos, de qualquer tipo (móveis, residenciais, datacenter, ISP, IPv6). O cliente recebe o IP e a porta do seu proxy com o nome de utilizador e a palavra-passe criados pelo conector.
- VPN: OpenVPN, WireGuard ou VLESS. O cliente recebe um ficheiro de configuração ou uma ligação
vless://em vez de credenciais. No plano, escolha Proxy Type: VPN e o VPN Protocol.
Para VPN, há duas formas de entregar a configuração. Se todos os clientes de um plano puderem usar a mesma configuração, cole-a no campo VPN Config do plano e o seu script não tem nada a fazer. Se cada cliente precisar da sua, o seu create cria-a e imprime {"vpn_config": "…the whole config…"}.
Respondi Yes. Como abro o acesso ao ProxyMarket?
Nesse caso, o ProxyMarket chama diretamente o seu servidor em vez de usar a ligação de saída do conector. Escolha uma opção:
- Reencaminhamento de portas (NAT). No seu router, reencaminhe a porta TCP
8787para este servidor, tal como faz com as portas dos seus proxies. O seu endereço éhttp://YOUR_PUBLIC_IP:8787. As credenciais do cliente continuam a viajar encriptadas. - O seu próprio endereço HTTPS. Qualquer coisa que sirva HTTPS e passe os pedidos para a porta
8787: o seu reverse proxy (Caddy, nginx, IIS), um Cloudflare Tunnel ou um Tailscale Funnel. O seu endereço é, por exemplo,https://pm.example.com.
O init escreve isto no config.yaml e começa a responder na porta, para que o ProxyMarket a possa verificar. Depois crie a chave como Custom webhook (your server) com o seu endereço como 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 serverAfinal não está acessível? Execute pm-connector init de novo e responda No (não). Tudo o resto nesta página é igual para as duas respostas.
O que significam as mensagens do teste?
| O que vê | O que fazer |
|---|---|
| ❌ Key rejected | Cole a chave inteira, a começar por pm_. Se continuar a falhar, a chave foi apagada ou desativada em API Keys: crie uma nova |
| ❌ This key is not a ProxyMarket hook key | Respondeu No (não) mas colou uma chave Custom webhook. Crie uma nova chave do tipo ProxyMarket hook, ou execute init de novo e responda Yes (sim) |
| ❌ ProxyMarket cannot reach http://…:8787 | Respondeu Yes (sim) mas a porta não está aberta: verifique o reencaminhamento de portas e a firewall, ou execute init de novo e responda No (não) |
| ❌ Cannot reach ProxyMarket | O servidor precisa de HTTPS de saída (porta 443) para market.xproxy.io e market-hook-service.xproxy.io. Verifique a firewall e o DNS |
| ❌ Script does not run: … | O comando de script: não conseguiu arrancar: verifique o caminho e se o python3 ou o node estão instalados |
| ❌ create failed: … ou delete failed: … | O texto após os dois pontos é o que o seu script imprimiu, normalmente a resposta do seu painel. Verifique as linhas marcadas com CHANGE (endereço, token, as duas chamadas) e teste de novo |
| ❌ list: the test login is not there | O create disse que funcionou mas o acesso não existe: verifique se o create e o list usam o mesmo painel ou ficheiro |
| ⚠️ Proxy IP … does not accept connections | Os clientes não vão conseguir ligar-se: abra a porta na firewall ou no router, ou corrija Proxy IP e Proxy Port no plano |
| Vendor account not approved yet | A sua chave funciona, mas um administrador ainda não aprovou a sua conta de vendedor. Envie uma mensagem a @xproxyio com o e-mail da sua conta |
Depois de estar à venda, o separador Integration Status do Vendor Dashboard mostra se o conector está ligado, que planos estão listados ou ocultos e porquê, e as últimas encomendas, com o erro das que falharam.
Perguntas frequentes
Quem escolhe o nome de utilizador e a palavra-passe do cliente?
O conector. Para cada encomenda cria um novo nome de utilizador (pm_ e 16 caracteres) e uma palavra-passe de 16 caracteres, e passa-os ao seu script como PM_USERNAME e PM_PASSWORD. Não os define em lado nenhum.
O meu painel cria o seu próprio nome de utilizador e palavra-passe. Posso usá-los?
Sim. Faça o seu create imprimi-los, {"username": "…", "password": "…"}, e o cliente recebe esses (regra 4).
Preciso de saber programar?
Não. Num script pronto, altera o endereço do seu painel, o token e as duas chamadas que criam e apagam um acesso; a documentação da API do seu painel mostra-as. O botão Ask AI no topo desta página pode fazê-lo consigo.
Funciona no Windows?
Sim. Os scripts Python, Node.js e PHP são iguais no Windows; defina, por exemplo, script: "python C:\pm\panel.py". Um script PowerShell ou .bat também funciona, desde que siga a norma.
E se o meu sistema for lento, ou o conector estiver desligado?
O seu create tem 120 segundos. Depois disso, o cliente recebe o dinheiro de volta e a venda é retirada dos seus ganhos. O mesmo acontece às encomendas feitas enquanto o conector está desligado. Se ficar desligado durante duas verificações seguidas (correm de 10 em 10 minutos), os seus planos ficam ocultos até voltar. Quando volta, apaga os acessos das encomendas que terminaram durante a sua ausência.
Tenho vários servidores. Um conector para todos?
Se um único painel ou script gere todos, basta um conector. Caso contrário, instale um conector em cada servidor, com a sua própria chave, e defina o API Key / Server de cada plano com a chave do servidor que o serve. Uma chave funciona com um conector de cada vez.
Posso terminar uma encomenda eu próprio?
Sim: pm-connector expire ORDER_ID termina a encomenda no ProxyMarket e apaga o respetivo acesso. Não devolve o dinheiro ao cliente.
Como atualizo o conector?
Execute de novo o comando de instalação e depois reinicie o serviço. O seu config.yaml, o seu script e os acessos dos seus clientes ficam como estão.
Uso a XProxy. Preciso disto?
Não. O painel XProxy vende no ProxyMarket por si só: consulte Vender com a XProxy.
E agora?
Abra o painel para obter a sua chave, ou veja as outras formas de vender.

