Skip to main content
The OnlyAutomator proxy management system provides a seamless, integrated solution for managing proxy connections. This is crucial for reliable OnlyFans data scraping and automation, ensuring consistency between your browsing sessions and backend tasks. This guide explains how the system works, why it’s essential, and how to use it effectively.

​
Why Use Proxies with OnlyFans?

OnlyFans employs security measures that can invalidate your session (login cookies) if it detects activity from significantly different IP addresses simultaneously. For example, if you browse OnlyFans with your home IP while our backend scraper accesses your account data from a server IP, your session might be terminated, interrupting data collection. The OnlyAutomator proxy system solves this by ensuring both your browser (via the Chrome extension) and our backend scraping service use the exact same IP address for each specific OnlyFans account.

​
Key Benefits

  • Session Preservation: Prevents cookie invalidation by maintaining a consistent IP address across browsing and backend scraping.
  • Account Safety: Reduces the risk of triggering security flags or account suspension due to inconsistent IP activity.
  • Geo-Specific Access: Allows accessing potential region-restricted content or testing geo-targeted features using proxies from specific countries/cities.
  • Automated Management: Eliminates the need for manual proxy configuration in your browser; the extension handles it automatically.

​
How the Proxy System Works

Our integrated system ensures that the proxy assigned to an account is used consistently:
  1. Proxy Assignment (Web App): When an OnlyFans account is connected, a proxy is assigned (either automatically from our pool or manually by you) via the OnlyAutomator web application. This configuration is stored securely. The key details stored include proxy_id, proxy_address, proxy_port, proxy_username, proxy_password, proxy_country_code, proxy_city_name, proxy_mode, proxy_is_active, proxy_assigned_at, and proxy_region_preference.
  2. Chrome Extension Usage: When you navigate to onlyfans.com while logged into OnlyAutomator, the extension retrieves the assigned proxy for the active account and automatically configures your browser (specifically for onlyfans.com traffic) to use that proxy.
  3. Backend Scraper Usage: When OnlyAutomator performs backend tasks for that account (like scraping data), it retrieves the same assigned proxy configuration and routes its requests through it.
This ensures OnlyFans always sees traffic for a specific account coming from the same IP address, regardless of whether it originates from your browser or our backend. Architecture Overview:

​
Proxy Source: Webshare Residential Proxies

For the automatic mode, OnlyAutomator utilizes high-quality residential proxies from Webshare. These offer significant advantages:
  • Residential IPs: Appear as genuine home internet connections, reducing suspicion.
  • Sticky Sessions: Designed to maintain the same IP address for extended periods, crucial for session stability.
  • Geographic Distribution: Proxies available from various countries and cities.
  • Reliability: High uptime and performance suitable for automation.

​
Using the Proxy System

Proxy Assignment Process: When connecting an OnlyFans account, you can choose between automatic assignment (recommended), manual configuration, or disabling proxies. This is the default and recommended mode. When you connect an OnlyFans account:
  1. OnlyAutomator automatically requests a suitable residential proxy from our Webshare pool.
  2. Preferences (like preferred country/city set in settings) are considered during selection.
  3. The assigned proxy details (ID (proxy_id), address (proxy_address), port (proxy_port), credentials (proxy_username/proxy_password), country code (proxy_country_code), city name (proxy_city_name)) are securely stored alongside your account information in Supabase.
  4. The proxy_mode for the account is set to auto.
  5. The extension and backend automatically use this proxy henceforth.
POST /api/proxy/account/{accountId}/assign-auto
Path Parameters:
  • accountId - The OnlyFans account ID to assign a proxy to
Query Parameters (Optional):
  • forceReassign - Boolean, if true will reassign even if a proxy is already assigned
Response Example: 
{
  "success": true,
  "proxy": {
    "address": "xxx.xxx.xxx.xxx",
    "port": 9999,
    "country_code": "US",
    "city_name": "New York",
    "assigned_at": "2023-06-12T15:34:22Z"
  },
  "mode": "auto"
}

​
2. Manual Proxy Configuration

If you prefer to use your own proxy:
  1. Navigate to Account Settings > Proxy Configuration in the OnlyAutomator web app.
  2. Select the “Manual Configuration” option.
  3. Enter your proxy details:
    • Proxy Address (IP or hostname) - Required (proxy_address)
    • Port - Required (proxy_port)
    • Username (if authentication is needed) (proxy_username)
    • Password (if authentication is needed) (proxy_password)
    • Country Code (Optional - e.g., “US”, “DE”) (proxy_country_code)
    • City Name (Optional - e.g., “New York”, “Berlin”) (proxy_city_name)
  4. Click “Save Configuration”. The system will attempt to test the proxy connection before saving.
  5. If the test passes, the details are saved, and proxy_mode is set to manual.
POST /api/proxy/account/{accountId}/set-manual
Path Parameters:
  • accountId - The OnlyFans account ID to set a manual proxy for
Request Body: 
{
  "proxy_address": "123.456.789.012",
  "proxy_port": 8080,
  "proxy_username": "username",     // Optional
  "proxy_password": "password",     // Optional
  "proxy_country_code": "DE",       // Optional
  "proxy_city_name": "Berlin"       // Optional
}
Response Example: 
{
  "success": true,
  "proxy": {
    "address": "123.456.789.012",
    "port": 8080,
    "country_code": "DE",
    "city_name": "Berlin",
    "assigned_at": "2023-06-12T15:34:22Z"
  },
  "mode": "manual"
}

​
3. Disabling the Proxy

If you need to disable proxy usage for an account (not generally recommended for active scraping):
  1. Go to Account Settings > Proxy Configuration.
  2. Select the “Disable Proxy” or similar option.
  3. This sets the proxy_mode to none and marks proxy_is_active as false.
POST /api/proxy/account/{accountId}/disable
Path Parameters:
  • accountId - The OnlyFans account ID for which to disable the proxy
Response Example: 
{
  "success": true,
  "message": "Proxy disabled for account",
  "mode": "none"
}

​
Monitoring Proxy Status

The Chrome extension provides real-time feedback on the proxy status while you browse onlyfans.com:
  • Green Icon: Proxy active and correctly configured. Your browsing and backend tasks use the same IP.
  • Yellow Icon: Proxy active, but might be different from the last known IP (e.g., after a reassignment). Usually resolves quickly.
  • Red Icon: Proxy connection failed or is inactive.
  • Gray Icon: Proxy usage is disabled for this account (proxy_mode: none).
You can click the extension icon for more details, including the current proxy IP and country.

​
Troubleshooting Connection Issues

Proxy Usage Flow: When you browse OnlyFans, the extension configures your browser to route OnlyFans traffic through the assigned proxy. When the backend scraper needs to access your account data, it uses the exact same proxy configuration, ensuring IP consistency. If you suspect proxy problems:
  1. Check Status: Look at the extension icon color and click for details.
  2. Test Connection (UI): Use the “Test Connection” button often available in the Account Settings -> Proxy section of the web app. This likely uses the /api/proxy/test-connectivity endpoint internally.
  3. Check Your IP: Use an external tool or the OnlyAutomator utility endpoint (GET /api/whatsmyip) from your browser to see your current apparent IP. Does it match the proxy assigned?
  4. Re-assign Proxy (UI): If using auto mode and the proxy seems faulty, use the “Re-assign Proxy” option in the web app. This typically triggers /api/proxy/account/{accountId}/handle-failure or /api/proxy/account/{accountId}/assign-auto with forceReassign=true.
  5. Verify Manual Config: If using manual mode, double-check your address, port, username, and password. Test them using /api/proxy/test-connectivity if possible.

​
Advanced Settings

​
Regional & City Preferences

For auto mode, you can guide the proxy selection:
  1. Go to Account Settings > Proxy Configuration.
  2. Set your Preferred Region (e.g., “US”, “DE”) and optionally Preferred City (e.g., “New York”, “Frankfurt”).
  3. Click “Save Preferences”.
OnlyAutomator will prioritize assigning proxies matching these preferences when available in the Webshare pool. 
PUT /api/proxy/account/{accountId}/preference
Path Parameters:
  • accountId - The OnlyFans account ID to set proxy preferences for
Request Body: 
{
  "country": "US",       // Preferred country code
  "city": "New York"     // Optional preferred city
}
Response Example: 
{
  "success": true,
  "message": "Proxy preferences updated",
  "preferences": {
    "country": "US",
    "city": "New York"
  }
}

​
Proxy Mode Selection

You can switch between modes (auto, manual, none) in the account’s proxy settings.

​
Handling Proxy Failures Automatically

If a proxy assigned in auto mode fails repeatedly:
  1. The backend system or the extension might detect the failure.
  2. A call can be made to the proxy failure handling endpoint.
  3. If autoReassign is true (default), the system attempts to assign a new proxy from the pool automatically.
  4. Scraping might be paused temporarily until a working proxy is available.
POST /api/proxy/account/{accountId}/handle-failure
Path Parameters:
  • accountId - The OnlyFans account ID with the failing proxy
Query Parameters:
  • autoReassign - Boolean, defaults to true. If true, automatically assigns a new proxy.
Response Example: 
{
  "success": true,
  "message": "Proxy failure handled",
  "action": "reassigned",
  "new_proxy": {
    "address": "xxx.xxx.xxx.xxx",
    "port": 9999,
    "country_code": "US",
    "city_name": "Miami",
    "assigned_at": "2023-06-12T16:45:33Z"
  }
}

​
Testing Proxy Connectivity

To verify if a proxy configuration works properly: 
POST /api/proxy/test-connectivity
Request Body: 
{
  "proxy_address": "123.456.789.012",
  "proxy_port": 8080,
  "proxy_username": "username",     // Optional
  "proxy_password": "password"      // Optional
}
Response Example: 
{
  "success": true,
  "ip_detected": "123.456.789.012",
  "latency_ms": 245,
  "country": "US"
}

​
Getting Your Current IP

To check your current apparent IP address: 
GET /api/whatsmyip
Response Example: 
{
  "ip": "123.456.789.012",
  "country": "US",
  "city": "New York",
  "is_proxy": true
}

​
Retrieving Current Proxy Configuration

To retrieve the current proxy configuration for an account:
  • Manual proxy credentials (username/password) are stored encrypted in the Supabase database.
  • Webshare API keys and assigned proxy credentials used in auto mode are handled securely on the backend.
  • API endpoints require JWT authentication.
  • The Chrome extension applies proxy settings only to traffic destined for *.onlyfans.com domains, leaving your other browsing unaffected.
GET /api/proxy/account/{accountId}
Path Parameters:
  • accountId - The OnlyFans account ID to get proxy configuration for
Response Example: 
{
  "success": true,
  "proxy": {
    "address": "xxx.xxx.xxx.xxx",
    "port": 9999,
    "country_code": "US",
    "city_name": "New York",
    "assigned_at": "2023-06-12T15:34:22Z",
    "is_active": true
  },
  "mode": "auto",
  "preferences": {
    "country": "US",
    "city": null
  }
}

​
Conclusion

The OnlyAutomator proxy system is designed to solve the critical IP consistency challenge inherent in automating OnlyFans interactions. By synchronizing proxy usage between the Chrome extension and backend services, it ensures session validity, enhances account safety, and enables reliable data scraping. Utilizing the auto mode is recommended for a seamless experience. For further questions or assistance with specific proxy setups, please consult the API documentation or contact support.