Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.
Yes—when Chromeless starts a local Chrome process and passes the argument through. Chromium itself supports --proxy-server, but Chromeless’s public package description does not promise that every version or connection mode forwards arbitrary Chrome flags. A flag given to your local browser cannot reconfigure a separately managed remote browser. Treat the result as conditional: identify where Chrome runs, confirm that your Chromeless version exposes launch arguments, then verify the browser’s actual egress IP.
What the flag actually controls
--proxy-server is a Chromium command-line option. It configures the Chrome process that receives it; it is not a setting stored in a Chromeless script. If Chromeless launches Chrome on your machine, a forwarded argument can affect that process. If Chromeless connects to a built-in or hosted remote browser, the argument in your local code does not automatically alter the remote process.
Chromeless documentation distinguishes local development, where it can control a local Chrome browser, from a remote proxy model. It also describes starting Chrome yourself and setting launchChrome: false in the Chromeless constructor. The package description does not explicitly document a universal --proxy-server option or guarantee forwarding in both modes, so check the exact package version and connection path before relying on it in production.
Chromium proxy syntax you can use
Chromium’s proxy guide accepts URI-formatted proxy identifiers. The following forms are the important ones:
#1 Best Overall
- CPU:Intel Core i3-N305 Processor,8 cores , 8 threads,6M Cache, up to 3.80 GHz,15W
- Configuration:8G DDR4 Ram 128G M.2 SSD NO WIFI
- 196 x 122 x 47mm ,Low Power,Aluminum alloy case ,24/7/365 ,Perfect fit for a LAN or WAN router, firewall, proxy, WiFi access point, VPN appliance, DHCP Server, DNS Server, etc.
- 2 x Marvell AQC113 10 Gigabit LAN,4 x Intel I226-V 2.5 Gigabit LAN,3 x USB 3.0, 1 x USB 2.0,1 x Type C,1 x Nano SIM Slot,1 x HD Video, 1 x Display Port
- Supports Windows and Linux kernels, such as Windows, OpenWrt, Linux, iKuai, etc, Does not support Unix kernels, such as pfsense, OPNsense, etc.Pre-install windows 10(Unactivated)Please reinstall OS by yourself.
| Goal | Example | Meaning |
|---|---|---|
| One HTTP proxy | --proxy-server="http://proxy.example:8080" |
Routes supported browser traffic through an HTTP proxy. |
| HTTPS proxy endpoint | --proxy-server="https://proxy.example:443" |
Uses an HTTPS proxy URI. |
| SOCKS5 | --proxy-server="socks5://proxy.example:1080" |
Uses a SOCKSv5 proxy. |
| Direct connection | --proxy-server="direct://" |
Explicitly selects a direct route. |
| Proxy with direct fallback | --proxy-server="http://proxy.example:8080,direct://" |
Tries the proxy, then permits a direct connection. |
| Scheme mapping | --proxy-server="http=https://foo:443;socks=socks5://mysocks:1080" |
Maps HTTP traffic to one endpoint and SOCKS traffic to another. |
You can add a bypass list separately, for example --proxy-bypass-list="<local>;localhost;127.0.0.1". Keep the proxy value and bypass rules as separate arguments so quoting remains predictable in shells and process managers.
Local Chromeless: the dependable way to test the flag
The least ambiguous arrangement is to launch Chrome yourself, then let Chromeless attach without launching a second browser. This proves which process received the argument.
-
Choose a dedicated profile
Close any existing Chrome instance using the same profile, or supply a temporary user-data directory. A running Chrome process may ignore new command-line switches because it reuses the existing process.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy. -
Launch Chrome with the proxy argument
On Linux, a typical command is:
google-chrome --user-data-dir=/tmp/chromeless-proxy-profile --proxy-server="http://proxy.example:8080" --remote-debugging-port=9222Replace the executable name with your platform’s Chrome or Chromium binary. On macOS, invoke the application binary inside the Chrome bundle; on Windows, run
chrome.exefrom its installation path. Do not put credentials in the proxy URI. -
Connect Chromeless without launching another browser
Use the constructor option documented by the package for an externally started browser:
const { Chromeless } = require('chromeless'); (async () => { const chromeless = new Chromeless({ launchChrome: false }); try { const result = await chromeless .goto('https://example.com') .evaluate(() => ({ href: location.href, userAgent: navigator.userAgent })); console.log(result); } finally { await chromeless.end(); } })();The exact connection options can vary by Chromeless release. If this constructor cannot discover the debugging endpoint, use that release’s documented remote-debugging connection setting while keeping
launchChrome: false. The key diagnostic is that only the Chrome process you started carries--proxy-server. -
Check the browser’s observed address
Navigate to an IP-echo service that you operate or trust and compare the result with and without the proxy. Checking from the browser page is more meaningful than checking the shell’s IP: the browser is the process whose traffic you are testing.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.Rank #2
Sale
TP-Link ER605, Wired Gigabit VPN Router- 【Five Gigabit Ports】1 Gigabit WAN Port plus 2 Gigabit WAN/LAN Ports plus 2 Gigabit LAN Port. Up to 3 WAN ports optimize bandwidth usage through one device.
- 【One USB WAN Port】Mobile broadband via 4G/3G modem is supported for WAN backup by connecting to the USB port. For complete list of compatible 4G/3G modems, please visit TP-Link website.
- 【Abundant Security Features】Advanced firewall policies, DoS defense, IP/MAC/URL filtering, speed test and more security functions protect your network and data.
- 【Highly Secure VPN】Supports up to 20× LAN-to-LAN IPsec, 16× OpenVPN, 16× L2TP, and 16× PPTP VPN connections.
- Security - SPI Firewall, VPN Pass through, FTP/H.323/PPTP/SIP/IPsec ALG, DoS Defence, Ping of Death and Local Management. Standards and Protocols IEEE 802.3, 802.3u, 802.3ab, IEEE 802.3x, IEEE 802.1q
Chromeless-managed local launch: where forwarding can fail
If Chromeless launches Chrome for you, the flag must be inserted into the package’s local launch-argument mechanism. The public description confirms local Chrome control but does not establish a stable option name for arbitrary arguments. Do not assume that a property copied from another wrapper will work.
- Confirm the installed Chromeless version and read its launch-options documentation.
- Log the final Chrome command line, or inspect the Chrome process command line supplied by your operating system.
- Use a fresh profile so an already-running Chrome process cannot absorb the request.
- Test with a deliberately invalid proxy endpoint; a browser that still loads normally may not have received the flag (although some applications recover through fallback rules).
If your version has no documented launch-argument hook, start Chrome yourself as shown above and connect with launchChrome: false. That approach avoids guessing an undocumented Chromeless option.
Remote Chromeless sessions are a different case
A remote session has at least two processes: your client and the browser service. A local --proxy-server argument affects neither the remote Chrome process nor the service’s outbound network. Use the remote service’s documented proxy configuration instead. If the service does not expose one, the local flag cannot provide it.
This distinction also explains why a flag may appear to be ignored: your script can be correct, while the browser doing the navigation is elsewhere. Ask these questions before changing syntax:
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchPC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11- Where is Chrome running—your workstation, a container, or a hosted service?
- Who creates the Chrome process?
- Does that component document launch-argument forwarding?
- Does the remote service provide a separate proxy field or URL parameter?
HTTP, HTTPS and SOCKS5 details
HTTP and HTTPS proxies
Use the scheme that describes the proxy endpoint, not necessarily the destination website. An HTTP proxy can carry HTTPS destinations through CONNECT. An HTTPS proxy protects the connection to the proxy itself. Follow the endpoint provider’s documented scheme.
SOCKS4 and SOCKS5
Chromium supports SOCKSv4 and SOCKSv5 identifiers. Chrome does not support username/password authentication for SOCKSv5 through the flag. If your endpoint requires credentials, use an authentication mechanism supported by the proxy and browser environment, or place an authenticated gateway in front of Chrome.
Credentials
Chrome does not use credentials embedded in proxy settings. A value such as http://user:[email protected]:8080 is not a reliable authentication method. Proxy authentication proceeds through the browser’s ordinary authentication flow, which may require handling an authentication challenge or configuring the surrounding network.
Rank #3
- 𝐏𝐞𝐫𝐟𝐨𝐫𝐦𝐚𝐧𝐜𝐞 𝐰𝐨𝐫𝐤𝐡𝐨𝐫𝐬𝐞 𝐭𝐡𝐚𝐭'𝐬 𝐫𝐞𝐚𝐝𝐲 𝐟𝐨𝐫 𝐭𝐨𝐦𝐨𝐫𝐫𝐨𝐰 – Delivering high-capacity tri-band lanes, the Wi-Fi 7 Archer BE770 combines 10 internal antennas, an open 6 GHz band, and a future-ready 10G WAN/LAN port for busy, connected homes.
- 𝐁𝐄𝟏𝟖𝟎𝟎𝟎 𝐭𝐫𝐢-𝐛𝐚𝐧𝐝 𝟏𝟎-𝐬𝐭𝐫𝐞𝐚𝐦 𝐖𝐢-𝐅𝐢 𝟕 𝐫𝐨𝐮𝐭𝐞𝐫 - Delivers up to 11528 Mbps (6 GHz), 5764 Mbps (5 GHz), and 688 Mbps (2.4 GHz) speeds for 4K/8K streaming, AR/VR gaming & more.◇**△ Performance varies by conditions, distance, & obstacles such as walls.
- 𝟏𝟎 𝐆𝐛𝐩𝐬 𝐬𝐭𝐚𝐲𝐬 𝐚𝐡𝐞𝐚𝐝 𝐚𝐬 𝐲𝐨𝐮𝐫 𝐢𝐧𝐭𝐞𝐫𝐧𝐞𝐭 𝐠𝐫𝐨𝐰𝐬 - Features a 10 Gbps WAN/LAN port to maximize multi-gig internet plans. An additional 10 Gbps WAN/LAN port and four 1 Gbps LAN ports provide fast connections to PCs, consoles, NAS, and switches.§
- 𝐂𝐨𝐯𝐞𝐫𝐚𝐠𝐞 𝐟𝐨𝐫 𝐞𝐯𝐞𝐫𝐲 𝐜𝐨𝐫𝐧𝐞𝐫 - Covers up to 3,600 sq. ft. for up to 150 devices at a time. 10 internal antennas and beamforming technology focus Wi-Fi signals toward hard-to-reach areas. Seamlessly connect phones, TVs, and gaming consoles.△
- 𝐒𝐢𝐦𝐩𝐥𝐞 𝐬𝐞𝐭𝐮𝐩 & 𝐞𝐚𝐬𝐲 𝐜𝐨𝐧𝐭𝐫𝐨𝐥 - Quickly set up and manage your Archer BE770 with the free Tether App. Keep your WiFi performing at its best by keeping the firmware updated through the App. All Wi-Fi routers require a separate modem.
Bypass rules and fallback behavior
A comma-separated fallback such as proxy,direct:// can make a failed proxy appear successful because Chrome eventually connects directly. Omit the direct fallback while diagnosing whether traffic is truly proxied. Add it only when direct recovery is an intentional policy.
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Use --proxy-bypass-list for hosts that must remain direct. Typical entries include local names, loopback addresses and internal domains, but the correct list depends on your network. A bypass rule can also make an IP test misleading if the test hostname matches the bypass pattern.
How to verify routing instead of trusting the command line
- Record the public IP returned by a browser page with no proxy.
- Restart the dedicated Chrome profile with the proxy argument.
- Repeat the check in that browser and compare the address, ASN or other values supplied by your diagnostic service.
- Test a hostname that is not in your bypass list.
- For difficult cases, capture a Chrome net-export log and inspect proxy resolution, connection and authentication events.
An IP change confirms that the browser used a different egress path, but it does not prove every request uses it. Test HTTP and HTTPS destinations separately, and test WebSockets or other protocols your application needs.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Troubleshooting common failures
“The flag is ignored”
Most often, Chrome was already running, Chromeless launched a different process, or the browser is remote. Stop the existing process, use a temporary profile, inspect the process command line and confirm the location of Chrome.
Proxy connection errors
Check DNS resolution from the machine running Chrome, the endpoint port, firewall rules and whether the URI scheme matches the provider. Remove authentication while testing basic reachability.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Scan for outdated or missing drivers - takes under a minute3Repair Windows errors before they cause bigger problemsAuthentication loops or 407 responses
Do not put credentials in the flag. Implement the browser’s supported authentication flow or use an intermediary that supplies credentials.
SOCKS5 works without credentials but fails with them
This is an expected limitation of Chrome’s SOCKSv5 support. Choose an authenticated design that does not depend on username/password fields in the Chrome flag.
Rank #4
- Secure Remote Work for Two : Includes two travel routers, so a colleague or family member can also connect remotely.
- Work from Anywhere Securely : Connect to your home network with a VPN travel router designed for remote professionals.
- An active KeepYourHomeIP : subscription is required for the VPN setup to work. One month of free subscription is included with the VPN package.
- Seamless Remote Work : Connect multiple devices simultaneously, including laptops, tablets, and phones.
- Bypass Geo-Restrictions : Both users can access home services, streaming, and work apps securely from anywhere.
Some URLs use the proxy and others do not
Inspect bypass rules, fallback directives and system-level proxy policies. A direct fallback intentionally permits unproxied access after proxy failure.
Local testing passes but production fails
Production may use a remote browser, a container with a different Chrome binary, or a service that strips unknown arguments. Reproduce the process topology, not just the JavaScript code, and configure the proxy at the component that owns Chrome.
Performance, reliability and security considerations
Every proxy adds a network hop. Expect latency to depend on geographic distance, connection reuse, DNS behavior and endpoint load. A direct fallback improves availability but weakens the guarantee that traffic is proxied. Keep proxy settings out of source control, restrict access to the debugging port, and use a dedicated profile for automated sessions.
For repeatable jobs, pin the Chrome and Chromeless versions, log the selected route and proxy errors, and fail closed when policy requires that no direct connection is allowed. A successful page load alone is not evidence of compliance; record the observed egress address and relevant net-export events.
Or skip the browser setup
If your goal is a clean screenshot rather than controlling a Chromeless browser, ScreenshotNeo provides a one-request website screenshot API and MCP server. It accepts consent banners before capture and removes more than 60 known consent platforms, newsletter popups and chat widgets; only clean shots are billed, while bot checks, blank pages, failed loads and cache hits are not billed.
cURL:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpPython:
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)Node.js:
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);See the ScreenshotNeo documentation for options such as full-page capture, device presets, custom headers and cookies, waits, blocking rules, PDFs, bulk capture and signed links. Its MCP server includes take_screenshot, get_page_info and capture_pdf for AI clients. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Create a free ScreenshotNeo account.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Repair Windows errors before they cause bigger problemsFix Now →Frequently Asked Questions
Can I put a proxy username and password directly in `–proxy-server`?
No. Chrome does not use credentials embedded in proxy settings; authentication must use the browser’s normal authentication flow or a separately configured gateway.
Does a direct fallback prove the proxy is healthy?
No. A `direct://` fallback can hide proxy failures by allowing an unproxied connection. Remove it while diagnosing route selection.
What should I inspect when a remote Chromeless browser ignores my flag?
Inspect the remote service’s own proxy configuration and launch-argument documentation. A flag on the client machine cannot change a browser process running elsewhere.
Can net-export logs replace an egress-IP check?
They complement it. Net-export reveals proxy resolution and connection events, while an egress-IP check confirms the address visible to the destination.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
