Pular para o conteúdo

Conector do ProxyMarket: venda seus proxies sem código

Perguntar à IA

Tarefa prontaInstale e configure o pm-connector no seu servidor

Agentes de código

Claude CodeAbre o app para desktopCodexAbre o app para desktopCursorAbre o app pela web

Assistentes de chat

Abrir no ChatGPTNova abaAbrir no ClaudeNova aba

Copiar

Ver como MarkdownTexto simples para ferramentas de IA
Ver 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 Brazilian Portuguese: https://xproxy.io/pt-BR/document/proxymarket-connector. The Markdown copy is in English. Answer in Brazilian Portuguese.

O app abre com o prompt preenchido. Nada é executado até você pressionar Enter.

Você já vende proxies dos seus próprios servidores. O pm-connector é um pequeno programa que permite ao ProxyMarket vendê-los por você. Quando um cliente paga, ele libera o acesso desse cliente ao seu proxy. Quando o aluguel termina, ele bloqueia o acesso de novo. Você não precisa de domínio nem de porta aberta para isso.

Você precisa de: uma conta de vendedor em market.xproxy.io, um servidor Linux ou Windows que consiga acessar o painel dos seus proxies ou o arquivo de senhas do seu proxy, e proxies que os clientes consigam acessar pela internet.

Como funciona?

Quando você vende um proxy manualmente, faz duas coisas: cria um usuário e uma senha para o comprador e os apaga quando o aluguel termina. O conector faz o mesmo para cada pedido, por meio de um script seu:

Um pedido, do início ao fim
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

Você nunca escolhe o usuário nem a senha de um cliente: o conector os cria e os entrega ao seu script. O tráfego dos clientes nunca passa pelo conector nem pelo ProxyMarket; os clientes se conectam direto ao seu proxy.

Como começo a vender?

  1. Instale o conector em um servidor que consiga acessar o painel dos seus proxies ou o arquivo de senhas do seu proxy.

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

    Para Linux em servidores e boxes Intel/AMD (amd64) e ARM (arm64, armv7). O script verifica o download e coloca o pm-connector em /usr/local/bin.

  2. Execute pm-connector init. Ele faz uma única pergunta: o ProxyMarket consegue acessar este servidor pela internet? O ProxyMarket precisa disso para enviar pedidos, encerrá-los e para o botão Change IP do cliente.

    • No, or not sure (não, ou não tenho certeza; recomendado). Você não abre nada. O conector se conecta ao ProxyMarket de dentro para fora e tudo chega por essa conexão. Funciona atrás de qualquer roteador, NAT ou linha 4G. Chave a criar: ProxyMarket hook.
    • Yes (sim). Você redireciona uma porta do seu roteador para este servidor ou aponta seu próprio endereço público para ele (como). Chave a criar: Custom webhook (your server).

    Depois, ele diz qual chave criar no Vendor Dashboard, em API Keys → New key. Cole a chave quando for pedido: ela aparece uma única 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 install
  3. Escreva seu script ou comece por um pronto. O conector executa um programa seu para cada pedido. Ele pode estar em qualquer linguagem, com qualquer nome, em qualquer pasta: você só informa ao conector o comando que o inicia. Estes scripts prontos são pontos de partida; altere-os como quiser 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 python grava este arquivo ao lado do config.yaml e define script: "python3 panel.py".

    pm-connector sample python (ou node, php, 3proxy) coloca um script pronto ao lado do config.yaml. Nele, altere as linhas marcadas com CHANGE: onde fica o seu painel, o token dele e as duas chamadas que criam e apagam um login. As partes marcadas com OPTIONAL podem esperar (para que servem).

    Depois, coloque no config.yaml o comando que inicia o seu script. Esse é o arquivo inteiro:

    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)

    O que o conector espera de um script, em qualquer linguagem, está no padrão de script abaixo.

  4. Execute pm-connector test. Ele executa seu script com um login de teste: cria, confere e apaga. Corrija cada linha ❌ antes de continuar (o que elas 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 install
  5. Deixe-o rodando como serviço, para que inicie junto com o servidor e volte depois de uma falha.

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

    Inicia junto com o servidor e reinicia se parar.

  6. Adicione seus planos. Um plano é uma coisa que um cliente pode comprar. No Vendor Dashboard, abra My Plans → New plan e informe o nome, o país, o preço, quanto tempo dura e o IP e a porta do proxy aos quais os clientes se conectam. Em API Key / Server, escolha a sua chave. O que significa cada campo.

  7. Envie um pedido de teste para você mesmo. Em Integration Status, clique em Send test order. É gratuito, fica oculto para os clientes e termina sozinho depois de 10 minutos. Você vê cada etapa ficar ✅: pedido enviado, login criado, login funcionando, login apagado. Tudo verde significa que você está vendendo.

O padrão de script: o que meu script precisa fazer?

Esta é toda a interface entre o conector e o seu script: uma palavra na linha de comando, os detalhes do pedido como valores PM_ e a forma como o script termina. Não há outros argumentos, nada para instalar e nada para importar, então funciona em qualquer linguagem. Os scripts prontos já seguem esse padrão.

Você pode executar seu script manualmente exatamente como o conector faz:

Terminal
# 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. Ele é 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çãoQuando o conector a executaO que o seu script fazObrigatória?
createUm cliente pagouCria o login PM_USERNAME / PM_PASSWORDObrigatória
deleteO aluguel terminou, ou o pedido foi cancelado ou reembolsadoApaga o login PM_USERNAME. Se já estiver apagado, conta como feitoObrigatória
rotateO cliente clicou em Change IPTroca o IP do modem em PM_PORT. Pode imprimir o novo IPOpcional
whitelistO cliente definiu quais IPs podem usar o proxyPermite que só os IPs em PM_IP_WHITELIST usem esse loginOpcional
listLimpeza, por exemplo depois que você reinstala o conectorImprime os logins existentes, um por linhaOpcional
actionsQuando o conector iniciaImprime as ações que tem, uma por linha. Sem ela, o conector usa só create e deletePara ações opcionais

2. Ele lê o pedido nos valores PM_

O conector passa os detalhes como variáveis de ambiente: valores com nome que qualquer linguagem consegue ler. No shell $PM_USERNAME, em Python os.environ["PM_USERNAME"], em Node.js process.env.PM_USERNAME, em PowerShell $env:PM_USERNAME.

ValorPor exemploDe onde vem
PM_USERNAMEpm_9b1c2d3e4f506172O conector o cria, novo a cada pedido. Sempre começa com pm_
PM_PASSWORDk7m2xq4wyhn3bt5dO conector a cria, nova a cada pedido
PM_PORT31001A Proxy Port que você informou no plano que o cliente comprou. Ela diz ao seu sistema qual modem ou porta foi vendido
PM_HOST203.0.113.5O Proxy IP que você informou nesse plano
PM_PLANmodem-7Your ID desse plano, se você preencheu
PM_ORDER_ID, PM_EXPIRES_ATo número do pedido e a hora de términoO pedido no ProxyMarket
PM_IP_WHITELIST198.51.100.7,198.51.100.8Só para whitelist: os IPs que o cliente permite, separados por vírgulas. Vazio significa todos

Quais valores cada ação recebe:

AçãoValores
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, actionsnenhum

3. Ele informa se funcionou

  • Funcionou: o script termina normalmente (código de saída 0).
  • Falhou: o script termina com erro (qualquer outro código de saída) e imprime o motivo. O conector mostra esse texto no log e em Integration Status. Um create que falha devolve o dinheiro ao cliente.
  • Cada execução pode levar até 120 segundos. O conector executa uma ação por vez, então seu script não precisa de travamento.

4. Se tiver algo a dizer, ele imprime uma linha

A maioria dos scripts não imprime nada. Só quando o seu sistema decide algo que o conector não tem como saber, o create imprime isso como uma linha de JSON, a última linha que ele imprime:

O que o create pode imprimir
{"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

Opcional: Change IP, whitelist de IPs, limpeza

Os scripts em Python, Node.js e shell já contêm essas ações. Mantenha as que o seu sistema consegue fazer e apague as outras; o conector pergunta ao seu script quais ele tem. Em um script próprio, adicione-as do mesmo jeito.

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: com ela, os clientes ganham um botão Change IP e rotação automática.
  • whitelist: com ela, os clientes podem limitar quais IPs podem usar o proxy deles.
  • list: com ela, o conector também encontra e apaga logins pm_ que ficaram para trás, por exemplo depois que você o reinstala. Ele nunca mexe em um login que não começa com pm_.

Como configuro meus planos?

Um plano é uma coisa que um cliente pode comprar, por exemplo US T-Mobile 4G, 30 dias, $25. Você cria planos em Vendor Dashboard → My Plans e pode alterar o preço ou pausar um plano ali a qualquer momento.

CampoO que informar
Name, Country, Proxy Type, ProtocolO que os clientes veem e usam para filtrar
Duration, PriceQuanto tempo dura uma compra e quanto custa
StockQuantos clientes podem usar o plano ao mesmo tempo. Informe 1 para um modem que você aluga a uma pessoa. Uma venda consome uma unidade; ela volta quando o pedido termina
Proxy IP, Proxy PortO endereço público ao qual os clientes se conectam. Seu script os recebe como PM_HOST e PM_PORT
API Key / ServerA chave do seu conector. Os pedidos deste plano vão para esse conector
Your ID (opcional)Um nome seu para ele, por exemplo modem-7. Seu script o recebe como PM_PLAN

Deixe Proxy Username, Proxy Password e Rotation Link vazios: o conector cria um novo login para cada pedido.

Tenho muitos modems. Um plano para cada?

  • Um plano por modem, quando os clientes devem escolher um específico. Dê a cada plano a sua própria Proxy Port e Stock 1.
  • Um plano para todos, quando qualquer modem livre serve. Defina Stock como o número de modems e deixe Proxy IP e Proxy Port vazios. Seu create escolhe um modem livre e imprime o endereço dele: {"host": "203.0.113.5", "port": 31007}.

O que posso vender?

  • Proxies: HTTP, SOCKS5 ou ambos, de qualquer tipo (móvel, residencial, datacenter, ISP, IPv6). O cliente recebe o IP e a porta do seu proxy com o usuário e a senha que o conector criou.
  • VPN: OpenVPN, WireGuard ou VLESS. O cliente recebe um arquivo de configuração ou um link vless:// em vez de um login. 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 podem usar a mesma configuração, cole-a no campo VPN Config do plano e seu script não precisa fazer nada. Se cada cliente precisa da sua, o seu create a cria e imprime {"vpn_config": "…the whole config…"}.

Respondi “Yes”. Como abro o acesso ao ProxyMarket?

Nesse caso, o ProxyMarket chama o seu servidor diretamente, em vez de usar a conexão de saída do conector. Escolha uma opção:

  • Redirecionamento de porta (NAT). No seu roteador, redirecione a porta TCP 8787 para este servidor, do mesmo jeito que você redireciona as portas dos seus proxies. Seu endereço é http://YOUR_PUBLIC_IP:8787. O login do cliente continua trafegando criptografado.
  • Seu próprio endereço HTTPS. Qualquer coisa que sirva HTTPS e repasse as requisições para a porta 8787: seu proxy reverso (Caddy, nginx, IIS), um Cloudflare Tunnel ou o Tailscale Funnel. Seu endereço é, por exemplo, https://pm.example.com.

O init grava isso no config.yaml e começa a responder na porta, para que o ProxyMarket possa verificá-la. Depois, crie a chave como Custom webhook (your server) com o seu endereço como 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

No fim, não ficou acessível? Execute pm-connector init de novo e responda No. Todo o resto desta página é igual para as duas respostas.

O que significam as mensagens do teste?

O que você vêO que fazer
❌ Key rejectedCole a chave inteira, começando com pm_. Se ainda falhar, a chave foi apagada ou desativada em API Keys: crie uma nova
❌ This key is not a ProxyMarket hook keyVocê respondeu No, mas colou uma chave Custom webhook. Crie uma nova chave do tipo ProxyMarket hook, ou execute init de novo e responda Yes
❌ ProxyMarket cannot reach http://…:8787Você respondeu Yes, mas a porta não está aberta: confira o redirecionamento de porta e o firewall, ou execute init de novo e responda No
❌ Cannot reach ProxyMarketO servidor precisa de HTTPS de saída (porta 443) para market.xproxy.io e market-hook-service.xproxy.io. Confira o firewall e o DNS
❌ Script does not run: …O comando em script: não conseguiu iniciar: confira o caminho e se o python3 ou o node está instalado
❌ create failed: … ou delete failed: …O texto depois dos dois-pontos é o que o seu script imprimiu, normalmente a resposta do seu painel. Confira as linhas marcadas com CHANGE (endereço, token, as duas chamadas) e teste de novo
❌ list: the test login is not thereO create disse que funcionou, mas o login não existe: confira se create e list usam o mesmo painel ou arquivo
⚠️ Proxy IP … does not accept connectionsOs clientes não vão conseguir se conectar: abra a porta no seu firewall ou roteador, ou corrija Proxy IP e Proxy Port no plano
Vendor account not approved yetSua chave funciona, mas um admin ainda não aprovou sua conta de vendedor. Mande uma mensagem para @xproxyio com o e-mail da sua conta

Depois que você estiver vendendo, a aba Integration Status do Vendor Dashboard mostra se o conector está conectado, quais planos estão listados ou ocultos e por quê, e os últimos pedidos, com o erro dos que falharam.

Perguntas frequentes

Quem escolhe o usuário e a senha do cliente?

O conector. Para cada pedido, ele cria um novo usuário (pm_ e 16 caracteres) e uma senha de 16 caracteres, e os passa ao seu script como PM_USERNAME e PM_PASSWORD. Você não define isso em lugar nenhum.

Meu painel cria o próprio usuário e senha. Posso usá-los?

Sim. Faça o seu create imprimi-los, {"username": "…", "password": "…"}, e o cliente recebe esses no lugar (regra 4).

Preciso saber programar?

Não. Em um script pronto, você altera o endereço do seu painel, o token dele e as duas chamadas que criam e apagam um login; a documentação da API do seu painel mostra isso. O botão Ask AI no topo desta página pode fazer isso com você.

Funciona no Windows?

Sim. Os scripts em Python, Node.js e PHP são iguais no Windows; defina, por exemplo, script: "python C:\pm\panel.py". Um script em PowerShell ou .bat também funciona, se seguir o padrão.

E se o meu sistema for lento ou o conector estiver desligado?

Seu create tem 120 segundos. Depois disso, o cliente recebe o dinheiro de volta e a venda sai dos seus ganhos. O mesmo acontece com pedidos feitos enquanto o conector está desligado. Se ele continuar desligado em duas verificações seguidas (elas rodam a cada 10 minutos), seus planos ficam ocultos até ele voltar. Quando volta, ele apaga os logins dos pedidos que terminaram enquanto estava fora.

Tenho vários servidores. Um conector para todos?

Se um único painel ou script gerencia todos eles, um conector basta. Caso contrário, instale um conector em cada servidor, com a sua própria chave, e defina o API Key / Server de cada plano como a chave do servidor que o atende. Uma chave funciona com um conector por vez.

Posso encerrar um pedido eu mesmo?

Sim: pm-connector expire ORDER_ID encerra o pedido no ProxyMarket e apaga o login dele. Isso não devolve o dinheiro ao cliente.

Como atualizo o conector?

Execute o comando de instalação de novo e depois reinicie o serviço. Seu config.yaml, seu script e os logins dos seus clientes continuam como estão.

Uso o XProxy. Preciso disso?

Não. O painel do XProxy vende no ProxyMarket sozinho: veja Vender com o XProxy.

E agora?

Abra o painel para pegar sua chave ou veja as outras formas de vender.

Ainda com dificuldade?Um técnico pode verificar seu dispositivo com um PIN de uso único, ou fale com a gente no Telegram.