From 81cdc671166cae4ab565eb0f5489792c5f150eec Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Fri, 8 Sep 2023 18:49:03 +0300 Subject: [PATCH 1/9] Add videos to some articles Plus fixed wordings and links --- docs/general/adguard-vpn-protocol.mdx | 4 +- .../{how-vpn-works.md => how-vpn-works.mdx} | 12 ++-- docs/general/why-adguard-vpn.md | 56 ++++++++++++------- docs/{intro.md => intro.mdx} | 18 +++--- 4 files changed, 53 insertions(+), 37 deletions(-) rename docs/general/{how-vpn-works.md => how-vpn-works.mdx} (86%) rename docs/{intro.md => intro.mdx} (71%) diff --git a/docs/general/adguard-vpn-protocol.mdx b/docs/general/adguard-vpn-protocol.mdx index 6e6065151..3bd0f922b 100644 --- a/docs/general/adguard-vpn-protocol.mdx +++ b/docs/general/adguard-vpn-protocol.mdx @@ -3,9 +3,7 @@ title: 'How AdGuard VPN protocol works' sidebar_position: 4 --- -Our protocol is used by [all AdGuard VPN mobile and desktop applications](https://adguard-vpn.com/en/welcome.html). Download any of our products and use it knowing that your data is protected in the most secure way. - - +Our protocol is used by [all AdGuard VPN mobile and desktop applications](https://adguard-vpn.com/welcome.html). Download any of our products and use it knowing that your data is protected in the most secure way. ## Why we developed the AdGuard VPN protocol diff --git a/docs/general/how-vpn-works.md b/docs/general/how-vpn-works.mdx similarity index 86% rename from docs/general/how-vpn-works.md rename to docs/general/how-vpn-works.mdx index b6453518f..83f18746f 100644 --- a/docs/general/how-vpn-works.md +++ b/docs/general/how-vpn-works.mdx @@ -5,9 +5,11 @@ sidebar_position: 1 To understand how AdGuard VPN works, you should at first understand the general principles of the VPN service. + + ## VPN features -A VPN is a Virtual Private Network that helps hide your location and protect your data on the web. A VPN connects a computer or a mobile device to a VPN server and uses the IP address of this server to make it seem to an outside observer that you are in another place. This allows you to securely access various Internet resources and protect your personal data. +A VPN is a virtual private network that helps hide your location and protect your data on the Web. A VPN connects a computer or a mobile device to a VPN server and uses the IP address of this server to make it seem to an outside observer that you are in another place. This allows you to securely access various Internet resources and protect your personal data. In that way, a VPN performs two important functions: @@ -39,11 +41,11 @@ VPN security protocols are tools that encrypt data in a VPN tunnel and allow you In addition to these VPN protocols, there are others (for example, TLS, SSTP, IKEv2), but they are unpopular or do not meet modern data encryption standards. -![How a VPN protocol works](https://cdn.adguardvpn.com/public/Adguard/Blog/vpn/protocol/4.svg) + AdGuard VPN also has its own [*protocol*](adguard-vpn-protocol.mdx). One of its advantages is that the traffic transmitted using the AdGuard VPN protocol is difficult to distinguish from the regular traffic. The VPN tunnel looks like normal HTTPS traffic, so it is extremely difficult to detect and block it. In addition, it is based on the mechanisms of the modern HTTP/2 protocol, which ensures high connection speed. -![How concealed VPN works](https://cdn.adguardvpn.com/public/Adguard/Blog/vpn/protocol/5.svg) + ## VPN drawbacks @@ -67,7 +69,7 @@ Our VPN service has several important [advantages](why-adguard-vpn.md): * [*Proprietary VPN protocol*](adguard-vpn-protocol.mdx), which works stably even with a slow Internet connection and disguises itself as normal traffic, making it more difficult to track and block it -* [*"No-logs" policy*](https://adguard-vpn.com/en/privacy.html), which means that AdGuard VPN does not collect your personal data and does not transfer it to third parties +* [*No-logging policy*](https://adguard-vpn.com/privacy.html), which means that AdGuard VPN does not collect your personal data and does not transfer it to third parties * *More than 50 VPN servers in dozens of countries* @@ -81,4 +83,4 @@ Currently, AdGuard VPN is available as: * Desktop application for [Windows](../adguard-vpn-for-windows/overview.md) and [Mac](../adguard-vpn-for-mac/overview.md) -You can learn more about AdGuard VPN features (including the unlimited version) [here](https://adguard-vpn.com/en/welcome.html). +[Learn more about AdGuard VPN features](https://adguard-vpn.com/welcome.html) diff --git a/docs/general/why-adguard-vpn.md b/docs/general/why-adguard-vpn.md index 4d94bb85d..ca4c4a2f9 100644 --- a/docs/general/why-adguard-vpn.md +++ b/docs/general/why-adguard-vpn.md @@ -10,63 +10,77 @@ When getting ready to commit to a [long-term VPN subscription](subscription.md), ## 1. Proprietary protocol From the very outset, we resolved to develop and deploy an in-house VPN protocol instead of picking a canned solution — that’d be too easy, plus, we weren’t satisfied with existing protocols. The result has become the [AdGuard VPN protocol](adguard-vpn-protocol.mdx). -Choosing a VPN service, people often face a trade-off between fast vs. safe. The AdGuard VPN protocol is a perfect blend of speed and security, so you don’t have to bear slow internet connection or make privacy sacrifices. Among other things, it disguises itself as regular traffic and it’s much harder to detect and block it. +Choosing a VPN service, people often face a trade-off between fast vs. safe. The AdGuard VPN protocol is a perfect blend of speed and security, so you don’t have to bear slow Internet connection or make privacy sacrifices. Among other things, it disguises itself as regular traffic and it’s much harder to detect and block it. -## 2. Exclusions -The *Exclusions lists* allow you to select sites for which the VPN should be enabled and for which — disabled. There are two operation modes in AdGuard VPN: *General* and *Selective*. In *General mode*, VPN works everywhere except websites added to exclusions. And vice versa, in *Selective mode*, VPN works nowhere but on websites added to exclusions. You can also easily import/export exclusions lists. Read about this feature in *Features overview* for the product you are interested in. +## 2. Website and app exclusions -![An example of an exclusion list for Selective mode](https://cdn.adguardvpn.com/public/Adguard/Blog/vpn_export_exclusions.png) +There are situations where you don't need your VPN to be active: for instance, when you're ordering food or using maps. For this reason, AdGuard VPN has a special feature: Exclusions. -You can add websites to exclusions manually or choose them among the lists of popular services. The lists are divided into eight categories: Social networks, Messengers, Video and Music streaming services, Games, Shopping, Search engines, and Work communication tools. +![Exclusions](https://cdn.adguard.com/content/blog/articles/adguard-vpn/exclusions-en.png) -> This feature is available on all platforms except iOS. +You can activate AdGuard VPN **selectively** — only for certain websites or apps. This option is for those who use a VPN service only in specific situations: to enter a blocked website, use an app or watch a TV show that's not available in their country, or not to expose their data when visiting some websites. Turning a VPN on selectively also helps save VPN traffic. -## 3. Choosing a DNS server -No more relying on the DNS server provided by your ISP by default! First, it’s not safe: your ISP most likely has access to your browsing history. Second, people often underestimate DNS, yet it can remove ads and trackers, protect your device from malware or, for instance, enable safe search and block adult content. +If you prefer absolute anonymity in most cases, you can activate AdGuard VPN **everywhere except for the excluded websites or apps**. Just add your food delivery apps and utility payment websites to Exclusions — for them, VPN will be off. -You can choose DNS servers from [known DNS providers](https://adguard-dns.io/kb/general/dns-providers/) such as AdGuard, Cisco, Cloudflare, Google, or Quad9, or even configure to use your own DNS server. +## 3. Block ads and trackers with a DNS server + +Relying on the DNS server provided by your ISP by default is not safe: your ISP most likely has access to your browsing history. With the AdGuard VPN app, you can choose a secure and encrypted DNS server from [known DNS providers](https://adguard-dns.io/kb/general/dns-providers/), such as AdGuard DNS, Cisco, Cloudflare, Google, or Quad9, or even add your own DNS server. + +We recommend using an AdGuard DNS server: it blocks ads and trackers and protects your device from malware. + +![DNS servers](https://cdn.adtidy.org/blog/new/lkarpag_dns_screen_en.png) ## 4. Fastest locations +![VPN server locations](https://cdn.adguard.com/content/blog/articles/adguard-vpn/locations-en.png) + Another feature that makes AdGuard VPN stand out from the crowd is that you can select a location based on its ping. In a nutshell, ping is the time it takes the data packet sent from your device to reach the server and return. When in doubt, use a rule of thumb: the lower the ping, the closer the server, the higher its speed. We are constantly expanding the number of locations so that you can choose from a variety. > Note that to access all VPN server locations, you need to purchase an AdGuard VPN subscription. -## 5. Compatibility with AdGuard Ad Blocker +## 5. Integration with AdGuard Ad Blocker With desktop apps and browser extensions this goes without saying — there’s rarely any conflicts between apps, save for antiviruses and other similarly oriented software. -With mobile devices, on the other hand, it’s not that simple. In the vast majority of cases, two VPN-based apps will not work together, just because certain OS-induced limitations exist that prevent that from happening, both on Android and iOS. +With mobile devices, hovewer, it’s not that simple. In the vast majority of cases, two VPN-based apps will not work together. Both in Android and iOS, there are limitations that prevent it. + +![Integrated mode](https://cdn.adguard.com/content/blog/articles/adguard-vpn/integration-en.png) However, we managed to find a solution to befriend AdGuard VPN and AdGuard Ad Blocker. When you have both AdGuard apps installed on one device, they will automatically become compatible without any input required from you. This is a unique opportunity to take advantage of two sets of features, which you would normally have to choose between. ## 6. QUIC support -[QUIC](https://adguard.com/blog/dns-over-quic.html) is a cutting-edge protocol that has many perks. The main advantage is it can improve connection quality in non-ideal conditions – for example, on mobile devices or when connecting to public Wi-Fi. Although the new protocol won’t affect speed when the connection is fine and stable, it will definitely make the situation better for users with slow internet. + +[QUIC](https://adguard-dns.io/en/blog/dns-over-quic.html#whatisquic) is a cutting-edge protocol that has many perks. The main advantage is it can improve the connection quality in non-ideal conditions – for example, on mobile devices or when connecting to public Wi-Fi. Although the new protocol won’t affect speed when the connection is fine and stable, it will definitely make the situation better for users with slow Internet. + +> The QUIC protocol is rather new and may be unstable. We cannot guarantee its complete reliability for every case. *Now let’s switch to the item set that any decent VPN can't do without.* ## 7. Kill Switch Kill Switch is essential if you, for instance, often use a mobile network or connect to public Wi-Fi networks in malls, cafes, on the subway or at the airport. For the simple reason — if VPN will suddenly drop and the connection will become insecure, chances are that your sensitive information will be exposed to fraudsters or cyber criminals. -If for some reason your VPN connection is interrupted, Kill Switch will automatically disconnect the internet connection, keeping attackers away from seizing your information. With Kill Switch, rest assured that you are in safe hands. If you’re concerned about privacy or at least value your personal data, don’t overlook this bulletproof method. +If for some reason your VPN connection is interrupted, Kill Switch will automatically disconnect you from the Internet, keeping attackers away from seizing your information. + +## 8. Auto-protection +This feature has been developed specifically for unsecured networks. If you enable Auto-protection, you won't ever forget to enable VPN when visiting public places. Should you pop into a coffee shop and connect to a local Wi-Fi network, you’ll be automatically connected to AdGuard VPN. + +> Auto-protection is available in AdGuard VPN for iOS and Android. -## 8. Split tunneling -This feature resembles the exclusions lists mentioned above. The only difference is that here you can exclude apps instead of websites. +## 9. Ten simultaneous connections +With an AdGuard VPN subscription, you can connect up to ten devices *simultaneously*. -## 9. Auto-Protection -This feature has been developed specifically for unsecured networks. For the convenience of users, we made it impossible to forget to enable VPN when visiting public places. Should you pop into a coffee shop and connect to a local Wi-Fi network, you’ll be automatically connected to AdGuard VPN. +Some VPN providers only allow to log in to their service on *ten devices max*. With AdGuard VPN, *it doesn't matter* on how many devices you log in to your AdGuard account, but you can have ten VPN connections enabled at the same time. -## 10. Up to five connected devices at a time -AdGuard VPN offers five simultaneous connections to its paid users. We place special emphasis on the word *simultaneous*, and here is why. Some VPN providers only allow to log in to their service on *five devices max*. With AdGuard VPN, *there’s no limit* to the number of devices that can be logged in to your account, but you can have five VPN connections enabled at the same time. Those who don’t have a subscription can use AdGuard VPN on *two devices*, which gives us another trump card to play against competitors — most of the VPN services only have *one device* in their free versions. +Those who don’t have a subscription, can use AdGuard VPN on *two devices simultaneously*, which gives us another trump card to play against competitors: most free VPN services only allow you to use one device at a time. -## 11. Secure streaming +## 10. Secure streaming Streaming services don't like VPNs for obvious reasons: according to statistics, about 20% of users install a VPN mainly to watch shows, TV shows and movies bypassing geo-blocking. That's why streaming platforms tend to do everything they can to track VPN traffic and block it. But what if you want to feel safe while watch content specific to your region? Or don't want stop watching exciting series even when you travel to another country? The answer is simple — AdGuard VPN, which thanks to its unique protocol can remain invisible to services. > We don't endorse the use of AdGuard VPN to bypass copyright regulations. -## 12. Dark mode +## 11. Dark mode ![Dark mode](https://cdn.adguardvpn.com/public/Adguard/Blog/vpn/main_en_black.png) diff --git a/docs/intro.md b/docs/intro.mdx similarity index 71% rename from docs/intro.md rename to docs/intro.mdx index fd044ff41..54a3cbeac 100644 --- a/docs/intro.md +++ b/docs/intro.mdx @@ -6,9 +6,11 @@ slug: / ## What is a VPN and why do you need one? + + A VPN allows you to create a secure connection to another network on the Internet. -Initially, VPNs were created for one purpose — to securely connect business networks over the Internet, so that people could connect to the corporate network from home. This technology is used for many other things: for example, to browse the Internet anonymously or to protect your online activity from prying eyes while using public Wi-Fi. +Initially, VPNs were created to securely connect business networks over the Internet, so that people could connect to the corporate network from home. This technology is used for many other things: for example, to browse the Internet anonymously or to protect your online activity from prying eyes while using public Wi-Fi. A VPN connects a user's computer or mobile device to a server and allows one to browse the net using someone else's IP address. Thus, third-party observers cannot see the user's real IP address, which makes it nearly impossible to trace them. @@ -16,9 +18,9 @@ Speaking of VPN, the first thing they mention is traffic encryption and security VPN can be used to: -* hide your real whereabouts and stay anonymous -* secure your data — even when connecting to a public Wi-Fi, you can browse the Web safely -* protect yourself from spoofing (network traffic interception) and tracking on the part of your Internet service provider +* Hide your real whereabouts and stay anonymous +* Secure your data — even when connecting to a public Wi-Fi, you can browse the Web safely +* Protect yourself from spoofing (network traffic interception) and tracking on the part of your Internet service provider Passwords, card details, and just plain personal information are at risk when a user surfs the Internet. But if you connect to the global network using a VPN, you can be sure that no one can intercept your data. @@ -30,14 +32,14 @@ AdGuard has been present on the market of personal data protection and ad blocki ### Unique VPN protocol The main difference between AdGuard VPN and its competitors is that we use [our own developed protocol](/general/adguard-vpn-protocol.mdx). It disguises itself as normal traffic, so it is much more difficult to track and block it. -### No logs policy +### No-logging policy -No logs policy means that we don’t collect, store or transfer users’ personal data to third parties. The full text of AdGuard VPN Privacy policy can be found [here](https://adguard-vpn.com/privacy.html). +No-logging policy means that we don’t collect, store, or transfer users’ personal data to third parties. [Read AdGuard VPN Privacy policy](https://adguard-vpn.com/privacy.html) ### Tracking protection -Web traffic from any user may be of interest and is particularly valuable in terms of monetization of personal data. Both criminals and unscrupulous ISPs can access it. However, with a trustworthy VPN, you can be confident that neither your provider nor anyone else will see your internet activity. +Web traffic from any user may be of interest and is particularly valuable in terms of monetization of personal data. Both criminals and unscrupulous ISPs can access it. However, with a trustworthy VPN, you can be confident that neither your provider nor anyone else will see your Internet activity. -### Ultrafast VPN servers in 53 countries +### Ultra-fast VPN servers in 53 countries * Argentina * Australia From 1ef222660c894f1d0b0a1b4dde293458791e7e68 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Fri, 8 Sep 2023 19:03:55 +0300 Subject: [PATCH 2/9] Fix markdown --- docs/general/adguard-vpn-protocol.mdx | 18 ++--- docs/general/how-vpn-works.mdx | 2 +- docs/general/why-adguard-vpn.md | 1 + docs/intro.mdx | 106 +++++++++++++------------- 4 files changed, 64 insertions(+), 63 deletions(-) diff --git a/docs/general/adguard-vpn-protocol.mdx b/docs/general/adguard-vpn-protocol.mdx index 9e8587a21..0c73f8516 100644 --- a/docs/general/adguard-vpn-protocol.mdx +++ b/docs/general/adguard-vpn-protocol.mdx @@ -9,9 +9,9 @@ Our protocol is used by [all AdGuard VPN mobile and desktop applications](https: For years, we were concentrating on developing all flavors of ad blocking apps and browser extensions. And in 2019 we resolved to develop our own VPN service, seemingly out of nowhere. When in reality, there were a few reasons that prompted us to do so. -* AdGuard mobile apps had compatibility issues with VPN apps. Normally, two VPN-based mobile apps can't work together: in rare cases on iOS, and never on Android. As AdGuard ad blocker apps use local VPN to filter network traffic, using them alongside any VPN app would be out of the question. That's why we saw the development of an in-house VPN as the only feasible solution that could guarantee compatibility: after we apply some magic, the two apps are able to work together as one VPN service. -* Secondly, VPN seemed more than relevant to our philosophy and priorities. Our primary goal is to protect users' privacy, and this is exactly what VPNs are for. -* Finally, over the years of developing AdGuard software, we have become experts in filtering network traffic. This allowed us to bring in something new instead of becoming another wishy-washy VPN. +- AdGuard mobile apps had compatibility issues with VPN apps. Normally, two VPN-based mobile apps can't work together: in rare cases on iOS, and never on Android. As AdGuard ad blocker apps use local VPN to filter network traffic, using them alongside any VPN app would be out of the question. That's why we saw the development of an in-house VPN as the only feasible solution that could guarantee compatibility: after we apply some magic, the two apps are able to work together as one VPN service. +- Secondly, VPN seemed more than relevant to our philosophy and priorities. Our primary goal is to protect users' privacy, and this is exactly what VPNs are for. +- Finally, over the years of developing AdGuard software, we have become experts in filtering network traffic. This allowed us to bring in something new instead of becoming another wishy-washy VPN. From the outset, we decided that AdGuard VPN would have one key difference from its competitors — we shall develop and deploy an in-house VPN protocol which would not force users to choose between security and speed. @@ -19,8 +19,8 @@ From the outset, we decided that AdGuard VPN would have one key difference from We developed the AdGuard VPN protocol seeing the disadvantages of popular VPN protocols (OpenVPN, WireGuard, IPSec, etc.): -* They can be easily detected and blocked on the network level. -* If you try to "hide" them, the performance will drop. +- They can be easily detected and blocked on the network level. +- If you try to "hide" them, the performance will drop. To "conceal" the use of VPN, the data flow is often "wrapped" in a TCP connection, and sometimes it is additionally encrypted to make the traffic look like a normal website connection. Unfortunately, this approach has a disadvantage – due to the use of TCP, there is a need for additional confirmation of delivery. @@ -32,12 +32,12 @@ Using any popular VPN protocol, we are always facing a trade-off: fast but easy -* It's *nearly impossible to distinguish from normal HTTPS traffic*, that is, the connection to the AdGuard VPN server looks exactly the same as the connection to a normal website. -* For encryption we use **HTTPS (TLS)**, which copes with this task perfectly. It is the most popular encryption method in the world, and the libraries that implement it are constantly audited for security. +- It's *nearly impossible to distinguish from normal HTTPS traffic*, that is, the connection to the AdGuard VPN server looks exactly the same as the connection to a normal website. +- For encryption we use **HTTPS (TLS)**, which copes with this task perfectly. It is the most popular encryption method in the world, and the libraries that implement it are constantly audited for security. Some existing VPN protocols also handle the encryption task, and they (and thus, the fact of using a VPN) are hard to detect. But this usually comes at the price of reduced speed. This is not our case, thanks to several solutions. -* We use the **HTTP/2 transport protocol**, which makes it virtually impossible to detect AdGuard VPN protocol while maintaining high speed. -* Unlike others, AdGuard VPN protocol *operates with data and not with packets*. This means that AdGuard VPN establishes a separate "tunnel" for each connection, each HTTP/2 stream corresponds to one connection. AdGuard VPN transfers data through this tunnel. This allows us to speed up the operation by saving on confirmation packets, because we can buffer the data of several packets into one before sending it to the VPN server (or from the server to the client). And the fewer packets, the fewer confirmations are needed. +- We use the **HTTP/2 transport protocol**, which makes it virtually impossible to detect AdGuard VPN protocol while maintaining high speed. +- Unlike others, AdGuard VPN protocol *operates with data and not with packets*. This means that AdGuard VPN establishes a separate "tunnel" for each connection, each HTTP/2 stream corresponds to one connection. AdGuard VPN transfers data through this tunnel. This allows us to speed up the operation by saving on confirmation packets, because we can buffer the data of several packets into one before sending it to the VPN server (or from the server to the client). And the fewer packets, the fewer confirmations are needed. \ No newline at end of file diff --git a/docs/general/how-vpn-works.mdx b/docs/general/how-vpn-works.mdx index 8a391e3bb..1c8a79b1c 100644 --- a/docs/general/how-vpn-works.mdx +++ b/docs/general/how-vpn-works.mdx @@ -67,7 +67,7 @@ Our VPN service has several important [advantages](why-adguard-vpn.md): - [*Proprietary VPN protocol*](adguard-vpn-protocol.mdx), which works stably even with a slow Internet connection and disguises itself as normal traffic, making it more difficult to track and block it -* [*No-logging policy*](https://adguard-vpn.com/privacy.html), which means that AdGuard VPN does not collect your personal data and does not transfer it to third parties +- [*No-logging policy*](https://adguard-vpn.com/privacy.html), which means that AdGuard VPN does not collect your personal data and does not transfer it to third parties - *More than 50 VPN servers in dozens of countries* diff --git a/docs/general/why-adguard-vpn.md b/docs/general/why-adguard-vpn.md index c72a2cd47..14ac6eac0 100644 --- a/docs/general/why-adguard-vpn.md +++ b/docs/general/why-adguard-vpn.md @@ -71,6 +71,7 @@ This feature has been developed specifically for unsecured networks. If you enab > Auto-protection is available in AdGuard VPN for iOS and Android. ## 9. Ten simultaneous connections + With an AdGuard VPN subscription, you can connect up to ten devices *simultaneously*. Some VPN providers only allow to log in to their service on *ten devices max*. With AdGuard VPN, *it doesn't matter* on how many devices you log in to your AdGuard account, but you can have ten VPN connections enabled at the same time. diff --git a/docs/intro.mdx b/docs/intro.mdx index a7fb31cc2..7c0b13054 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -41,56 +41,56 @@ Web traffic from any user may be of interest and is particularly valuable in ter ### Ultra-fast VPN servers in 53 countries -* Argentina -* Australia -* Austria -* Belgium -* Brazil -* Bulgaria -* Cambodia -* Canada -* Chile -* Colombia -* Croatia -* Cyprus -* Czechia -* Denmark -* Egypt -* Estonia -* Finland -* France -* Germany -* Greece -* Hong Kong -* Hungary -* India -* Ireland -* Israel -* Italy -* Japan -* Kazakhstan -* Luxembourg -* Mexico -* Netherlands -* New Zealand -* Norway -* Philippines -* Poland -* Portugal -* Romania -* Russia -* Serbia -* Singapore -* Slovakia -* South Africa -* South Korea -* Spain -* Sweden -* Switzerland -* Taiwan -* Turkey -* United Kingdom -* United Arab Emirates -* United States of America -* Ukraine -* Vietnam +- Argentina +- Australia +- Austria +- Belgium +- Brazil +- Bulgaria +- Cambodia +- Canada +- Chile +- Colombia +- Croatia +- Cyprus +- Czechia +- Denmark +- Egypt +- Estonia +- Finland +- France +- Germany +- Greece +- Hong Kong +- Hungary +- India +- Ireland +- Israel +- Italy +- Japan +- Kazakhstan +- Luxembourg +- Mexico +- Netherlands +- New Zealand +- Norway +- Philippines +- Poland +- Portugal +- Romania +- Russia +- Serbia +- Singapore +- Slovakia +- South Africa +- South Korea +- Spain +- Sweden +- Switzerland +- Taiwan +- Turkey +- United Kingdom +- United Arab Emirates +- United States of America +- Ukraine +- Vietnam From 7d285038f1616cacc9645056109918b3296f99e9 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Fri, 8 Sep 2023 19:05:50 +0300 Subject: [PATCH 3/9] Fix blank line --- docs/general/why-adguard-vpn.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/general/why-adguard-vpn.md b/docs/general/why-adguard-vpn.md index 14ac6eac0..106602ba4 100644 --- a/docs/general/why-adguard-vpn.md +++ b/docs/general/why-adguard-vpn.md @@ -13,7 +13,6 @@ From the very outset, we resolved to develop and deploy an in-house VPN protocol Choosing a VPN service, people often face a trade-off between fast vs. safe. The AdGuard VPN protocol is a perfect blend of speed and security, so you don’t have to bear slow Internet connection or make privacy sacrifices. Among other things, it disguises itself as regular traffic and it’s much harder to detect and block it. - ## 2. Website and app exclusions There are situations where you don't need your VPN to be active: for instance, when you're ordering food or using maps. For this reason, AdGuard VPN has a special feature: Exclusions. From b877818f8ac0aa4f4fd54a8d00b7cef08b89b7fc Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Fri, 8 Sep 2023 19:11:12 +0300 Subject: [PATCH 4/9] Fix links --- docs/adguard-vpn-for-android/overview.md | 2 +- docs/adguard-vpn-for-ios/overview.md | 2 +- docs/adguard-vpn-for-mac/overview.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/adguard-vpn-for-android/overview.md b/docs/adguard-vpn-for-android/overview.md index 802f3caa9..6201be688 100644 --- a/docs/adguard-vpn-for-android/overview.md +++ b/docs/adguard-vpn-for-android/overview.md @@ -5,7 +5,7 @@ sidebar_position: 1 ## What is AdGuard VPN for Android? -A VPN is an ideal tool that provides security and anonymity each time you browse the Internet. [How does it work?](/general/how-vpn-works.md) Without going into technical details, we can say that VPN creates a secure encrypted tunnel between the user's computer or mobile device and a remote VPN server. In this way, data confidentiality is preserved, as well as the anonymity of the user, because a third-party observer sees the IP address of the VPN server and not the actual user's IP. +A VPN is an ideal tool that provides security and anonymity each time you browse the Internet. [How does it work?](/general/how-vpn-works.mdx) Without going into technical details, we can say that VPN creates a secure encrypted tunnel between the user's computer or mobile device and a remote VPN server. In this way, data confidentiality is preserved, as well as the anonymity of the user, because a third-party observer sees the IP address of the VPN server and not the actual user's IP. **VPN is frequently used for:** diff --git a/docs/adguard-vpn-for-ios/overview.md b/docs/adguard-vpn-for-ios/overview.md index 3e5fe979d..b23cea568 100644 --- a/docs/adguard-vpn-for-ios/overview.md +++ b/docs/adguard-vpn-for-ios/overview.md @@ -5,7 +5,7 @@ sidebar_position: 1 ## What is AdGuard VPN for iOS? -A VPN allows you to create a secure connection to another network on the Internet. It connects a user's computer or mobile device to a server and allows one to browse the net using someone else's IP address. So if the VPN server is located in a different country, it will appear that you have connected to the Internet from that country. [Learn more](/general/how-vpn-works.md) about how a VPN works in detail. +A VPN allows you to create a secure connection to another network on the Internet. It connects a user's computer or mobile device to a server and allows one to browse the net using someone else's IP address. So if the VPN server is located in a different country, it will appear that you have connected to the Internet from that country. [Learn more](/general/how-vpn-works.mdx) about how a VPN works in detail. Speaking of AdGuard VPN, it has several functions: diff --git a/docs/adguard-vpn-for-mac/overview.md b/docs/adguard-vpn-for-mac/overview.md index 3c5e5d4fd..9b81f18b8 100644 --- a/docs/adguard-vpn-for-mac/overview.md +++ b/docs/adguard-vpn-for-mac/overview.md @@ -45,7 +45,7 @@ What’s more, ready-made exclusions lists can be transferred to other devices w ![Support screen](https://cdn.adguardvpn.com/content/kb/vpn/mac/support_en.png) -The third tab is the *Support* screen. Find answers to any questions in the [FAQ](https://adguard-vpn.com/welcome.html#faq) or in the [Knowledge base](/intro.md) sections, report a bug if you encounter one, or [discuss AdGuard on any of the platforms](https://adguard.com/discuss.html). And feel free to [leave feedback about our product](https://surveys.adguard.com/vpn_mac/form.html), we’d appreciate it. +The third tab is the *Support* screen. Find answers to any questions in the [FAQ](https://adguard-vpn.com/welcome.html#faq) or in the [Knowledge base](/intro.mdx) sections, report a bug if you encounter one, or [discuss AdGuard on any of the platforms](https://adguard.com/discuss.html). And feel free to [leave feedback about our product](https://surveys.adguard.com/vpn_mac/form.html), we’d appreciate it. ## Settings From 3494cc47bb9b6108dc8f7e7c8f49d892eb597d69 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Mon, 11 Sep 2023 22:50:14 +0300 Subject: [PATCH 5/9] update markdownlint config --- .markdownlint.json | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.markdownlint.json b/.markdownlint.json index bfe0dbcfd..07f68de2a 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -2,6 +2,12 @@ "ul-indent": { "indent": 4 }, "ul-style": { "style": "dash" }, "no-trailing-spaces": { "br_spaces": 0 }, + "no-inline-html": { + "allowed_elements": [ + "iframe", + "img", + "object" + ]}, "line-length": false, "no-bare-urls": false, "link-fragments": false From 70041e6f257fd411f02609d2541cfc56a64501f8 Mon Sep 17 00:00:00 2001 From: Slava Leleka Date: Mon, 11 Sep 2023 22:52:36 +0300 Subject: [PATCH 6/9] multiple fixes of local urls and file extensions --- .../adguard-vpn-browser-extension/overview.md | 2 +- .../solving-problems/_category_.json | 6 +++++ docs/adguard-vpn-for-android/installation.md | 2 +- docs/adguard-vpn-for-android/overview.md | 4 ++-- .../solving-problems/integrated-mode.md | 2 +- docs/adguard-vpn-for-ios/installation.md | 2 +- docs/adguard-vpn-for-ios/overview.md | 6 ++--- .../solving-problems/integrated-mode.md | 2 +- docs/adguard-vpn-for-mac/installation.md | 2 +- docs/adguard-vpn-for-mac/overview.md | 2 +- docs/adguard-vpn-for-windows/overview.md | 4 ++-- .../common-installer-errors.md | 4 ++-- ...n-protocol.mdx => adguard-vpn-protocol.md} | 2 +- docs/general/free-vs-unlimited.md | 2 +- docs/general/how-to-install.md | 10 ++++---- .../{how-vpn-works.mdx => how-vpn-works.md} | 23 ++++++++++--------- docs/general/subscription.md | 2 +- docs/general/why-adguard-vpn.md | 4 ++-- docs/{intro.mdx => intro.md} | 11 +++++---- docs/miscellaneous/update-kb.md | 2 +- 20 files changed, 52 insertions(+), 42 deletions(-) create mode 100644 docs/adguard-vpn-browser-extension/solving-problems/_category_.json rename docs/general/{adguard-vpn-protocol.mdx => adguard-vpn-protocol.md} (99%) rename docs/general/{how-vpn-works.mdx => how-vpn-works.md} (67%) rename docs/{intro.mdx => intro.md} (92%) diff --git a/docs/adguard-vpn-browser-extension/overview.md b/docs/adguard-vpn-browser-extension/overview.md index 78a58f839..d4c5125f8 100644 --- a/docs/adguard-vpn-browser-extension/overview.md +++ b/docs/adguard-vpn-browser-extension/overview.md @@ -5,7 +5,7 @@ sidebar_position: 1 AdGuard VPN Browser extension is available for Chrome, Firefox, Opera, and Edge. The UI and functionality doesn't differ between browsers so the overview below will be relevant for AdGuard VPN extensions for all browsers. -> Note that you can only use AdGuard VPN Browser extension when logged in. Sign in with your AdGuard account or via Google, Facebook, or Apple. In the latter case make sure that your account is bound to the same email address as your AdGuard account. If you have an [AdGuard VPN subscription](/general/subscription.md), it will be activated automatically in AdGuard VPN Browser extension. Don’t have an AdGuard account yet? [Create it here](https://auth.adguard.com/registration.html). +> Note that you can only use AdGuard VPN Browser extension when logged in. Sign in with your AdGuard account or via Google, Facebook, or Apple. In the latter case make sure that your account is bound to the same email address as your AdGuard account. If you have an [AdGuard VPN subscription](/general/subscription), it will be activated automatically in AdGuard VPN Browser extension. Don’t have an AdGuard account yet? [Create it here](https://auth.adguard.com/registration.html). To manage your AdGuard VPN Browser extension: diff --git a/docs/adguard-vpn-browser-extension/solving-problems/_category_.json b/docs/adguard-vpn-browser-extension/solving-problems/_category_.json new file mode 100644 index 000000000..b9a8de5f0 --- /dev/null +++ b/docs/adguard-vpn-browser-extension/solving-problems/_category_.json @@ -0,0 +1,6 @@ +{ + "position": 2, + "label": "Solving problems", + "collapsible": true, + "collapsed": true +} diff --git a/docs/adguard-vpn-for-android/installation.md b/docs/adguard-vpn-for-android/installation.md index 568ff9c8b..4e7fe87bc 100644 --- a/docs/adguard-vpn-for-android/installation.md +++ b/docs/adguard-vpn-for-android/installation.md @@ -24,4 +24,4 @@ AdGuard VPN for Android has been successfully installed! If you decided to delete AdGuard VPN for Android, find the icon of this app and hold it. In the opened list, tap *Uninstall*. -You can learn more about the AdGuard VPN for Android in [this article](overview.md) +You can learn more about the AdGuard VPN for Android in [this article](/adguard-vpn-for-android/overview). diff --git a/docs/adguard-vpn-for-android/overview.md b/docs/adguard-vpn-for-android/overview.md index 6201be688..f388fe0c5 100644 --- a/docs/adguard-vpn-for-android/overview.md +++ b/docs/adguard-vpn-for-android/overview.md @@ -5,7 +5,7 @@ sidebar_position: 1 ## What is AdGuard VPN for Android? -A VPN is an ideal tool that provides security and anonymity each time you browse the Internet. [How does it work?](/general/how-vpn-works.mdx) Without going into technical details, we can say that VPN creates a secure encrypted tunnel between the user's computer or mobile device and a remote VPN server. In this way, data confidentiality is preserved, as well as the anonymity of the user, because a third-party observer sees the IP address of the VPN server and not the actual user's IP. +A VPN is an ideal tool that provides security and anonymity each time you browse the Internet. [How does it work?](/general/how-vpn-works) Without going into technical details, we can say that VPN creates a secure encrypted tunnel between the user's computer or mobile device and a remote VPN server. In this way, data confidentiality is preserved, as well as the anonymity of the user, because a third-party observer sees the IP address of the VPN server and not the actual user's IP. **VPN is frequently used for:** @@ -13,7 +13,7 @@ A VPN is an ideal tool that provides security and anonymity each time you browse - Preventing online activity tracking by masking the IP address - Hiding the real geolocation to remain anonymous -AdGuard VPN for Android can do it all for you — and even offer something unique. To find out why AdGuard VPN is the better option — read [this article](/general/why-adguard-vpn.md). +AdGuard VPN for Android can do it all for you — and even offer something unique. To find out why AdGuard VPN is the better option — read [this article](/general/why-adguard-vpn). ## How to start using AdGuard VPN for Android diff --git a/docs/adguard-vpn-for-android/solving-problems/integrated-mode.md b/docs/adguard-vpn-for-android/solving-problems/integrated-mode.md index 4078d6287..94215c323 100644 --- a/docs/adguard-vpn-for-android/solving-problems/integrated-mode.md +++ b/docs/adguard-vpn-for-android/solving-problems/integrated-mode.md @@ -3,7 +3,7 @@ title: Compatibility with AdGuard Ad Blocker sidebar_position: 3 --- -AdGuard VPN has the VPN operating mode enabled by default, which uses its own [AdGuard VPN protocol](/general/adguard-vpn-protocol.mdx). It provides the best combination of connection speed and security. However, this operating mode does not allow AdGuard VPN and AdGuard Ad Blocker to work simultaneously. The Compatibility mode, in turn, uses the IPsec protocol, which makes it possible for the AdGuard applications to work together. If you already have AdGuard Ad Blocker when installing AdGuard VPN, this mode will turn on automatically and allow you to use our applications at the same time. If you first installed AdGuard VPN, and only then decided to try AdGuard Ad Blocker, then to use them together, follow these steps: +AdGuard VPN has the VPN operating mode enabled by default, which uses its own [AdGuard VPN protocol](/general/adguard-vpn-protocol). It provides the best combination of connection speed and security. However, this operating mode does not allow AdGuard VPN and AdGuard Ad Blocker to work simultaneously. The Compatibility mode, in turn, uses the IPsec protocol, which makes it possible for the AdGuard applications to work together. If you already have AdGuard Ad Blocker when installing AdGuard VPN, this mode will turn on automatically and allow you to use our applications at the same time. If you first installed AdGuard VPN, and only then decided to try AdGuard Ad Blocker, then to use them together, follow these steps: 1. Open AdGuard VPN for Android and select the gear icon at the bottom right of the screen. diff --git a/docs/adguard-vpn-for-ios/installation.md b/docs/adguard-vpn-for-ios/installation.md index 1a2c39f60..45d0308a3 100644 --- a/docs/adguard-vpn-for-ios/installation.md +++ b/docs/adguard-vpn-for-ios/installation.md @@ -33,4 +33,4 @@ If you decided to delete AdGuard VPN for iOS, find the icon of this app on the H ![Uninstall *mobile_border](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/deinstall-en.png) -You can learn more about the AdGuard VPN app for iOS in [this article](overview.md). +You can learn more about the AdGuard VPN app for iOS in [this article](adguard-vpn-for-ios/overview). diff --git a/docs/adguard-vpn-for-ios/overview.md b/docs/adguard-vpn-for-ios/overview.md index b23cea568..80e66482c 100644 --- a/docs/adguard-vpn-for-ios/overview.md +++ b/docs/adguard-vpn-for-ios/overview.md @@ -5,7 +5,7 @@ sidebar_position: 1 ## What is AdGuard VPN for iOS? -A VPN allows you to create a secure connection to another network on the Internet. It connects a user's computer or mobile device to a server and allows one to browse the net using someone else's IP address. So if the VPN server is located in a different country, it will appear that you have connected to the Internet from that country. [Learn more](/general/how-vpn-works.mdx) about how a VPN works in detail. +A VPN allows you to create a secure connection to another network on the Internet. It connects a user's computer or mobile device to a server and allows one to browse the net using someone else's IP address. So if the VPN server is located in a different country, it will appear that you have connected to the Internet from that country. [Learn more](/general/how-vpn-works) about how a VPN works in detail. Speaking of AdGuard VPN, it has several functions: @@ -14,7 +14,7 @@ Speaking of AdGuard VPN, it has several functions: - encrypts your traffic to make it unreachable to scammers - lets you configure where to use VPN and where not to (exclusions feature) -The next advantage of AdGuard VPN for iOS is our own VPN protocol. It has two main benefits: comparing to other VPN protocols it is extremely hard to detect and it works stably even with a poor Internet connection. You can read more about AdGuard VPN protocol [in this article](../general/adguard-vpn-protocol.mdx). +The next advantage of AdGuard VPN for iOS is our own VPN protocol. It has two main benefits: comparing to other VPN protocols it is extremely hard to detect and it works stably even with a poor Internet connection. You can read more about AdGuard VPN protocol [in this article](/general/adguard-vpn-protocol). ## How to use AdGuard VPN for iOS @@ -59,7 +59,7 @@ Here, you can configure AdGuard VPN for iOS as you need using different options: AdGuard VPN for iOS can operate in two modes: **General** and **Integrated**. -In **General** mode, the [AdGuard VPN protocol](../general/adguard-vpn-protocol.mdx) is employed, which provides the best combination of speed and security. In this mode, AdGuard VPN will not be able to work alongside [AdGuard Ad Blocker for iOS](https://adguard.com/kb/adguard-for-ios/overview/). +In **General** mode, the [AdGuard VPN protocol](/general/adguard-vpn-protocol) is employed, which provides the best combination of speed and security. In this mode, AdGuard VPN will not be able to work alongside [AdGuard Ad Blocker for iOS](https://adguard.com/kb/adguard-for-ios/overview/). In **Integrated** mode, AdGuard VPN will be able to work at the same time with AdGuard for iOS ad blocker by using the IPSec protocol instead. This protocol is also secure, but a little slower and easier to detect. You don't need to perform any additional actions to set up the integration: just install both apps and switch to this mode. diff --git a/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md b/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md index d278fd596..c9317831f 100644 --- a/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md +++ b/docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md @@ -3,7 +3,7 @@ title: Compatibility with AdGuard Ad Blocker sidebar_position: 3 --- -AdGuard VPN has two operating modes — General and Integrated one. General mode is enabled by default and uses [AdGuard VPN protocol](/general/adguard-vpn-protocol.mdx). It provides the best combination of connection speed and security. +AdGuard VPN has two operating modes — General and Integrated one. General mode is enabled by default and uses [AdGuard VPN protocol](/general/adguard-vpn-protocol). It provides the best combination of connection speed and security. However, this operating mode does not allow AdGuard VPN and AdGuard Ad Blocker to work simultaneously. diff --git a/docs/adguard-vpn-for-mac/installation.md b/docs/adguard-vpn-for-mac/installation.md index b4fb68d3f..df1d42af4 100644 --- a/docs/adguard-vpn-for-mac/installation.md +++ b/docs/adguard-vpn-for-mac/installation.md @@ -55,4 +55,4 @@ Sometimes, as a result of incorrect removal, or in other rare cases, the standar AdGuard VPN has been completely removed from your Mac. -You can learn more about AdGuard VPN for Mac in [this article](/adguard-vpn-for-mac/overview.md). +You can learn more about AdGuard VPN for Mac in [this article](/adguard-vpn-for-mac/overview). diff --git a/docs/adguard-vpn-for-mac/overview.md b/docs/adguard-vpn-for-mac/overview.md index 9b81f18b8..9579819e3 100644 --- a/docs/adguard-vpn-for-mac/overview.md +++ b/docs/adguard-vpn-for-mac/overview.md @@ -45,7 +45,7 @@ What’s more, ready-made exclusions lists can be transferred to other devices w ![Support screen](https://cdn.adguardvpn.com/content/kb/vpn/mac/support_en.png) -The third tab is the *Support* screen. Find answers to any questions in the [FAQ](https://adguard-vpn.com/welcome.html#faq) or in the [Knowledge base](/intro.mdx) sections, report a bug if you encounter one, or [discuss AdGuard on any of the platforms](https://adguard.com/discuss.html). And feel free to [leave feedback about our product](https://surveys.adguard.com/vpn_mac/form.html), we’d appreciate it. +The third tab is the *Support* screen. Find answers to any questions in the [FAQ](https://adguard-vpn.com/welcome.html#faq) or in the [Knowledge base](/) sections, report a bug if you encounter one, or [discuss AdGuard on any of the platforms](https://adguard.com/discuss.html). And feel free to [leave feedback about our product](https://surveys.adguard.com/vpn_mac/form.html), we’d appreciate it. ## Settings diff --git a/docs/adguard-vpn-for-windows/overview.md b/docs/adguard-vpn-for-windows/overview.md index a3a1e923e..83ae67e88 100644 --- a/docs/adguard-vpn-for-windows/overview.md +++ b/docs/adguard-vpn-for-windows/overview.md @@ -9,13 +9,13 @@ A VPN, acronym for "Virtual Private Network", is a service that makes your Inter ## What AdGuard VPN for Windows does -- Protects from network traffic interception (spoofing). AdGuard VPN creates an encrypted tunnel between your device and a remote server. All your Internet traffic passes through this tunnel, so your data is protected along the way. And thanks to [AdGuard's unique protocol](/general/adguard-vpn-protocol.mdx), you're guaranteed a fast and secure connection. +- Protects from network traffic interception (spoofing). AdGuard VPN creates an encrypted tunnel between your device and a remote server. All your Internet traffic passes through this tunnel, so your data is protected along the way. And thanks to [AdGuard's unique protocol](/general/adguard-vpn-protocol), you're guaranteed a fast and secure connection. - Masks your IP address. Your true IP address is the key to your personal data for cybercriminals. Your name, email address, phone number, credit card information can all fall into the hands of fraudsters if you don't hide your IP. With AdGuard VPN, as we said before, all your traffic goes through an encrypted tunnel and comes to the VPN server. Therefore, from the outside it appears that your device has the IP address of said VPN server. - Hides your real location. By selecting any of the AdGuard VPN servers, you are instantly "teleported" to its location. What does this give you? For example, the ability to book a hotel at locals' rates or hide from geotargeted advertising. -AdGuard VPN for Windows has many advantages, so we've dedicated [a separate article](/general/why-adguard-vpn.md) to them. Here, however, we want to focus more on the application itself and how it works. +AdGuard VPN for Windows has many advantages, so we've dedicated [a separate article](/general/why-adguard-vpn) to them. Here, however, we want to focus more on the application itself and how it works. ## How to start using AdGuard VPN for Windows diff --git a/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md b/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md index 0bc8ca57a..24fcb3b16 100644 --- a/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md +++ b/docs/adguard-vpn-for-windows/solving-problems/common-installer-errors.md @@ -57,7 +57,7 @@ The error sounds scarier than it actually is. In reality, this is a rather gener - Choose a different installation folder. It is possible that the current installation folder has some access restrictions. Also make sure you don't select an external drive, a virtual drive, etc. -- Uninstall AdGuard VPN using our special [uninstall tool](../../installation#advanced) and then repeat the installation. +- Uninstall AdGuard VPN using our special [uninstall tool](/adguard-vpn-for-windows/installation#advanced) and then repeat the installation. - Start and re-register Microsoft Installer service. It requires some work. @@ -93,7 +93,7 @@ It's very likely that you've already installed AdGuard VPN before. - Check if AdGuard VPN is already installed on your computer. You can do it by pressing the *Win* key and typing in ***AdGuard VPN***. -- Maybe there are some leftover files from a previous AdGuard VPN installation. Uninstall AdGuard using our special [uninstall tool](../../installation#advanced) and then repeat the installation. +- Maybe there are some leftover files from a previous AdGuard VPN installation. Uninstall AdGuard using our special [uninstall tool](/adguard-vpn-for-windows/installation#advanced) and then repeat the installation. ### Other errors {#other} diff --git a/docs/general/adguard-vpn-protocol.mdx b/docs/general/adguard-vpn-protocol.md similarity index 99% rename from docs/general/adguard-vpn-protocol.mdx rename to docs/general/adguard-vpn-protocol.md index 0c73f8516..ea663b8b1 100644 --- a/docs/general/adguard-vpn-protocol.mdx +++ b/docs/general/adguard-vpn-protocol.md @@ -40,4 +40,4 @@ Some existing VPN protocols also handle the encryption task, and they (and thus, - We use the **HTTP/2 transport protocol**, which makes it virtually impossible to detect AdGuard VPN protocol while maintaining high speed. - Unlike others, AdGuard VPN protocol *operates with data and not with packets*. This means that AdGuard VPN establishes a separate "tunnel" for each connection, each HTTP/2 stream corresponds to one connection. AdGuard VPN transfers data through this tunnel. This allows us to speed up the operation by saving on confirmation packets, because we can buffer the data of several packets into one before sending it to the VPN server (or from the server to the client). And the fewer packets, the fewer confirmations are needed. - \ No newline at end of file + diff --git a/docs/general/free-vs-unlimited.md b/docs/general/free-vs-unlimited.md index 268ee5a8e..87846aeef 100644 --- a/docs/general/free-vs-unlimited.md +++ b/docs/general/free-vs-unlimited.md @@ -23,4 +23,4 @@ A subscription allows to have more benefits in comparison with a free account: - Secure streaming - No port 25 block -To use all the advantages, consider [purchasing a subscription](subscription.md). +To use all the advantages, consider [purchasing a subscription](/general/subscription). diff --git a/docs/general/how-to-install.md b/docs/general/how-to-install.md index dd9d6bbfd..096071698 100644 --- a/docs/general/how-to-install.md +++ b/docs/general/how-to-install.md @@ -5,8 +5,8 @@ sidebar_position: 3 Depending on which AdGuard VPN app or browser extension you want to install, follow one of these links to find the relevant article: -- [AdGuard VPN for Android](/adguard-vpn-for-android/installation.md) -- [AdGuard VPN for iOS](/adguard-vpn-for-ios/installation.md) -- [AdGuard VPN for Windows](/adguard-vpn-for-windows/installation.md) -- [AdGuard VPN for Mac](/adguard-vpn-for-mac/installation.md) -- [AdGuard VPN Browser extension](/adguard-vpn-browser-extension/installation.md) +- [AdGuard VPN for Android](/adguard-vpn-for-android/installation) +- [AdGuard VPN for iOS](/adguard-vpn-for-ios/installation) +- [AdGuard VPN for Windows](/adguard-vpn-for-windows/installation) +- [AdGuard VPN for Mac](/adguard-vpn-for-mac/installation) +- [AdGuard VPN Browser extension](/adguard-vpn-browser-extension/installation) diff --git a/docs/general/how-vpn-works.mdx b/docs/general/how-vpn-works.md similarity index 67% rename from docs/general/how-vpn-works.mdx rename to docs/general/how-vpn-works.md index 1c8a79b1c..248a90e51 100644 --- a/docs/general/how-vpn-works.mdx +++ b/docs/general/how-vpn-works.md @@ -14,10 +14,11 @@ A VPN is a virtual private network that helps hide your location and protect you In that way, a VPN performs two important functions: 1. **Maintaining anonymity** -Using an Internet connection, the user leaves their digital footprint, which can then be analyzed and used by third parties. For example, one of the online stores that you have visited can save your search history and then offer you their products based on it through targeted advertising. Or the secret services, having learned your location through the IP address of your device and having determined your identity, can secretly monitor your activity on the web. In addition, web browsers and ISPs themselves can use your browsing history for their own purposes, as well as sell it to advertisers and provide it to government institutions. VPN allows you to hide your IP address and replace it with the IP address of the VPN server to which you are connected. This way you will be able to maintain your privacy and anonymously search for information on the web. -2. **Data protection** -If you connect to an unreliable or public network, the data on your device may become vulnerable to cybercriminals. Bank card details, usernames and passwords, passport data — all this data can be intercepted by online fraudsters. The VPN tunnel encrypts the information that you send and receive from the web, so it can not fall into the wrong hands. + Using an Internet connection, the user leaves their digital footprint, which can then be analyzed and used by third parties. For example, one of the online stores that you have visited can save your search history and then offer you their products based on it through targeted advertising. Or the secret services, having learned your location through the IP address of your device and having determined your identity, can secretly monitor your activity on the web. In addition, web browsers and ISPs themselves can use your browsing history for their own purposes, as well as sell it to advertisers and provide it to government institutions. VPN allows you to hide your IP address and replace it with the IP address of the VPN server to which you are connected. This way you will be able to maintain your privacy and anonymously search for information on the web. + +1. **Data protection** + If you connect to an unreliable or public network, the data on your device may become vulnerable to cybercriminals. Bank card details, usernames and passwords, passport data — all this data can be intercepted by online fraudsters. The VPN tunnel encrypts the information that you send and receive from the web, so it can not fall into the wrong hands. ## VPN structure @@ -33,15 +34,15 @@ VPN security protocols are tools that encrypt data in a VPN tunnel and allow you 1. [*IPSec*](https://en.wikipedia.org/wiki/IPsec). One of its main advantages is that it is available on most devices and operating systems and provides a high level of security. However, the use of double [encapsulation](https://en.wikipedia.org/wiki/Encapsulation_(networking)) in this protocol may result in a lower connection speed. -2. [*OpenVPN*](https://en.wikipedia.org/wiki/OpenVPN). This modern protocol is open source, so third-party manufacturers can improve and update the technology. +1. [*OpenVPN*](https://en.wikipedia.org/wiki/OpenVPN). This modern protocol is open source, so third-party manufacturers can improve and update the technology. -3. [*WireGuard*](https://en.wikipedia.org/wiki/WireGuard). Its main advantages are ease of use, high efficiency and low vulnerability to attacks. +1. [*WireGuard*](https://en.wikipedia.org/wiki/WireGuard). Its main advantages are ease of use, high efficiency and low vulnerability to attacks. In addition to these VPN protocols, there are others (for example, TLS, SSTP, IKEv2), but they are unpopular or do not meet modern data encryption standards. -AdGuard VPN also has its own [*protocol*](adguard-vpn-protocol.mdx). One of its advantages is that the traffic transmitted using the AdGuard VPN protocol is difficult to distinguish from the regular traffic. The VPN tunnel looks like normal HTTPS traffic, so it is extremely difficult to detect and block it. In addition, it is based on the mechanisms of the modern HTTP/2 protocol, which ensures high connection speed. +AdGuard VPN also has its own [*protocol*](/general/adguard-vpn-protocol). One of its advantages is that the traffic transmitted using the AdGuard VPN protocol is difficult to distinguish from the regular traffic. The VPN tunnel looks like normal HTTPS traffic, so it is extremely difficult to detect and block it. In addition, it is based on the mechanisms of the modern HTTP/2 protocol, which ensures high connection speed. @@ -63,9 +64,9 @@ A weak signal, network overload, VPN incompatibility with a firewall, antivirus ## AdGuard VPN -Our VPN service has several important [advantages](why-adguard-vpn.md): +Our VPN service has several important [advantages](/general/why-adguard-vpn): -- [*Proprietary VPN protocol*](adguard-vpn-protocol.mdx), which works stably even with a slow Internet connection and disguises itself as normal traffic, making it more difficult to track and block it +- [*Proprietary VPN protocol*](/general/adguard-vpn-protocol), which works stably even with a slow Internet connection and disguises itself as normal traffic, making it more difficult to track and block it - [*No-logging policy*](https://adguard-vpn.com/privacy.html), which means that AdGuard VPN does not collect your personal data and does not transfer it to third parties @@ -75,10 +76,10 @@ Our VPN service has several important [advantages](why-adguard-vpn.md): Currently, AdGuard VPN is available as: -- [Browser extension](../adguard-vpn-browser-extension/overview.md) for Chrome, Firefox, and Edge +- [Browser extension](/adguard-vpn-browser-extension/overview) for Chrome, Firefox, and Edge -- Mobile app for [Android](../adguard-vpn-for-android/overview.md) and [iOS](../adguard-vpn-for-ios/overview.md) +- Mobile app for [Android](/adguard-vpn-for-android/overview) and [iOS](/adguard-vpn-for-ios/overview) -- Desktop application for [Windows](../adguard-vpn-for-windows/overview.md) and [Mac](../adguard-vpn-for-mac/overview.md) +- Desktop application for [Windows](/adguard-vpn-for-windows/overview) and [Mac](/adguard-vpn-for-mac/overview) [Learn more about AdGuard VPN features](https://adguard-vpn.com/welcome.html) diff --git a/docs/general/subscription.md b/docs/general/subscription.md index 4e51f27d2..da22d73e4 100644 --- a/docs/general/subscription.md +++ b/docs/general/subscription.md @@ -3,7 +3,7 @@ title: How to subscribe sidebar_position: 6 --- -AdGuard VPN is available in two versions — free and unlimited. The subscription allows you to use the app without any restrictions on traffic, connection speed and the choice of locations. You can [read more about all the advantages of the unlimited version](free-vs-unlimited.md). +AdGuard VPN is available in two versions — free and unlimited. The subscription allows you to use the app without any restrictions on traffic, connection speed and the choice of locations. You can [read more about all the advantages of the unlimited version](/general/free-vs-unlimited). If you have decided to purchase a subscription to AdGuard VPN, there are three ways to do this: diff --git a/docs/general/why-adguard-vpn.md b/docs/general/why-adguard-vpn.md index 106602ba4..52d8a93a6 100644 --- a/docs/general/why-adguard-vpn.md +++ b/docs/general/why-adguard-vpn.md @@ -3,13 +3,13 @@ title: 'Why AdGuard VPN is the better option' sidebar_position: 2 --- -When getting ready to commit to a [long-term VPN subscription](subscription.md), users most frequently evaluate its speed, security, and price. Those are very important points but there is so much more! AdGuard VPN has a dozen of key assets that make it 'the better option'. +When getting ready to commit to a [long-term VPN subscription](/general/subscription), users most frequently evaluate its speed, security, and price. Those are very important points but there is so much more! AdGuard VPN has a dozen of key assets that make it 'the better option'. *To start with, let’s go over AdGuard VPN’s unmatched features that you won’t find in any other VPN.* ## 1. Proprietary protocol -From the very outset, we resolved to develop and deploy an in-house VPN protocol instead of picking a canned solution — that’d be too easy, plus, we weren’t satisfied with existing protocols. The result has become the [AdGuard VPN protocol](adguard-vpn-protocol.mdx). +From the very outset, we resolved to develop and deploy an in-house VPN protocol instead of picking a canned solution — that’d be too easy, plus, we weren’t satisfied with existing protocols. The result has become the [AdGuard VPN protocol](/general/adguard-vpn-protocol). Choosing a VPN service, people often face a trade-off between fast vs. safe. The AdGuard VPN protocol is a perfect blend of speed and security, so you don’t have to bear slow Internet connection or make privacy sacrifices. Among other things, it disguises itself as regular traffic and it’s much harder to detect and block it. diff --git a/docs/intro.mdx b/docs/intro.md similarity index 92% rename from docs/intro.mdx rename to docs/intro.md index 7c0b13054..06cc13638 100644 --- a/docs/intro.mdx +++ b/docs/intro.md @@ -18,25 +18,28 @@ Speaking of VPN, the first thing they mention is traffic encryption and security VPN can be used to: -* Hide your real whereabouts and stay anonymous -* Secure your data — even when connecting to a public Wi-Fi, you can browse the Web safely -* Protect yourself from spoofing (network traffic interception) and tracking on the part of your Internet service provider +- Hide your real whereabouts and stay anonymous +- Secure your data — even when connecting to a public Wi-Fi, you can browse the Web safely +- Protect yourself from spoofing (network traffic interception) and tracking on the part of your Internet service provider Passwords, card details, and just plain personal information are at risk when a user surfs the Internet. But if you connect to the global network using a VPN, you can be sure that no one can intercept your data. ## Why AdGuard VPN? ### Trusted developer + AdGuard has been present on the market of personal data protection and ad blocking and developing its line of software for more than 12 years. Over this time, our company has built an impeccable reputation, and the number of our customers has exceeded 30 million. ### Unique VPN protocol -The main difference between AdGuard VPN and its competitors is that we use [our own developed protocol](/general/adguard-vpn-protocol.mdx). It disguises itself as normal traffic, so it is much more difficult to track and block it. + +The main difference between AdGuard VPN and its competitors is that we use [our own developed protocol](/general/adguard-vpn-protocol). It disguises itself as normal traffic, so it is much more difficult to track and block it. ### No-logging policy No-logging policy means that we don’t collect, store, or transfer users’ personal data to third parties. [Read AdGuard VPN Privacy policy](https://adguard-vpn.com/privacy.html) ### Tracking protection + Web traffic from any user may be of interest and is particularly valuable in terms of monetization of personal data. Both criminals and unscrupulous ISPs can access it. However, with a trustworthy VPN, you can be confident that neither your provider nor anyone else will see your internet activity. ### Ultra-fast VPN servers in 53 countries diff --git a/docs/miscellaneous/update-kb.md b/docs/miscellaneous/update-kb.md index 65d138096..13417af80 100644 --- a/docs/miscellaneous/update-kb.md +++ b/docs/miscellaneous/update-kb.md @@ -16,7 +16,7 @@ Once you are ready to start, work in [the KnowledgeBaseVPN repository](https://g The Knowledge Base website is built using Docusaurus 2 — a modern static website generator. When suggesting changes or additions, take into account that all documents must comply with the principles of the platform. You can read about them in [the guide available via this link](https://docusaurus.io/docs/category/guides). -You can deploy this Knowledge Base locally to your computer to preview the changes you suggest. Detailed instructions on how to do this can be found [in the README.md file](https://github.com/AdguardTeam/KnowledgeBaseVPN/blob/main/README.md) on this Knowledge Base's GitHub page. +You can deploy this Knowledge Base locally to your computer to preview the changes you suggest. Detailed instructions on how to do this can be found [in the README.md file](https://github.com/AdguardTeam/KnowledgeBaseVPN/blob/main/README) on this Knowledge Base's GitHub page. ## Translating articles {#translate-adguard} From 85e4d2d18452c620580ca61ce4dcef2d62c16d12 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Tue, 12 Sep 2023 20:51:48 +0300 Subject: [PATCH 7/9] Fix markdown --- docs/adguard-vpn-browser-extension/overview.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/adguard-vpn-browser-extension/overview.md b/docs/adguard-vpn-browser-extension/overview.md index d4c5125f8..8ca302b3a 100644 --- a/docs/adguard-vpn-browser-extension/overview.md +++ b/docs/adguard-vpn-browser-extension/overview.md @@ -3,11 +3,15 @@ title: Features overview sidebar_position: 1 --- -AdGuard VPN Browser extension is available for Chrome, Firefox, Opera, and Edge. The UI and functionality doesn't differ between browsers so the overview below will be relevant for AdGuard VPN extensions for all browsers. +AdGuard VPN Browser Extension is available for Chrome, Firefox, Opera, and Edge. The UI and functionality doesn't differ between browsers so the overview below will be relevant for AdGuard VPN extensions for all browsers. -> Note that you can only use AdGuard VPN Browser extension when logged in. Sign in with your AdGuard account or via Google, Facebook, or Apple. In the latter case make sure that your account is bound to the same email address as your AdGuard account. If you have an [AdGuard VPN subscription](/general/subscription), it will be activated automatically in AdGuard VPN Browser extension. Don’t have an AdGuard account yet? [Create it here](https://auth.adguard.com/registration.html). +:::note -To manage your AdGuard VPN Browser extension: +Note that you can only use AdGuard VPN Browser Extension when logged in. Sign in with your AdGuard account or via Google, Facebook, or Apple. In the latter case make sure that your account is bound to the same email address as your AdGuard account. If you have an [AdGuard VPN subscription](/general/subscription), it will be activated automatically in AdGuard VPN Browser extension. Don’t have an AdGuard account yet? [Create it here](https://auth.adguard.com/registration.html). + +::: + +To manage your AdGuard VPN Browser Extension: - Either click its icon on the browser's panel, click the hamburger menu icon, and select *Settings*, - Or go to the *Manage extensions* page in your browser, click *Details* below *AdGuard VPN* and manage its settings from there. @@ -37,9 +41,9 @@ When adding a website to the exclusions list, you can enter the website manually Not only can you add and remove websites, you can also transfer ready exclusions lists to other devices where AdGuard VPN is installed. To export your exclusions list, follow the 4-step instruction below: 1. Open AdGuard VPN Browser extension from where you want to export your lists of exclusions. Find the appropriate section and click the "Export" button. The `exclusions.zip` archive will be downloaded. -2. There are two `.txt` files inside the archive, one for each of the General and Selective lists. Add more exclusions to them, delete the existing ones, rename files, or just leave the archive as it is. -3. When transferring between different devices, send the `.zip` file to the device for import. -4. Open AdGuard VPN on that device. Find the appropriate section, click the "Import" button and select the archive. +1. There are two `.txt` files inside the archive, one for each of the General and Selective lists. Add more exclusions to them, delete the existing ones, rename files, or just leave the archive as it is. +1. When transferring between different devices, send the `.zip` file to the device for import. +1. Open AdGuard VPN on that device. Find the appropriate section, click the "Import" button and select the archive. Done! ## Account From be5fc89275b26e1f9f262950643fcaf6477de2b4 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Tue, 12 Sep 2023 20:52:39 +0300 Subject: [PATCH 8/9] =?UTF-8?q?extension=20=E2=86=92=20Extension?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/general/how-to-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/general/how-to-install.md b/docs/general/how-to-install.md index 096071698..5cf03dff7 100644 --- a/docs/general/how-to-install.md +++ b/docs/general/how-to-install.md @@ -9,4 +9,4 @@ Depending on which AdGuard VPN app or browser extension you want to install, fol - [AdGuard VPN for iOS](/adguard-vpn-for-ios/installation) - [AdGuard VPN for Windows](/adguard-vpn-for-windows/installation) - [AdGuard VPN for Mac](/adguard-vpn-for-mac/installation) -- [AdGuard VPN Browser extension](/adguard-vpn-browser-extension/installation) +- [AdGuard VPN Browser Extension](/adguard-vpn-browser-extension/installation) From b7b5f21eb121d9b19f121600d24a512fc472cbc0 Mon Sep 17 00:00:00 2001 From: ss-orlova <95080242+ss-orlova@users.noreply.github.com> Date: Tue, 12 Sep 2023 20:55:30 +0300 Subject: [PATCH 9/9] Fix markdown --- .../adguard-vpn-browser-extension/overview.md | 2 +- docs/general/why-adguard-vpn.md | 20 +++++++++++++++---- 2 files changed, 17 insertions(+), 5 deletions(-) diff --git a/docs/adguard-vpn-browser-extension/overview.md b/docs/adguard-vpn-browser-extension/overview.md index 8ca302b3a..9ea7eaefc 100644 --- a/docs/adguard-vpn-browser-extension/overview.md +++ b/docs/adguard-vpn-browser-extension/overview.md @@ -7,7 +7,7 @@ AdGuard VPN Browser Extension is available for Chrome, Firefox, Opera, and Edge. :::note -Note that you can only use AdGuard VPN Browser Extension when logged in. Sign in with your AdGuard account or via Google, Facebook, or Apple. In the latter case make sure that your account is bound to the same email address as your AdGuard account. If you have an [AdGuard VPN subscription](/general/subscription), it will be activated automatically in AdGuard VPN Browser extension. Don’t have an AdGuard account yet? [Create it here](https://auth.adguard.com/registration.html). +You can only use AdGuard VPN Browser Extension when logged in. Sign in with your AdGuard account or via Google, Facebook, or Apple. In the latter case make sure that your account is bound to the same email address as your AdGuard account. If you have an [AdGuard VPN subscription](/general/subscription), it will be activated automatically in AdGuard VPN Browser extension. Don’t have an AdGuard account yet? [Create it here](https://auth.adguard.com/registration.html). ::: diff --git a/docs/general/why-adguard-vpn.md b/docs/general/why-adguard-vpn.md index 52d8a93a6..fee4f872c 100644 --- a/docs/general/why-adguard-vpn.md +++ b/docs/general/why-adguard-vpn.md @@ -37,7 +37,11 @@ We recommend using an AdGuard DNS server: it blocks ads and trackers and protect Another feature that makes AdGuard VPN stand out from the crowd is that you can select a location based on its ping. In a nutshell, ping is the time it takes the data packet sent from your device to reach the server and return. When in doubt, use a rule of thumb: the lower the ping, the closer the server, the higher its speed. We are constantly expanding the number of locations so that you can choose from a variety. -> Note that to access all VPN server locations, you need to purchase an AdGuard VPN subscription. +:::note + +To access all VPN server locations, you need to purchase an AdGuard VPN subscription. + +::: ## 5. Integration with AdGuard Ad Blocker @@ -53,7 +57,11 @@ However, we managed to find a solution to befriend AdGuard VPN and AdGuard Ad Bl [QUIC](https://adguard-dns.io/en/blog/dns-over-quic.html#whatisquic) is a cutting-edge protocol that has many perks. The main advantage is it can improve the connection quality in non-ideal conditions – for example, on mobile devices or when connecting to public Wi-Fi. Although the new protocol won’t affect speed when the connection is fine and stable, it will definitely make the situation better for users with slow Internet. -> The QUIC protocol is rather new and may be unstable. We cannot guarantee its complete reliability for every case. +:::caution + +The QUIC protocol is rather new and may be unstable. We cannot guarantee its complete reliability for every case. + +::: *Now let’s switch to the item set that any decent VPN can't do without.* @@ -67,7 +75,11 @@ If for some reason your VPN connection is interrupted, Kill Switch will automati This feature has been developed specifically for unsecured networks. If you enable Auto-protection, you won't ever forget to enable VPN when visiting public places. Should you pop into a coffee shop and connect to a local Wi-Fi network, you’ll be automatically connected to AdGuard VPN. -> Auto-protection is available in AdGuard VPN for iOS and Android. +:::note Compatibility + +Auto-protection is available in AdGuard VPN for iOS and Android. + +::: ## 9. Ten simultaneous connections @@ -83,7 +95,7 @@ Streaming services don't like VPNs for obvious reasons: according to statistics, But what if you want to feel safe while watch content specific to your region? Or don't want stop watching exciting series even when you travel to another country? The answer is simple — AdGuard VPN, which thanks to its unique protocol can remain invisible to services. -> We don't endorse the use of AdGuard VPN to bypass copyright regulations. +We don't endorse the use of AdGuard VPN to bypass copyright regulations. ## 11. Dark mode