From 5f426a0df7e2f68f16e2fd938831930c57c26fe2 Mon Sep 17 00:00:00 2001 From: Yuriy Selivanov Date: Wed, 17 Sep 2025 17:36:17 +0300 Subject: [PATCH 1/3] Add configure outbound proxy --- docs/adguard-for-linux/settings.md | 76 ++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) diff --git a/docs/adguard-for-linux/settings.md b/docs/adguard-for-linux/settings.md index 08ded4647a7..a37b8368f76 100644 --- a/docs/adguard-for-linux/settings.md +++ b/docs/adguard-for-linux/settings.md @@ -115,3 +115,79 @@ If the listen address is set to anything other than `127.0.0.1`, then proxy clie - When running `adguard-cli config set listen_address
` where `
` is not `127.0.0.1`, AdGuard CLI will prompt for a username and password if proxy authentication is not already configured. - When editing the config file directly, look for the `listen_auth`key. Set the `enabled` sub-key to `true`, and `username` and `password` to non-empty values. + +## Configure outbound proxy + +You can configure `outbound_proxy` if you want AdGuard CLI to work through another proxy server. + +There are two ways to configure it: + +### 1. Configure via URL (recommended) + +Instead of setting each option step by step, you can set all parameters in a single line using a URL: + +```sh +adguard-cli config set outbound_proxy https://user:pass@host:port +``` + +:::info + +Supported modes are HTTP, HTTPS, SOCKS4, SOCKS5. + +::: + +You can also quickly enable, disable `outbound_proxy`: + +```sh +adguard-cli config set outbound_proxy false +``` + +Or quickly clear the settings: + +```sh +adguard-cli config set outbound_proxy "" +``` + +### 2. Configure individual parameters + +The ability to adjust specific parameters is also available: + +```sh +adguard-cli config set outbound_proxy.enabled true +adguard-cli config set outbound_proxy.host localhost +adguard-cli config set outbound_proxy.port 3128 +adguard-cli config set outbound_proxy.username user +adguard-cli config set outbound_proxy.password pass +``` + +Disable certificate verification for HTTPS proxies: + +```sh +adguard-cli config set outbound_proxy.trust_any_certificate true +``` + +Enable SOCKS5 proxy for UDP traffic (note: +```sh +adguard-cli config set outbound_proxy.udp_through_socks5_enabled true +``` + +:::info NOTE + +If your SOCKS5 proxy does not support UDP, connections may fail. + +::: + + +### Checking the current configuration + +To view the current outbound_proxy configuration, enter: + +```sh +adguard-cli config show outbound_proxy +``` + +:::info Compatibility + +Configuring outbound_proxy via URL is available starting from version 1.1.26 nightly and stable release 1.1. + +::: \ No newline at end of file From 229e470af0d6893d857d054d01a959b826e47121 Mon Sep 17 00:00:00 2001 From: Yuriy Selivanov Date: Wed, 17 Sep 2025 19:31:30 +0300 Subject: [PATCH 2/3] fix compile --- docs/adguard-for-linux/settings.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/adguard-for-linux/settings.md b/docs/adguard-for-linux/settings.md index a37b8368f76..e4429fc43f6 100644 --- a/docs/adguard-for-linux/settings.md +++ b/docs/adguard-for-linux/settings.md @@ -166,7 +166,8 @@ Disable certificate verification for HTTPS proxies: adguard-cli config set outbound_proxy.trust_any_certificate true ``` -Enable SOCKS5 proxy for UDP traffic (note: +Enable SOCKS5 proxy for UDP traffic: + ```sh adguard-cli config set outbound_proxy.udp_through_socks5_enabled true ``` @@ -177,7 +178,6 @@ If your SOCKS5 proxy does not support UDP, connections may fail. ::: - ### Checking the current configuration To view the current outbound_proxy configuration, enter: @@ -190,4 +190,4 @@ adguard-cli config show outbound_proxy Configuring outbound_proxy via URL is available starting from version 1.1.26 nightly and stable release 1.1. -::: \ No newline at end of file +::: From 2843576340140a1ca69e7be7fca5b78e0eb465f4 Mon Sep 17 00:00:00 2001 From: Helen <58733007+el-termikael@users.noreply.github.com> Date: Tue, 30 Sep 2025 12:57:56 +0300 Subject: [PATCH 3/3] Update docs/adguard-for-linux/settings.md Co-authored-by: Alex --- docs/adguard-for-linux/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/adguard-for-linux/settings.md b/docs/adguard-for-linux/settings.md index e4429fc43f6..f29ddc493db 100644 --- a/docs/adguard-for-linux/settings.md +++ b/docs/adguard-for-linux/settings.md @@ -136,7 +136,7 @@ Supported modes are HTTP, HTTPS, SOCKS4, SOCKS5. ::: -You can also quickly enable, disable `outbound_proxy`: +You can also quickly enable or disable `outbound_proxy`: ```sh adguard-cli config set outbound_proxy false