Proxy Management

Page mapping: “Proxy Management” in the left menu (ProxyManagement) and the add/edit proxy dialog. This module centralizes all proxies used by your company or team.

📌 What is this page for?

• Record all company/team proxies in one place.
• Provide a shared “address book” of proxies so each member doesn’t need their own spreadsheets.
• Quickly test whether a proxy is reachable and actually changes IP.
• Filter by type, export lists, and delete (deleted records go to the Recycle Bin for later handling).

You can think of Proxy Management as: an address book of proxy servers + a proxy health checker.

---

🚪 Entry & layout

• Entry: “Proxy Management” in the left navigation.
• Top:
  • Left: proxy type filter.
  • Right: Add and Export buttons.
• Center:
  • Table listing proxies (each row is one proxy config).
• Bottom:
  • Pagination.

Each proxy row usually includes: proxy type, IP test channel, host, port, username, note, creator/time, updater/time, etc.

---

⚡ Quickstart: Add a proxy

Use the “Add” button in the toolbar to open the add/edit dialog.

Step 1｜Open the dialog
On “Proxy Management”, click “Add” in the top-right to open the “Add proxy” dialog.

Step 2｜Choose proxy type
In the “Proxy type” dropdown, select the type provided by your infra team: HTTP / HTTPS / SOCKS5 / SSH, etc.

• If unsure, ask ops or whoever provides the proxy to you.

Step 3｜Choose IP test channel
In “IP test channel”, choose a service to verify IP later when you click “Test connection”.

• This only chooses which site is used to detect your exit IP; it does not change the proxy itself.

Step 4｜Fill connection info

• Proxy host:
  • Only host or domain, such as proxy.xxx.com or 1.2.3.4.
  • Prefixes like http://, https://, socks5:// are inferred from proxy type.
• Port:
  • Proxy port, such as 8080, 1080, etc.
• Proxy username / password:
  • If the proxy requires auth, fill the credentials from ops.
  • For open proxies, leave empty.
• Refresh URL (optional):
  • If your provider supports “refresh IP” or “reset line”, put the corresponding URL here for later automation.
• Note:
  • Recommended pattern: “Country/region + provider + purpose”, for example:
  • US-A line / SomeProvider / Ads.

Step 5｜Test connection
Click “Test connection” at the bottom:

• The system validates required fields.
• Then it uses the chosen IP test channel to make a real request.
• It checks connectivity, response correctness, and whether an IP is returned.
  If test fails, the UI shows an error. Check:
• Whether host is correct.
• Whether port is correct.
• Whether username/password match.
• Whether local network/firewall allows reaching the proxy.

Step 6｜Save

• After a successful test, click “OK” to save.
• The new proxy appears in the list so you can select it for browser environments.

---

🌐 IP test channels

In the add/edit dialog you’ll see an “IP test channel” dropdown. Options come from a shared config (ip.test.channels.ts) and mean “which site to use for IP detection”.

Common examples:

Channel	Description
ip.sb	Free IP geo lookup; quick view of current IP and region.
freeipapi	Free IP geolocation service with country/city info.
ip2location	IP geolocation service focused on location data.
ipapi.co	IP API returning IP location and network info.
ipinfo.io	IP information service including region and organization.

There is no single “best” choice; guidelines:

• To simply check whether IP changed: pick any common channel.
• For frequent risk-control checks: stick to one or two channels you know well to avoid confusion from differences in results.

---

📋 Main list: Everyday management

On the main “Proxy Management” page you can manage existing proxies.

• Filter

  • Use the “Proxy type” filter at the top to switch between HTTP / HTTPS / SOCKS5 / SSH, etc.
  • Clear the filter to see all proxies.

• Fields

  • Proxy type: highlighted tags like HTTP / HTTPS / SOCKS5.
  • IP test channel: shows the channel name saved earlier.
  • Host / Port: proxy server address and port.
  • Proxy username: if any.
  • Proxy password: masked as ****** to avoid leakage.
  • Refresh URL / Note: helper notes to coordinate between ops and operators.
  • Created by / Created at: who created this proxy.
  • Updated by / Updated at: who edited it last and when.

• Edit

  • Click “Edit” in the actions column to open the same dialog with data pre-filled.
  • You can test connection again before saving changes.

• Delete

  • Click “Delete”, then confirm in the dialog.
  • The proxy is removed from the list and moved into the Recycle Bin.
  • To fully remove it, perform a permanent delete in the Recycle Bin.

• Export

  • Click “Export” in the toolbar.
  • The export respects current filters and is useful for auditing, archiving, or reconciliation.

---

💡 Usage tips

• Don’t guess proxy details

  • Let ops or the person integrating with the provider give you “type + host + port + username/password”; you just enter them.

• Use a naming convention

  • In notes, use a consistent pattern such as Country-City-Provider-Purpose.
  • Makes later filtering and export analysis easier.

• Align proxy with business region

  • If the fingerprint profile is “US”, use a US proxy as far as possible.
  • Mismatched region/language/time zone vs proxy increases risk-control flags.

• Always test connection

  • For new or updated proxies, run “Test connection” first.
  • Avoid discovering a broken proxy in production.

• Review and clean regularly

  • Export and archive long-unused or invalid proxies, then delete them.
  • Deleted items go to the Recycle Bin so you can still see who deleted them and when.

---

❓ FAQ

• Q: I can’t tell HTTP / HTTPS / SOCKS5—what do I do?
  A: Ask whoever provides the proxy to give you “type + host + port + username/password” and copy those values.

• Q: Test connection fails but colleagues say the proxy is fine?
  A: First double-check everything (especially port and password), then confirm whether your local network or firewall is blocking it. Involve ops if needed.

• Q: Why do I need an “IP test channel”?
  A: It’s just a tool to show “which IP and region you appear to come from”. Different channels are different lookup sites.

• Q: Can I restore a deleted proxy?
  A: Yes. You can find deleted records in the Recycle Bin and decide whether to restore or delete permanently.

---

After centralizing proxy management, consider using it together with:

• Parameter Guide: keep fingerprint parameters aligned with proxy region.
• Create Your First Browser: choose proper proxies when creating environments.