Skip to content

proxy-manager

Fresh

Source: BIBLE.md (Phase 12 Phase 2, proxy-manager 7 routes)

CRUD for proxies, health checks, auto-rotation, assignment to profiles. Wraps existing core/proxy-rotate.mjs ProxyPool.

Routes (7)

MethodRouteWhat
GET/proxiesList proxies
POST/proxiesAdd proxy
DELETE/proxies/:idRemove
POST/proxies/:id/health-checkTest the connection
GET/proxies/healthPool health stats
POST/proxies/rotateForce rotate the pool
POST/proxies/assignAssign proxy to account

Example payloads

Add proxy

bash
curl -X POST http://localhost:4700/proxies \
  -H "Content-Type: application/json" \
  -H "x-api-key: ghost-engine-key" \
  -d '{
    "host": "1.2.3.4",
    "port": 8080,
    "username": "u",
    "password": "p",
    "type": "http",
    "location": "Dallas, TX"
  }'

Health check

bash
curl -X POST http://localhost:4700/proxies/proxy-123/health-check

Marriage vs pool

Two patterns:

  • Marriage: permanent 1:1 binding per persona, stored in proxy-marriages.json. Never rotates
  • Pool: 100 session proxies in data/proxy-pool.json for fallback when married proxy gets rejected