Conector de ProxyMarket: vende tus proxies sin programar
Preguntar a la IA
Tarea listaInstala y configura pm-connector en tu servidor
Agentes de código
Claude CodeAbre la app de escritorioCodexAbre la app de escritorioCursorAbre la app desde la webAsistentes de chat
Abrir en ChatGPTNueva pestañaAbrir en ClaudeNueva pestañaCopiar
Ver como MarkdownTexto plano para herramientas de IAVer el 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 Spanish: https://xproxy.io/es/document/proxymarket-connector. The Markdown copy is in English. Answer in Spanish.
La app se abre con el prompt ya escrito. No se ejecuta nada hasta que pulses Enter.
Ya vendes proxies desde tus propios servidores. pm-connector es un pequeño programa que permite a ProxyMarket venderlos por ti. Cuando un cliente paga, le da acceso a tu proxy. Cuando termina el alquiler, le vuelve a quitar el acceso. No necesitas un dominio ni un puerto abierto para ello.
Necesitas: una cuenta de vendedor en market.xproxy.io, un servidor Linux o Windows que pueda llegar a tu panel de proxies o al archivo de contraseñas de tu proxy, y proxies a los que los clientes puedan llegar desde internet.
¿Cómo funciona?
Cuando vendes un proxy a mano, haces dos cosas: creas un usuario y una contraseña para el comprador, y los eliminas cuando termina el alquiler. El conector hace lo mismo con cada pedido, a través de un script tuyo:
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 eliges el usuario ni la contraseña de un cliente: el conector los genera y se los pasa a tu script. El tráfico de los clientes nunca pasa por el conector ni por ProxyMarket; los clientes se conectan directamente a tu proxy.
¿Cómo empiezo a vender?
Instala el conector en un servidor que pueda llegar a tu panel de proxies o al archivo de contraseñas de tu proxy.
bashcurl -fsSL https://x-proxy.io/pm-connector/install.sh | sh pm-connector versionPara Linux en servidores y equipos Intel/AMD (amd64) y ARM (arm64, armv7). El script verifica la descarga y coloca
pm-connectoren/usr/local/bin.Ejecuta
pm-connector init. Te hace una sola pregunta: ¿puede ProxyMarket llegar a este servidor desde internet? ProxyMarket lo necesita para enviarte pedidos, para terminarlos y para el botón Change IP del cliente.- No, or not sure (no, o no estoy seguro; recomendado). No abres nada. El conector se conecta hacia ProxyMarket y todo llega por esa conexión. Funciona detrás de cualquier router, NAT o línea 4G. Clave que debes crear: ProxyMarket hook.
- Yes (sí). Rediriges un puerto de tu router a este servidor o apuntas a él tu propia dirección pública (cómo). Clave que debes crear: Custom webhook (your server).
Después te indica qué clave crear en el Vendor Dashboard, en API Keys → New key. Pega la clave cuando te la pida: solo se muestra una 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 installEscribe tu script o parte de uno ya hecho. El conector ejecuta un programa tuyo en cada pedido. Puede estar en cualquier lenguaje, con cualquier nombre y en cualquier carpeta: solo le indicas al conector el comando que lo inicia. Estos scripts listos son un punto de partida; cámbialos como quieras o escribe el tuyo desde cero.
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 pythonescribe este archivo junto aconfig.yamly configurascript: "python3 panel.py".pm-connector sample python(onode,php,3proxy) coloca un script listo junto aconfig.yaml. En él, cambia las líneas marcadas conCHANGE: dónde está tu panel, su token y las dos llamadas que añaden y eliminan un acceso. Las partes marcadas conOPTIONALpueden esperar (para qué sirven).Después pon en
config.yamlel comando que inicia tu script. Este es el archivo completo: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)Lo que el conector espera de un script, sea cual sea el lenguaje, está en el estándar de scripts más abajo.
Ejecuta
pm-connector test. Ejecuta tu script con un acceso de prueba: lo añade, lo comprueba y lo elimina. Corrige cada línea con ❌ antes de continuar (qué significan).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 installMantenlo en marcha como servicio, para que arranque con el servidor y vuelva tras un fallo.
bashsudo pm-connector service install journalctl -u pm-connector -f # watch the logArranca con el servidor y se reinicia si alguna vez se detiene.
Añade tus planes. Un plan es una cosa que un cliente puede comprar. En el Vendor Dashboard abre My Plans → New plan e introduce su nombre, país, precio, cuánto dura, y la IP y el puerto del proxy a los que se conectan los clientes. En API Key / Server elige tu clave. Qué significa cada campo.
Envíate un pedido de prueba. En Integration Status pulsa Send test order. Es gratis, no lo ven los clientes y termina solo a los 10 minutos. Verás cómo cada paso pasa a ✅: pedido enviado, acceso añadido, acceso funciona, acceso eliminado. Si todo está en verde, ya estás a la venta.
El estándar de scripts: ¿qué debe hacer mi script?
Esta es toda la interfaz entre el conector y tu script: una palabra en la línea de comandos, los datos del pedido como valores PM_ y cómo termina el script. No hay más argumentos, nada que instalar y nada que importar, así que funciona en cualquier lenguaje. Los scripts listos ya lo cumplen.
Puedes ejecutar tu script a mano exactamente igual que lo hace el conector:
# 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. Se ejecuta con una palabra: la acción
El conector ejecuta el comando de script: y añade una palabra que indica qué hacer, por ejemplo python3 panel.py create.
| Acción | Cuándo la ejecuta el conector | Qué hace tu script | ¿Obligatoria? |
|---|---|---|---|
create | Un cliente ha pagado | Añade el acceso PM_USERNAME / PM_PASSWORD | Obligatoria |
delete | El alquiler terminó, o el pedido se canceló o se reembolsó | Elimina el acceso PM_USERNAME. Si ya estaba eliminado, cuenta como hecho | Obligatoria |
rotate | El cliente pulsó Change IP | Cambia la IP del módem de PM_PORT. Puede imprimir la IP nueva | Opcional |
whitelist | El cliente indicó qué IP pueden usar el proxy | Permite usar ese acceso solo a las IP de PM_IP_WHITELIST | Opcional |
list | Limpieza, por ejemplo después de reinstalar el conector | Imprime los accesos que existen, uno por línea | Opcional |
actions | Cuando arranca el conector | Imprime las acciones que tiene, una por línea. Sin ella, el conector solo usa create y delete | Para las acciones opcionales |
2. Lee el pedido de los valores PM_
El conector pasa los datos como variables de entorno: valores con nombre que cualquier lenguaje puede leer. En shell $PM_USERNAME, en Python os.environ["PM_USERNAME"], en Node.js process.env.PM_USERNAME, en PowerShell $env:PM_USERNAME.
| Valor | Por ejemplo | De dónde sale |
|---|---|---|
PM_USERNAME | pm_9b1c2d3e4f506172 | Lo genera el conector, nuevo para cada pedido. Siempre empieza por pm_ |
PM_PASSWORD | k7m2xq4wyhn3bt5d | Lo genera el conector, nuevo para cada pedido |
PM_PORT | 31001 | El Proxy Port que escribiste en el plan que compró el cliente. Indica a tu sistema qué módem o puerto se vendió |
PM_HOST | 203.0.113.5 | La Proxy IP que escribiste en ese plan |
PM_PLAN | modem-7 | Your ID de ese plan, si lo rellenaste |
PM_ORDER_ID, PM_EXPIRES_AT | el número del pedido y su hora de fin | El pedido en ProxyMarket |
PM_IP_WHITELIST | 198.51.100.7,198.51.100.8 | Solo para whitelist: las IP que permite el cliente, separadas por comas. Vacío significa todo el mundo |
Valores que recibe cada acción:
| Acción | 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 | ninguno |
3. Indica si ha funcionado
- Funcionó: el script termina con normalidad (código de salida 0).
- Falló: el script termina con un error (cualquier otro código de salida) e imprime el motivo. El conector muestra ese texto en su registro y en Integration Status. Si
createfalla, al cliente se le devuelve el dinero. - Cada ejecución puede tardar hasta 120 segundos. El conector ejecuta una acción cada vez, así que tu script no necesita bloqueos.
4. Si tiene algo que contar, imprime una línea
La mayoría de los scripts no imprimen nada. Solo cuando tu sistema decide algo que el conector no puede saber, create lo imprime como una línea de JSON, la ú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, lista blanca de IP, limpieza
Los scripts de Python, Node.js y shell ya incluyen estas acciones. Conserva las que tu sistema pueda hacer y elimina las demás; el conector le pregunta a tu script cuáles tiene. En un script propio, añádelas de la misma 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: con ella, los clientes tienen un botón Change IP y rotación automática.whitelist: con ella, los clientes pueden limitar qué IP pueden usar su proxy.list: con ella, el conector también encuentra y elimina los accesospm_que hayan quedado, por ejemplo después de reinstalarlo. Nunca toca un acceso que no empiece porpm_.
¿Cómo configuro mis planes?
Un plan es una cosa que un cliente puede comprar, por ejemplo US T-Mobile 4G, 30 días, $25. Los planes se crean en Vendor Dashboard → My Plans, y ahí puedes cambiar el precio o pausar un plan en cualquier momento.
| Campo | Qué introducir |
|---|---|
| Name, Country, Proxy Type, Protocol | Lo que ven los clientes y por lo que filtran |
| Duration, Price | Cuánto dura una compra y cuánto cuesta |
| Stock | Cuántos clientes pueden usar el plan a la vez. Pon 1 para un módem que alquilas a una sola persona. Cada venta ocupa uno; vuelve a estar libre cuando termina el pedido |
| Proxy IP, Proxy Port | La dirección pública a la que se conectan los clientes. Tu script la recibe como PM_HOST y PM_PORT |
| API Key / Server | La clave de tu conector. Los pedidos de este plan van a ese conector |
| Your ID (opcional) | Tu propio nombre para el plan, por ejemplo modem-7. Tu script lo recibe como PM_PLAN |
Deja vacíos Proxy Username, Proxy Password y Rotation Link: el conector crea un acceso nuevo para cada pedido.
Tengo muchos módems. ¿Un plan para cada uno?
- Un plan por módem, cuando los clientes deban elegir uno concreto. Da a cada plan su propio Proxy Port y Stock 1.
- Un plan para todos, cuando sirva cualquier módem libre. Pon en Stock el número de módems y deja vacíos Proxy IP y Proxy Port. Tu
createelige un módem libre e imprime su dirección:{"host": "203.0.113.5", "port": 31007}.
¿Qué puedo vender?
- Proxies: HTTP, SOCKS5 o ambos, de cualquier tipo (móviles, residenciales, de datacenter, ISP, IPv6). El cliente recibe la IP y el puerto de tu proxy con el usuario y la contraseña que creó el conector.
- VPN: OpenVPN, WireGuard o VLESS. El cliente recibe un archivo de configuración o un enlace
vless://en lugar de un acceso. En el plan, elige Proxy Type: VPN y el VPN Protocol.
Para VPN hay dos formas de entregar la configuración. Si todos los clientes de un plan pueden usar la misma configuración, pégala en el campo VPN Config del plan y tu script no tiene que hacer nada. Si cada cliente necesita la suya, tu create la crea e imprime {"vpn_config": "…the whole config…"}.
He respondido «Yes». ¿Cómo lo abro a ProxyMarket?
En ese caso, ProxyMarket llama directamente a tu servidor en lugar de usar la conexión saliente del conector. Elige una opción:
- Redirección de puertos (NAT). En tu router, redirige el puerto TCP
8787a este servidor, igual que rediriges los puertos de tus proxies. Tu dirección eshttp://YOUR_PUBLIC_IP:8787. Los datos de acceso del cliente siguen viajando cifrados. - Tu propia dirección HTTPS. Cualquier cosa que sirva HTTPS y reenvíe las peticiones al puerto
8787: tu proxy inverso (Caddy, nginx, IIS), un Cloudflare Tunnel o Tailscale Funnel. Tu dirección es, por ejemplo,https://pm.example.com.
init lo escribe en config.yaml y empieza a responder en el puerto, para que ProxyMarket pueda comprobarlo. Después crea la clave como Custom webhook (your server) con tu dirección 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 server¿Al final no es accesible? Ejecuta de nuevo pm-connector init y responde No. Todo lo demás de esta página es igual para ambas respuestas.
¿Qué significan los mensajes de la prueba?
| Ves | Qué hacer |
|---|---|
| ❌ Key rejected | Pega la clave completa, que empieza por pm_. Si sigue fallando, la clave se eliminó o se desactivó en API Keys: crea una nueva |
| ❌ This key is not a ProxyMarket hook key | Respondiste No, pero pegaste una clave Custom webhook. Crea una clave nueva de tipo ProxyMarket hook, o ejecuta de nuevo init y responde Yes |
| ❌ ProxyMarket cannot reach http://…:8787 | Respondiste Yes, pero el puerto no está abierto: revisa la redirección de puertos y el cortafuegos, o ejecuta de nuevo init y responde No |
| ❌ Cannot reach ProxyMarket | El servidor necesita HTTPS saliente (puerto 443) hacia market.xproxy.io y market-hook-service.xproxy.io. Revisa el cortafuegos y el DNS |
| ❌ Script does not run: … | El comando de script: no pudo arrancar: revisa la ruta y que python3 o node estén instalados |
| ❌ create failed: … o delete failed: … | El texto tras los dos puntos es lo que imprimió tu script, normalmente la respuesta de tu panel. Revisa las líneas marcadas con CHANGE (dirección, token, las dos llamadas) y vuelve a probar |
| ❌ list: the test login is not there | create dijo que funcionó, pero falta el acceso: comprueba que create y list usan el mismo panel o archivo |
| ⚠️ Proxy IP … does not accept connections | Los clientes no podrán conectarse: abre el puerto en tu cortafuegos o router, o corrige Proxy IP y Proxy Port en el plan |
| Vendor account not approved yet | Tu clave funciona, pero un administrador aún no ha aprobado tu cuenta de vendedor. Escribe a @xproxyio con el email de tu cuenta |
Cuando ya estés a la venta, la pestaña Integration Status del Vendor Dashboard muestra si el conector está conectado, qué planes están publicados u ocultos y por qué, y los últimos pedidos con el error de los que fallaron.
Preguntas frecuentes
¿Quién elige el usuario y la contraseña del cliente?
El conector. En cada pedido genera un usuario nuevo (pm_ y 16 caracteres) y una contraseña de 16 caracteres, y se los pasa a tu script como PM_USERNAME y PM_PASSWORD. No los configuras en ningún sitio.
Mi panel crea su propio usuario y contraseña. ¿Puedo usarlos?
Sí. Haz que tu create los imprima, {"username": "…", "password": "…"}, y el cliente recibirá esos en su lugar (regla 4).
¿Necesito saber programar?
No. En un script listo cambias la dirección de tu panel, su token y las dos llamadas que añaden y eliminan un acceso; la documentación de la API de tu panel las explica. El botón Ask AI de la parte superior de esta página puede hacerlo contigo.
¿Funciona en Windows?
Sí. Los scripts de Python, Node.js y PHP son iguales en Windows; pon por ejemplo script: "python C:\pm\panel.py". Un script de PowerShell o .bat también funciona si sigue el estándar.
¿Y si mi sistema es lento o el conector está apagado?
Tu create tiene 120 segundos. Pasado ese tiempo, al cliente se le devuelve el dinero y la venta se resta de tus ganancias. Lo mismo ocurre con los pedidos que llegan mientras el conector está apagado. Si sigue apagado en dos comprobaciones seguidas (se hacen cada 10 minutos), tus planes se ocultan hasta que vuelva. Al volver, elimina los accesos de los pedidos que terminaron mientras no estaba.
Tengo varios servidores. ¿Un conector para todos?
Si un solo panel o script los gestiona todos, basta con un conector. Si no, instala un conector en cada servidor, con su propia clave, y en API Key / Server de cada plan pon la clave del servidor que lo atiende. Una clave funciona con un solo conector a la vez.
¿Puedo terminar un pedido yo mismo?
Sí: pm-connector expire ORDER_ID termina el pedido en ProxyMarket y elimina su acceso. No le devuelve el dinero al cliente.
¿Cómo actualizo el conector?
Vuelve a ejecutar el comando de instalación y reinicia el servicio. Tu config.yaml, tu script y los accesos de tus clientes se quedan como están.
Uso XProxy. ¿Necesito esto?
No. El panel de XProxy vende en ProxyMarket por sí solo: consulta Vender con XProxy.
¿Y ahora qué?
Abre el panel para obtener tu clave, o mira las otras formas de vender.

