Skip to content

[AGM-2402] Update AdGuard for Linux #673

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 27 commits into
base: master
Choose a base branch
from

Conversation

puglieri
Copy link
Contributor

No description provided.

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

@@ -5,6 +5,8 @@ sidebar_position: 2

## Install AdGuard for Linux

Before starting, you have to open the command line in your computer. On Linux, press `Ctrl+Alt+T`. On Mac, type `Terminal` in the search field.

To install AdGuard, enter:

Release
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

это команда для терминала?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

это горячие клавиши, переписала в кавычках

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

вопрос был про строку 12 со словом Release
а горячие клавиши и вводимое слово Terminal лучше выделить курсивом. см. редполитику о том, когда кавычки используем: https://www.notion.so/adguard/0df1a9bec9464fbf88bd813312ab0c26?pvs=4#25735cd772fd4083852762bc9d2ba57a

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

2 similar comments
Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

1 similar comment
Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

1 similar comment
Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

github-actions bot commented Apr 1, 2025

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

github-actions bot commented Apr 1, 2025

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

github-actions bot commented Apr 1, 2025

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

@puglieri puglieri requested a review from el-termikael April 1, 2025 14:15
@@ -5,6 +5,8 @@ sidebar_position: 2

## Install AdGuard for Linux

Before starting, you have to open the command line in your computer. On Linux, press `Ctrl+Alt+T`. On Mac, type `Terminal` in the search field.

To install AdGuard, enter:

Release
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

вопрос был про строку 12 со словом Release
а горячие клавиши и вводимое слово Terminal лучше выделить курсивом. см. редполитику о том, когда кавычки используем: https://www.notion.so/adguard/0df1a9bec9464fbf88bd813312ab0c26?pvs=4#25735cd772fd4083852762bc9d2ba57a

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

1 similar comment
Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

@puglieri puglieri requested a review from el-termikael April 21, 2025 12:41
Copy link

Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/

@ngorskikh ngorskikh self-requested a review April 24, 2025 11:54

To install AdGuard, enter:
To install AdGuard, choose the version that better suits you (release, nightly or beta) and enter the respective command.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To install AdGuard, choose the version that better suits you (release, nightly or beta) and enter the respective command.
To install AdGuard, choose the version that better suits you (release, beta, or nightly) and enter the respective command.

1. Run `adguard-cli config set listen_address <address>` where `<address>` is the address to listen on.
2. Edit the config file directly:
- To determine the location of the config file, run `adguard-cli config show | grep "Config location"`.
- Look for the key `listen_address` and set its value accordingly. To listen on all available network interfaces, set the listen address to `0.0.0.0` or `::`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

key listen_address —> listen_address key

If the listen address is set to anything other than `127.0.0.1`, then proxy client authentication is required. AdGuard CLI will not start unless proxy authentication is configured:

- When running `adguard-cli config set listen_address <address>` where `<address>` 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 key `listen_auth`. Set the sub-key `enabled` to `true`, and `username` and `password` to non-empty values.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

listen_auth key
enabled sub-key

2. Switch AdGuard VPN CLI to **SOCKS5 mode**, and configure AdGuard CLI with an outbound proxy pointing to the SOCKS5
interface of AdGuard VPN CLI. In this case, it's important to keep in mind that:
- For an app's traffic to go through the VPN tunnel it must either have its traffic
transparently proxied by AdGuard CLI (which is the case for all apps by default), or manually configured to use
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same as in another PR:
or manually configured to use AdGuard VPN CLI's SOCKS5 interface.
—>
or it must be manually configured to use the SOCKS5 interface of AdGuard VPN CLI.

AdGuard VPN CLI's SOCKS5 interface.
- In order to avoid a routing loop, the `skip_outbound_proxy` option must be enabled
for AdGuard VPN CLI in AdGuard CLI's apps configuration section. By default, `skip_outbound_proxy` is enabled for
all apps with `vpn` in their name, which includes AdGuard VPN CLI.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

which includes —> including

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants