Proxy Setup for Traffic4SEO App


Introduction

A proxy allows the Traffic4SEO App to use an IP address different from your real IP when executing workflows. This helps with:

  • IP Diversity: Workflows are executed from different countries/regions.
  • Increasing Earnings: Many workflow owners pay more for IPs from specific countries.
  • Running Multiple Instances: Each instance can use a different proxy.

{success} Optional: Proxies are NOT mandatory. You can still earn tokens normally without a proxy. Proxies simply help increase your chances of receiving workflows and your earning potential.


Why Use a Proxy?

Benefits of Using a Proxy

1. More Workflows

Some workflows are only available for IPs from specific countries:

Workflow: "Search Google US for keyword X"
Requirement: US IP address
Payment: 10 tokens

Without a US proxy, you won't receive this workflow.

2. Running Multiple Instances

With proxies, you can run multiple instances simultaneously without needing to create virtual machines or VPS.

Instance 1: Direct IP (Vietnam) → Earn from VN workflows
Instance 2: US Proxy → Earn from US workflows
Instance 3: UK Proxy → Earn from UK workflows

→ Triple your earning potential!


Supported Proxy Types

Traffic4SEO App supports 3 types of proxies:

1. HTTP/HTTPS Proxy

Characteristics:

  • Most common.
  • Fast speed.
  • Low cost.

Format:

http://host:port
https://host:port

# With authentication
http://username:password@host:port

Use case: Web browsing, suitable for most workflows.

2. SOCKS5 Proxy

Characteristics:

  • Supports many protocols.
  • More secure than HTTP.
  • Less likely to be blocked.

Format:

socks5://host:port
socks5://username:password@host:port

Use case: Complex workflows requiring high security.

3. Residential Proxy

Characteristics:

  • IP from a real ISP (not a datacenter).
  • Very difficult to detect and block.
  • Most expensive.

Format: Same as HTTP/SOCKS5, depending on the provider.

Use case: Workflows requiring "real user" behavior.


How to Set Up a Proxy

Traffic4SEO App supports proxy configuration via Command Line and Desktop Shortcuts. You can pass proxy details when starting the app or pre-configure them in shortcuts on Windows and Linux (Ubuntu).

{info} Note: Currently, the app does not have an in-app settings UI for configuring proxies. You must use command-line arguments when launching the app or create a Desktop Shortcut.

Setting Up a Proxy via Command Line

Traffic4SEO supports the --proxy (or -p) parameter using the standard Proxy Connection URI format. You can pass your proxy details as a single URI string when starting the app or CLI.

Supported Proxy Connection URI Formats

Format Variant URI Example Protocol Auth
ip:port --proxy="192.168.1.100:8080" HTTP (Default) None
username:password@ip:port --proxy="user:[email protected]:8080" HTTP (Default) Yes
schema://ip:port --proxy="http://192.168.1.100:8080"
--proxy="socks5://192.168.1.100:1080"
Specified (http, socks5) None
schema://username:password@ip:port --proxy="http://user:[email protected]:8080"
--proxy="socks5://user:[email protected]:1080"
Specified (http, socks5) Yes

{primary} Protocol Defaulting: If you omit the scheme (http:// or socks5://), Traffic4SEO automatically defaults to http://.

Command Line Examples

Windows
# 1. IP and Port only (defaults to HTTP)
Traffic4SEO.exe --proxy="192.168.1.100:8080"

# 2. IP:Port with Username and Password
Traffic4SEO.exe --proxy="myuser:[email protected]:8080"

# 3. HTTP Proxy with Authentication
Traffic4SEO.exe --proxy="http://myuser:[email protected]:8080"

# 4. SOCKS5 Proxy with Authentication
Traffic4SEO.exe --proxy="socks5://myuser:[email protected]:1080"

# 5. Legacy individual flags (Supported for backwards compatibility)
Traffic4SEO.exe --proxy-type=http --proxy-host=proxy.example.com --proxy-port=8080 --proxy-username=user --proxy-password=pass
Linux
# 1. IP and Port only
./Traffic4SEO.AppImage --proxy="192.168.1.100:8080"

# 2. Full HTTP Proxy URI with Authentication
./Traffic4SEO.AppImage --proxy="http://myuser:[email protected]:8080"

# 3. SOCKS5 Proxy URI
./Traffic4SEO.AppImage --proxy="socks5://myuser:[email protected]:1080"

Setting Up a Proxy via Desktop Shortcut

Creating a Desktop Shortcut allows you to launch the app with a pre-configured proxy with a single click, without having to open the Terminal or Command Prompt every time. This is especially useful when running multiple instances with different proxies.

1. On Windows

You can duplicate/edit an existing shortcut or create a new shortcut from scratch:

{info} Tip: Using Option 1 is recommended because the default shortcut already contains the exact path to your Traffic4SEO.exe file, eliminating the need to manually locate or type system paths.

Option 1: Duplicate & Edit an Existing Shortcut (Recommended)

  1. Right-click the existing Traffic4SEO shortcut on your Desktop → select Copy (or press Ctrl + C), then paste it (Ctrl + V) on the Desktop to create a duplicate.
  2. Rename the duplicate shortcut for clarity (e.g., Traffic4SEO - US Proxy).
  3. Right-click the renamed shortcut → select Properties.
  4. In the Shortcut tab, move your cursor to the end of the Target field.
  5. Add a space and append your --proxy="..." parameter at the very end (keep the existing .exe path intact):
     # Example Target after appending proxy:
     C:\Users\Admin\AppData\Local\Programs\Traffic4SEO\Traffic4SEO.exe --proxy="http://user:[email protected]:8080"
  6. Click Apply and OK.

Option 2: Create a New Shortcut from Scratch

  1. Right-click on your Desktop → select NewShortcut.
  2. In the Type the location of the item field, enter the path to Traffic4SEO.exe followed by the --proxy parameter:
     C:\Users\<Username>\AppData\Local\Programs\Traffic4SEO\Traffic4SEO.exe --proxy="http://user:[email protected]:8080"

    {info} Note: Replace <Username> with your actual Windows username (e.g., Admin). If the path contains spaces, wrap the .exe file path in double quotes "...".

  3. Click Next, enter a name for the shortcut (e.g., Traffic4SEO - US Proxy).
  4. Click Finish to complete.

2. On Linux (Ubuntu)

On Ubuntu / Linux Desktop (GNOME), you can create a .desktop file to launch the app with a proxy:

Step 1: Create a .desktop File

Open Terminal and create a new desktop entry file on your Desktop:

nano ~/Desktop/traffic4seo-us.desktop

Step 2: Enter Configuration Content

Paste the following configuration into the file (update the Exec path and --proxy parameter according to your setup):

[Desktop Entry]
Version=1.0
Type=Application
Name=Traffic4SEO (US Proxy)
Comment=Traffic4SEO App with US Proxy
Exec=/home/username/Apps/Traffic4SEO.AppImage --proxy="http://user:[email protected]:8080"
Icon=traffic4seo
Terminal=false
Categories=Network;Utility;

Step 3: Make Executable & Allow Launching

  1. Grant execution permission to the file:
     chmod +x ~/Desktop/traffic4seo-us.desktop
  2. Allow Launching:
    • On the Ubuntu Desktop UI, right-click the traffic4seo-us.desktop icon.
    • Select Allow Launching.
    • The application icon will update and is now ready to double-click to launch with the configured proxy.

Testing the Proxy

Checking IP within the App

After starting the app with a proxy, you can check the current IP:

  1. Launch the app with a proxy.
  2. Log in to your account.
  3. Click on your avatar/username in the sidebar (bottom left).
  4. The dropdown menu will display:
    • Country flag (e.g., 🇺🇸 for US).
    • Current IP address (e.g., 45.67.89.123).

{success} Proxy Working Correctly: If the IP and country flag match the proxy you are using, it's successfully configured!


Troubleshooting

Proxy Connection Failed

Reason: Proxy server down, incorrect host/port, or firewall block.

Solution:

  1. Check if the proxy is online.
  2. Verify details with your provider.
  3. Temporarily disable firewall to test.

Proxy Authentication Failed

Reason: Incorrect username/password, expired account, or IP whitelist issues.

Solution:

  1. Double-check credentials.
  2. Check account balance/expiry.
  3. Whitelist your IP (if required by the proxy).

Best Practices

1. Choose the Right Proxy

  • Beginners: Start with datacenter proxies (cheaper).
  • Pro Executors: Invest in residential proxies for higher quality and less blocking.

2. Optimize Proxy Usage

  • Sticky Session (10-30 mins): Recommended for Traffic4SEO workflows to avoid session breaks.
  • Rotating: For distributing traffic and avoiding rate limits.