Try agent mode in VS Code!
Dismiss this update
Visual Studio Code is built on top of Electron and benefits from all the networking stack capabilities of Chromium. This also means that VS Code users get much of the networking support available in Google Chrome.
A handful of features within VS Code require network communication to work, such as the auto-update mechanism, querying and installing extensions, and telemetry. For these features to work properly in a proxy environment, you must have the product correctly configured.
If you are behind a firewall that needs to allow specific domains used by VS Code, here's the list of hostnames you should allow communication to go through:
update.code.visualstudio.com
- Visual Studio Code download and update servercode.visualstudio.com
- Visual Studio Code documentationgo.microsoft.com
- Microsoft link forwarding servicemarketplace.visualstudio.com
- Visual Studio Marketplace*.gallery.vsassets.io
- Visual Studio Marketplace*.gallerycdn.vsassets.io
- Visual Studio Marketplacerink.hockeyapp.net
- Crash reporting servicebingsettingssearch.trafficmanager.net
- In-product settings searchvscode.search.windows.net
- In-product settings searchraw.githubusercontent.com
- GitHub repository raw file accessvsmarketplacebadges.dev
- Visual Studio Marketplace badge service*.vscode-cdn.net
- Visual Studio Code CDNvscode.download.prss.microsoft.com
- Visual Studio Code download CDNdownload.visualstudio.microsoft.com
- Visual Studio download server, provides dependencies for some VS Code extensions (C++, C#)vscode-sync.trafficmanager.net
- Visual Studio Code Settings Sync servicevscode-sync-insiders.trafficmanager.net
- Visual Studio Code Settings Sync service (Insiders)vscode.dev
- Used when logging in with GitHub or Microsoft for an extension or Settings Sync*.vscode-unpkg.net
- Used when loading web extensionsdefault.exp-tas.com
- Visual Studio Code Experiment Service, used to provide experimental user experiencesVS Code has exactly the same proxy server support as Google Chromium. Here's a snippet from Chromium's documentation:
"The Chromium network stack uses the system network settings so that users and administrators can control the network settings of all applications easily. The network settings include:
- proxy settings
- SSL/TLS settings
- certificate revocation check settings
- certificate and private key stores"
This means that your proxy settings should be picked up automatically.
Otherwise, you can use the following command-line arguments to control your proxy settings:
# Disable proxy
--no-proxy-server
# Manual proxy address
--proxy-server=<scheme>=<uri>[:<port>][;...] | <uri>[:<port>] | "direct://"
# Manual PAC address
--proxy-pac-url=<pac-file-url>
# Disable proxy per host
--proxy-bypass-list=(<trailing_domain>|<ip-address>)[:<port>][;...]
To learn more about these command-line arguments, see Chromium Network Settings.
Authenticated proxies should work seamlessly within VS Code with the addition of PR #22369.
The authentication methods supported are:
When using VS Code behind an authenticated HTTP proxy, the following authentication popup should appear:
Note that SOCKS5 proxy authentication support isn't implemented yet; you can follow the issue in Chromium's issue tracker.
See Chromium HTTP authentication to read more about HTTP proxy authentication within VS Code.
Often HTTPS proxies rewrite SSL certificates of the incoming requests. Chromium was designed to reject responses which are signed by certificates which it doesn't trust. If you hit any SSL trust issues, there are a few options available for you:
localhost
, you can always try the --allow-insecure-localhost command-line flag.Extensions don't benefit yet from the same proxy support that VS Code supports. You can follow this issue's development in GitHub.
Similarly to extensions, a few other VS Code features don't yet fully support proxy networking, namely the CLI interface. The CLI interface is what you get when running code --install-extension vscodevim.vim
from a command prompt or terminal. You can follow this issue's development in GitHub.
Due to both of these constraints, the http.proxy, http.proxyStrictSSL and http.proxyAuthorization variables are still part of VS Code's settings, yet they are only respected in these two scenarios.
Here are some helpful links that might help you troubleshoot networking issues in VS Code: