Skip to content
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

Update translations #243

Merged
merged 1 commit into from
Jul 31, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ sidebar_position: 11

:::info

This article covers AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://adguard.com/download.html?auto=true)
This article covers AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://adguard.com/download.html?auto=true).

:::

Expand Down Expand Up @@ -48,7 +48,7 @@ This method will only work on **rooted** devices.
- Tap the **Build number** line 7 times. After that, you will receive a notification that **You are now a developer** (If necessary, enter an unlock code for the device);
- Open **System Settings** → **Developer Options** → Scroll down and enable **USB debugging** → Confirm debugging is enabled in the window **Allow USB debugging** after reading the warning carefully.
3. Install the [Firefox](https://www.mozilla.org/en-US/firefox/releases/) browser (release version);
4. Open the **AdGuard settings** → **Network** → **HTTPS Filtering** → Install the certificate in **Firefox** → **INSTALL FOR OLD VERSIONS**;
4. Open the **AdGuard settings** (gear icon in the bottom right corner) → **Filtering** → **Network** → **HTTPS filtering** → **Security certificate** → **Instructions for Firefox** → **Install for old versions**;
5. Open the folder `data/data/org.mozilla.firefox/files/mozilla` using `adb shell su` and `cd data/data/...`, then browse to the folder named `xxxxxxx.default` and memorize its name;
6. In the specified folder we are interested in two files:
- `cert9.db`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,112 +9,118 @@ This article covers AdGuard for Android, a multifunctional ad blocker that prote

:::

This article explains how to set up some of the most popular proxies to work with AdGuard.
AdGuard allows you to route your device's traffic through a proxy server. To access proxy settings, open **Settings** and then proceed to **Filtering** → **Network** → **Proxy**.

## Proxy configuration examples

In this article we give examples of how to set up some of the most popular proxies to work with AdGuard.

### How to use AdGuard with Tor

1. Open AdGuard and go to **Settings** → **Network** → **Proxy settings**. Download "Orbot: Proxy with Tor" by tapping **Integrate with Tor** or directly from [Google Play](https://play.google.com/store/apps/details?id=org.torproject.android&noprocess).
1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy**. Download "Orbot: Proxy with Tor" directly from [Google Play](https://play.google.com/store/apps/details?id=org.torproject.android&noprocess) or by tapping **Integrate with Tor** and then **Install**.

2. Open Orbot and press the **Start** button on the application's main screen.

2. Go back to the **Proxy Settings** screen of AdGuard.
3. Go back to the **Proxy** screen of AdGuard.

3. Tap the **Integrate with Tor** button.
4. Tap the **Integrate with Tor** button.

4. All the required fields will be pre-filled:
5. All the required fields will be pre-filled:

| Field | Value |
| ---------- | -------------------- |
| Proxy type | *SOCKS4* or *SOCKS5* |
| Proxy host | *127.0.0.1* |
| Proxy port | *9050* |
| Field | Value |
| ---------- | -------------------- |
| Proxy type | *SOCKS4* or *SOCKS5* |
| Proxy host | *127.0.0.1* |
| Proxy port | *9050* |

Or you can tap **Add proxy**, enter these values manually, and set Orbot as a default proxy.
Or you can tap **Proxy server** → **Add proxy server**, enter these values manually, and set Orbot as a default proxy.

5. Enable AdGuard protection.
6. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy.

Now AdGuard will forward all traffic through Orbot. If you disable Orbot, Internet connection will be unavailable until you disable outbound proxy settings in AdGuard.

### How to use AdGuard with PIA (Private Internet Access)

*Here we presume that you are already a PIA VPN client and have it installed on your device.*

1. Open AdGuard and go to **Settings** → **Network** → **Proxy settings**.
1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**.

2. Tap the **Add proxy server** button and enter the following data:

| Field | Value |
| ---------- | ------------------------------------ |
| Proxy type | *SOCKS5* |
| Proxy host | *proxy-nl.privateinternetaccess.com* |
| Proxy port | *1080* |
| Field | Value |
| ---------- | ------------------------------------ |
| Proxy type | *SOCKS5* |
| Proxy host | *proxy-nl.privateinternetaccess.com* |
| Proxy port | *1080* |

3. You also need to fill out the **Username/Password** fields. To do so, log in to the [Client Control Panel](https://www.privateinternetaccess.com/pages/client-sign-in) on the PIA website. Click the **Generate Password** button under the **Generate PPTP/L2TP/SOCKS Password** section. A username starting with "x" and a random password will be shown. Use them to fill out the **Username** and **Password** fields in AdGuard.
3. You also need to fill out the **Username/Password** fields. To do so, log in to the [Client Control Panel](https://www.privateinternetaccess.com/pages/client-sign-in) on the PIA website. Click the **Generate Password** button under the **Generate PPTP/L2TP/SOCKS Password** section. A username starting with "x" and a random password will be shown. Use them to fill out the **Proxy username** and **Proxy password** fields in AdGuard.

4. Set this proxy as a default one by toggling the switch, then click **Save**.
4. Tap **Save and select**.

5. Enable AdGuard protection.
5. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy.

### How to use AdGuard with TorGuard

*Here we presume that you are already a TorGuard client and have it installed on your device.*

1. Open AdGuard and go to **Settings** → **Network** → **Proxy settings**.
1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**.

2. Tap the **Add proxy server** button and enter the following data:

| Field | Value |
| ---------- | ------------------------------------------- |
| Proxy type | *SOCKS5* |
| Proxy host | *proxy.torguard.org* or *proxy.torguard.io* |
| Proxy port | *1080* or *1085* or *1090* |
| Field | Value |
| ---------- | ------------------------------------------- |
| Proxy type | *SOCKS5* |
| Proxy host | *proxy.torguard.org* or *proxy.torguard.io* |
| Proxy port | *1080* or *1085* or *1090* |

3. For **Username** and **Password** fields, enter your proxy username and proxy password you have chosen at TorGuard signup.

4. Set this proxy as a default one by toggling the switch, then click **Save**.
4. Tap **Save and select**.

5. Enable AdGuard protection.
5. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy.

### How to use AdGuard with NordVPN

1. Open AdGuard and go to **Settings** → **Network** → **Proxy settings**.
1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**.

2. Tap the **Add proxy server** button and enter the following data:

| Field | Value |
| ---------- | --------------------------------------------------------------------------------- |
| Proxy type | *SOCKS5* |
| Proxy host | *any server save for "Obfuscated" from [this list](https://nordvpn.com/servers/)* |
| Proxy port | *1080* |
| Field | Value |
| ---------- | ------------------------------------------------------------------------------ |
| Proxy type | *SOCKS5* |
| Proxy host | *any server from [this list](https://support.nordvpn.com/Connectivity/Proxy/)* |
| Proxy port | *1080* |

3. For **Username** and **Password** fields, enter your NordVPN Username and Password.

4. Set this proxy as a default one by toggling the switch, then click **Save**.
4. Tap **Save and select**.

5. Enable AdGuard protection.
5. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy.

### How to use AdGuard with Shadowsocks

*Here we presume that you have already configured a Shadowsocks server and a client on your device.*

:::note

You should remove Shadowsocks application from filtering before setting up the process (AdGuard → Apps managementShadowsocks → Disable AdGuard protection) to avoid infinite loops and drops.
You should remove Shadowsocks application from filtering before setting up the process (**Settings****Filtering** → **Apps** → **App management** → **Shadowsocks****Route traffic through AdGuard**) to avoid infinite loops and drops.

:::

1. Open AdGuard and go to **Settings** → **Network** → **Proxy settings**.
1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**.

2. Tap the **Add proxy server** and fill the fields:

| Field | Value |
| ---------- | ----------- |
| Proxy type | *SOCKS5* |
| Proxy host | *127.0.0.1* |
| Proxy port | *1080* |
| Field | Value |
| ---------- | ----------- |
| Proxy type | *SOCKS5* |
| Proxy host | *127.0.0.1* |
| Proxy port | *1080* |

3. Tap **Save and select**.

3. Tap **Save and select**
4. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy.

### Limitations
## Limitations

There is a factor that can prevent certain traffic from being routed through the outgoing proxy. AdGuard will only re-route traffic that goes through it. Basically, it means apps that have **Ad blocking** flag enabled in the **Apps Management** tab.
There is a factor that can prevent certain traffic from being routed through the outgoing proxy. AdGuard will only re-route traffic that goes through it. Basically, it means apps that have **Ad blocking** flag enabled in the **Apps Management** tab.
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,22 @@ title: Certificate installation in a Secure folder
sidebar_position: 13
---

If you are using [the *Secure folder* on your Android](https://www.samsung.com/uk/support/mobile-devices/what-is-the-secure-folder-and-how-do-i-use-it/)(this applies mainly to Samsung devices), you may face some difficulties when installing the HTTPS certificate. The thing is that the *Secure folder* has its own space where the certificates are stored. However, if you do everything according to the instructions [described here](../../overview#https-filtering), the certificate will be installed into the main memory and will play no role for your ad blocker in the *Secure folder*. To solve this problem and install the certificate for your AdGuard for Android into the *Secure folder's* storage, please follow these instructions:
:::info

1. After installing the app and connecting the VPN, tap *Turn on* next to the *HTTPS filtering is off* message.
2. Tap *Next* → *Next* → *Save it now* → *Allow*.
3. Save the certificate (at this stage, you can rename it to make it easier to find).
4. After the *How to install a certificate?* popup appears, DO NOT tap *Open Settings*.
5. Minimize the app and go to the secure folder.
6. Tap the three-dot menu and go to additional security settings.
7. Tap *Install from memory* → *CA certificate* → *Install anyway* → Enter a graphic key/password/fingerprint → Find and select the saved certificate.
8. Return to the AdGuard app and close the "How to install a certificate?" popup by tapping the cross button.
9. Done! The certificate has been installed.
This article covers AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://adguard.com/download.html?auto=true)

:::

If you install AdGuard to [the *Secure folder* on your Android](https://www.samsung.com/uk/support/mobile-devices/what-is-the-secure-folder-and-how-do-i-use-it/) (this applies mainly to Samsung devices), you may face some difficulties when installing the HTTPS certificate. The thing is, the *Secure folder* has its own space where the certificates are stored. However, if you do everything according to the regular certificate installation instructions ([described here](../../overview#https-filtering)), the certificate will be installed into the main memory and will play no role for your ad blocker in the *Secure folder*. To solve this problem and install the certificate for your AdGuard for Android into the *Secure folder's* storage, please follow these instructions instead:

1. After installing the app and connecting the local VPN, tap **ENABLE** next to the *HTTPS filtering is off* message.
1. Tap **Next** → **Next** → **Save it now** → **Save certificate**.
1. Save the certificate (at this stage, you can rename it to make it easier to locate it later, which you will need to do).
1. After the *Installation instructions* popup appears, **DO NOT** tap **Open Settings**.
1. Minimize the app and go to the *Secure folder*.
1. Tap the three-dot menu and go to **Settings** → **Other security settings**.
1. Tap **Security certificates** → **Install from device storage** → **CA certificate** → **Install anyway**
1. Confirm installation with your graphic key/password/fingerprint.
1. Find and select the previously saved certificate, then tap **Done**.
1. Return to the AdGuard app and navigate back to the main screen. You may have to swipe and restart the app to get rid of the *HTTPS filtering is off* message.
1. Done! The certificate has been installed.
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,11 @@ Users can also handle their DNS security on the Network settings screen. *Filter

### DNS filtering {#dns-filtering}

To get access to this setting, *Advanced mode* has to be enabled from the *General settings* screen. After that, a new section will appear on the DNS protection screen. Tap it to customize your DNS traffic by applying own rules.
DNS filtering allows you to customize your DNS traffic by enabling AdGuard DNS filter, adding custom DNS filters, and using the DNS blocklist/allowlist.

How to access:

*Protection* icon (the shield icon in the bottom menu bar) → *DNS protection* → *DNS filtering*

![DNS filtering screen *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/dns_filtering_en.jpeg)

Expand Down Expand Up @@ -149,9 +153,9 @@ On iOS 15 devices, the Assistant features are available through [AdGuard Safari

This is the 'information hub' of AdGuard's DNS protection suite. You can quickswitch to it by tapping the third icon in the row at the screen bottom. N.b. this screen is only seen when DNS protection is enabled.

![Activity screen *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/activity_en.jpeg)
![Activity screen *mobile_border](https://cdn.adtidy.org/content/github/ad_blocker/ios/activity.png)

Here AdGuard displays stats about device's DNS requests, such as total number, number of encrypted requests and average processing time. AdGuard can display the stats for a day, a week, a month, or in total.
This is where AdGuard displays statistics about the device's DNS requests, such as total number, number of blocked requests and data saved by blocking them. AdGuard can display the statistics for a day, a week, a month or in total.

Below is the *Recent activity* feed. AdGuard stores the last 1500 DNS requests that have originated on your device and shows their attributes such as protocol type and target domain.

Expand All @@ -165,7 +169,7 @@ Tap any request to view more details. There will also be buttons to add the requ

![Request details *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/request_info_en.jpeg)

Above the activity feed, there are *Most active companies*. Aggregated data on the last 1500 requests are shown here.
Above the activity feed, there are *Most active* and *Most blocked* companies. Tap each to see data based on the last 1500 requests.

### Statistics {#statistics}

Expand Down Expand Up @@ -197,9 +201,9 @@ While Safari content blocking and DNS protection are indisputably two major modu

- **Dark theme**

![Light theme *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/main_screen_en.jpeg)
![Light theme *mobile_border](https://cdn.adtidy.org/blog/new/26vo4homelight.jpeg)

![Dark theme *mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/main_screen_dark_en.jpeg)
![Dark theme *mobile_border](https://cdn.adtidy.org/blog/new/bgko8homedark.jpeg)

Residing right at the top of **Settings** → **General** screen, this setting allows you to switch between dark and light themes.

Expand All @@ -219,7 +223,7 @@ An alternative mode for Safari filtering, it unblocks ads everywhere except for

- **Advanced mode**

Aside from unlocking **DNS filtering**, it grants access to **Advanced settings**. We don't recommend messing with those, unless you know what you're doing or you have consulted with technical support first.
**Advanced mode** unlocks **Advanced settings**. We don't recommend messing with those, unless you know what you're doing or you have consulted with technical support first.

- **Reset statistics**

Expand Down
Loading
Loading