Introduction

Welcome to the official ProXiFi documentation. This document serves as the authoritative reference for understanding the ProXiFi platform — its mission, architecture, product offerings, technical design, and commercial model.

ProXiFi is a mobile proxy infrastructure platform built for operators, developers, and businesses that require authentic, high-trust mobile IP addresses at scale. Unlike datacenter or residential proxies, ProXiFi routes traffic exclusively through real SIM-connected mobile devices, producing IP addresses that are indistinguishable from a real smartphone on a carrier network.

This documentation covers both the hosted proxy service (where ProXiFi manages the hardware) and the ProXiFi Proxy Manager software (where operators run their own device fleets on their own servers).

What is ProXiFi?

ProXiFi is a dual-product mobile proxy platform. At its core it provides two things: a managed mobile proxy service for end users who want ready-to-use mobile IPs, and a software product for operators who want to build and run their own proxy farms.

Managed Proxy Service

Users subscribe to a shared or dedicated mobile proxy plan and receive HTTP and SOCKS5 credentials that route through real SIM-connected Android devices. Proxies can be rotated on demand, on a timer, or via the rotation API. The ProXiFi dashboard provides real-time connection status, usage metrics, and one-click IP rotation.

Proxy Manager Software

A self-hosted software suite that operators install on their own Windows or Linux server. It discovers USB-connected LTE modems and Android phones, assigns proxy ports, manages IP rotation, controls multi-user access, and exposes a REST API — turning any device rack into a production proxy operation with no per-device configuration.

Who It's For

• Performance marketers running accounts across ad platforms
• E-commerce operators managing inventory bots and price scrapers
• Automation agencies running anti-detect browser workflows
• Data engineers collecting public web data at scale
• Proxy resellers looking for white-label infrastructure
• Security researchers testing geo-dependent application behavior

The Problem & The Solution

The Problem

Modern web platforms — ad networks, social media, e-commerce sites, and financial services — have invested heavily in proxy detection. Datacenter IP ranges are blocked by default on most major platforms. Residential proxies are frequently flagged due to shared abuse history, inconsistent geolocation, and mismatched TCP fingerprints. Even premium proxy providers often deliver IPs that are already burned before you receive them.

For operators running at scale, a flagged or banned proxy means lost work, chargebacks on ad spend, and compromised data integrity. The market has long needed a proxy solution that is genuinely indistinguishable from a real mobile user at every layer of inspection.

The Solution

ProXiFi routes all traffic through real SIM-connected mobile devices on major carrier networks. Every connection originates from a genuine mobile IP, carries the correct carrier DNS, passes OS-level TCP fingerprint checks, and presents realistic mobile network metadata. No heuristic or ML-based detection layer can distinguish a ProXiFi proxy from an actual smartphone user.

Use Cases & Industry Applications

Mobile proxies are required in any workflow where platform trust, geo-accuracy, or anti-detection is critical. Below are the primary verticals ProXiFi serves today.

Roadmap

The ProXiFi roadmap prioritizes product-market fit in the core proxy market before expanding into adjacent infrastructure and data products. All dates are targets and subject to change.

Financial Projections

ProXiFi operates a dual revenue model: recurring monthly subscriptions for the hosted proxy service, and one-time license sales for the Proxy Manager software. The following projections are based on conservative adoption assumptions and do not account for enterprise or white-label contracts.

Revenue Streams

Year 1 Targets

These projections assume organic growth through SEO, community channels, and direct outreach to automation and digital marketing communities. Enterprise contracts and reseller agreements are not included and represent upside to these numbers.

The Technicals

ProXiFi's technical architecture is built on three pillars: real mobile hardware, a proxy orchestration layer, and a management control plane. Each layer is designed for reliability, horizontal scalability, and security-by-default.

Hardware Layer

The hardware fleet consists of USB LTE/5G modems (Huawei, ZTE, Quectel, Sierra Wireless) and rooted/tethered Android 8+ phones. Devices are connected to Linux servers via USB hubs. Each device maintains a persistent cellular data connection to its carrier network.

Proxy Layer

Each connected device is assigned sequential HTTP (port 10000+) and SOCKS5 (port 20000+) proxy endpoints. Traffic is routed through the device's cellular interface using OS-level network namespace isolation, ensuring no cross-device traffic leakage.

Control Plane

The Proxy Manager control plane is a Node.js service that monitors device health, handles rotation requests, enforces bandwidth quotas, and exposes the management REST API. The web dashboard communicates with the control plane over authenticated WebSocket connections for real-time status updates.

Cloud Infrastructure (Hosted Service)

• Device servers: bare-metal Linux with USB hub connectivity
• Control plane: containerized Node.js on managed cloud (auto-scaling)
• Database: MongoDB Atlas (multi-region replication)
• Auth: Clerk — JWT-based session management
• Payments: Stripe — PCI-DSS compliant checkout and webhooks
• CDN: Vercel Edge Network for the web application layer

Core Features

Technical Design

Network Architecture

Each device server runs an instance of the ProXiFi device daemon. The daemon uses network namespaces (Linux) or routing tables (Windows) to bind each proxy process to a specific device interface, preventing any cross-device routing.

Proxy Process Model

Each device spawns an isolated proxy process listening on its assigned HTTP and SOCKS5 ports. Authentication is enforced at the proxy process level with per-user credentials. Credential rotation is handled atomically — new credentials are active before old ones are invalidated.

IP Rotation Flow

1. Rotation request received (dashboard, timer, or API call)
2. Device daemon sends AT command or ADB command to the modem/phone to drop and re-establish the data connection
3. New carrier IP assigned by DHCP from the carrier network
4. Proxy process rebinds to new interface IP
5. Rotation event logged with timestamp, old IP, and new IP
6. Webhook fired (if configured) with rotation payload

Data Model

Authentication Flow

All web requests are authenticated via Clerk JWTs. API routes validate the JWT on every request using the Clerk SDK. Stripe webhooks are verified using HMAC-SHA256 signature validation against STRIPE_WEBHOOK_SECRET before any database writes occur.

Security & Compliance

Data Security

• All data in transit encrypted via TLS 1.2+ (enforced at Vercel edge and MongoDB Atlas)
• MongoDB Atlas encrypts all data at rest using AES-256
• Proxy credentials are stored hashed — plaintext passwords never persisted after provisioning
• Clerk handles all authentication — ProXiFi never stores plaintext passwords
• Stripe handles all payment data — ProXiFi is never in scope for PCI-DSS cardholder data

Payment Compliance

All payment processing is delegated to Stripe, a PCI-DSS Level 1 certified payment processor. ProXiFi's Stripe integration uses Stripe Checkout (hosted payment page) to ensure cardholder data never touches ProXiFi servers. Webhook authenticity is verified via Stripe's HMAC signature before processing any event.

Access Control

• Role-based access: users can only access their own proxies and licenses
• All API routes protected by Clerk authentication middleware
• Stripe customer isolation — users can only modify their own subscriptions
• Proxy Manager user accounts support per-device permission assignment

Infrastructure Security

• Device servers are not publicly addressable — only inbound proxy ports are exposed
• Admin control plane requires VPN or SSH tunnel access
• Automated dependency scanning via GitHub Dependabot
• Environment secrets managed via Vercel encrypted environment variables

SLA

ProXiFi commits to the following service level targets for the hosted proxy service. These targets apply to the proxy availability and management dashboard uptime.

Exclusions

SLA commitments do not apply to downtime caused by: scheduled maintenance (announced 48 hours in advance), carrier network outages outside ProXiFi's control, force majeure events, or customer misconfiguration.

Credits

If uptime falls below the committed target in any calendar month, affected customers are eligible for a pro-rated service credit applied to the following billing cycle. Credits must be requested within 30 days of the incident via support@proxifi.net.

Getting Started

Hosted Proxy Service

1. Create an account at proxifi.net/sign-up
2. Navigate to Dashboard → Plans and select your plan
3. Complete checkout via Stripe (card payment)
4. Your proxy credentials appear in Dashboard → ProXiFi within seconds of payment confirmation
5. Copy your host:port:username:password into your tool of choice
6. Use Dashboard → ProXiFi to rotate your IP on demand

Proxy Manager Software

1. Purchase at proxifi.net/proxy-manager
2. Receive your license key and download link by email
3. Run the installer on your Windows or Linux server
4. Connect USB LTE modems or Android phones via USB
5. Open the web dashboard (default: http://localhost:8080)
6. Devices appear automatically — proxies are live within 30 seconds of connection

Connecting to Your Tools

Plans & Pricing

Hosted Proxy Service

Proxy Manager Software

All Plans Include

• HTTP and SOCKS5 proxy support
• Dashboard access and real-time monitoring
• Auto IP rotation capabilities
• Cancel any time (subscriptions)
• Secure checkout via Stripe

All prices are in USD. Subscriptions are billed monthly and can be canceled at any time from Dashboard → Billing. The Proxy Manager is a one-time purchase with no recurring fees.

Developers and API Access

ProXiFi exposes a REST API for proxy management, IP rotation, and account operations. API access is available on Standard and Premium plans for the hosted service, and included with all Proxy Manager software licenses.

Authentication

All API requests require a Bearer token in the Authorization header. Tokens are generated from Dashboard → API Keys (coming Q3 2026). During beta, API access is via session cookie on authenticated dashboard routes.

Base URL

Endpoints

Example — Rotate a Proxy

Rate Limits

Terms of Service

Last updated: March 2026. By accessing or using ProXiFi services you agree to these terms. If you do not agree, do not use the service.

1. Acceptable Use

ProXiFi services may only be used for lawful purposes. You may not use ProXiFi to:

• Violate any applicable local, state, national, or international law or regulation
• Conduct unauthorized access or attacks against any system, network, or device
• Send unsolicited bulk email (spam) or engage in phishing campaigns
• Scrape or harvest personal data in violation of GDPR, CCPA, or other privacy laws
• Engage in fraud, identity theft, or impersonation
• Circumvent security measures of systems you do not own or have authorization to access

2. Account Responsibilities

You are responsible for all activity that occurs under your account. You must maintain the confidentiality of your credentials and notify ProXiFi immediately of any unauthorized use at support@proxifi.net.

3. Payment & Refunds

Subscription fees are billed monthly in advance and are non-refundable except as required by law. One-time software licenses are non-refundable after the download link has been accessed. ProXiFi reserves the right to modify pricing with 30 days notice to active subscribers.

4. Service Availability

ProXiFi provides the service on an “as is” basis. We do not guarantee uninterrupted or error-free service. SLA credits, where applicable, represent the sole remedy for downtime.

5. Termination

ProXiFi reserves the right to suspend or terminate accounts that violate these terms without prior notice. Upon termination, your right to access the service ceases immediately. No refunds will be issued for terminated accounts.

6. Limitation of Liability

To the maximum extent permitted by law, ProXiFi's total liability for any claim arising from use of the service shall not exceed the amount paid by you in the 30 days preceding the claim. ProXiFi is not liable for indirect, incidental, or consequential damages.

7. Governing Law

These terms are governed by the laws of the United States. Disputes shall be resolved by binding arbitration in accordance with the AAA Commercial Arbitration Rules.

8. Contact

For questions regarding these terms, contact us at support@proxifi.net.