Skip to content

Commit a8c549c

Browse files
authored
Merge pull request #334 from AdguardTeam/update-translations
Update translations
2 parents c2af75b + 6f6e5e9 commit a8c549c

105 files changed

Lines changed: 7707 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

i18n/cs/docusaurus-plugin-content-docs/current/adguard-vpn-for-linux/installation.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,10 @@ Stisknutím `y` odsouhlasíte propojení binárního souboru s `/usr/local/bin`
3333
Podpis můžete ověřit pomocí nástroje `gpg`, abyste prokázali, že se jedná o oficiální verzi AdGuard VPN. [Více na GitHubu](https://github.com/AdguardTeam/AdGuardVPNCLI?tab=readme-ov-file#verify-releases)
3434
:::
3535

36+
:::note
37+
You can also install and run the AdGuard VPN for Linux Docker container on MikroTik routers with RouterOS. For more information and detailed instructions, refer to [our dedicated guide](/adguard-vpn-for-linux/setting-up-on-a-router/mikrotik/).
38+
:::
39+
3640
## Odinstalace AdGuard VPN pro Linux
3741

3842
Chcete-li odinstalovat AdGuard VPN, zadejte:
Lines changed: 349 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,349 @@
1+
---
2+
title: How to install AdGuard VPN CLI on MikroTik RouterOS
3+
sidebar_position: 5
4+
---
5+
6+
:::info System requirements
7+
8+
- RouterOS 7.6+ with Container feature and start-on-boot support
9+
- SSH access to the router
10+
11+
:::info
12+
13+
This guide explains how to install and run the AdGuard VPN CLI Docker container on MikroTik routers running RouterOS.
14+
15+
These settings have been tested on RouterOS 7.22. It is recommended to use the latest stable version of RouterOS for better compatibility.
16+
17+
## RouterOS Configuration
18+
19+
### 1. Connect to the router via SSH
20+
21+
```bash
22+
ssh admin@192.168.1.1
23+
```
24+
25+
:::note
26+
27+
Replace the IP with your router's address
28+
29+
:::
30+
31+
### 2. Check if the container package is installed
32+
33+
```bash
34+
/system/package/print
35+
```
36+
37+
Find the `container` package in the list. If it's not there, install it:
38+
39+
#### Installing container package
40+
41+
1. Download the `.npk` file for your architecture and OS version from [the official website](https://mikrotik.com/download)
42+
43+
2. Upload the `.npk` file to the router:
44+
45+
```bash
46+
scp container-7.X-platform.npk admin@192.168.1.1:
47+
```
48+
49+
Replace the IP with your router's address.
50+
51+
3. Verify the file is uploaded:
52+
53+
```bash
54+
/file/print
55+
```
56+
57+
You should see the `container-X.XX.npk` file.
58+
59+
4. Reboot the router:
60+
61+
```bash
62+
/system/reboot
63+
```
64+
65+
After reboot, the `.npk` file will disappear. This is expected, it means the package was succesfully installed.
66+
67+
5. Verify:
68+
69+
```bash
70+
/system/package/print
71+
```
72+
73+
The `container` package should appear in the list.
74+
75+
### 3) Enable Container mode
76+
77+
Enable Container mode and follow the instructions the command gives you. You will need to confirm the device-mode change by performing a cold reboot (physically unplugging and replugging the power).
78+
79+
```bash
80+
/system/device-mode/update container=yes
81+
```
82+
83+
:::warning
84+
85+
Do not close the terminal or interrupt the command before unplugging the power — this will cancel the operation.
86+
87+
:::
88+
89+
### 4. Verify that container mode is active
90+
91+
```bash
92+
/system/device-mode/print
93+
```
94+
95+
Should show `container: yes`
96+
97+
### 5. Set up networking for the container
98+
99+
#### How it works
100+
101+
In this setup:
102+
103+
- The container acts as a VPN gateway
104+
- RouterOS routes selected traffic through a separate routing table (`via_vpn`)
105+
- Traffic is forwarded to the container and then tunneled via AdGuard VPN
106+
107+
Flow:
108+
109+
LAN → RouterOS → Routing rule → Container → VPN → Internet
110+
111+
:::warning
112+
113+
This setup routes all LAN traffic through the VPN container.
114+
If misconfigured, it may disrupt network connectivity or cause loss of internet access.
115+
116+
:::
117+
118+
Create a veth interface:
119+
120+
```bash
121+
/interface/veth/add name=veth1 address=172.17.0.2/24 gateway=172.17.0.1
122+
```
123+
124+
Create a bridge:
125+
126+
```bash
127+
/interface/bridge/add name=docker
128+
```
129+
130+
Add veth to bridge:
131+
132+
```bash
133+
/interface/bridge/port/add bridge=docker interface=veth1
134+
```
135+
136+
Assign an IP address to the bridge:
137+
138+
```bash
139+
/ip/address/add address=172.17.0.1/24 interface=docker
140+
```
141+
142+
Configure NAT for container internet access:
143+
144+
```bash
145+
/ip/firewall/nat/add chain=srcnat src-address=172.17.0.0/24 out-interface=ether1 action=masquerade
146+
```
147+
148+
:::note
149+
150+
Replace `ether1` with the name of your WAN interface (e.g. `ether3`, `ether5`). To find it:
151+
152+
1. Run `/ip/route/print` and find the default route (`0.0.0.0/0`, routing-table=main) — note its gateway IP
153+
2. In the same output, find the connected route (`DAc`) that covers that gateway IP — the interface listed there is your WAN interface
154+
155+
:::
156+
157+
Create routing table for VPN
158+
159+
```bash
160+
/routing/table/add name=via_vpn fib
161+
```
162+
163+
Add a default route via the container
164+
165+
```bash
166+
/ip/route/add dst-address=0.0.0.0/0 gateway=172.17.0.2@main routing-table=via_vpn distance=1 check-gateway=ping
167+
```
168+
169+
Add a routing rule
170+
171+
```bash
172+
/routing/rule/add src-address=192.168.88.0/24 action=lookup table=via_vpn
173+
```
174+
175+
:::note
176+
177+
Replace the IP with your LAN network address
178+
179+
:::
180+
181+
Set DNS servers for LAN clients to a public DNS
182+
183+
```bash
184+
/ip/dhcp-server/network/set [find address="192.168.88.0/24"] dns-server=1.1.1.1,8.8.8.8
185+
```
186+
187+
## Running the Container
188+
189+
### Pull image directly from Docker Hub
190+
191+
#### 1. Configure Container registry
192+
193+
Set Docker Hub URL and temporary directory for image extraction
194+
195+
```bash
196+
/container/config/set registry-url=https://registry-1.docker.io tmpdir=disk1/tmp
197+
```
198+
199+
:::note
200+
201+
Replace `disk1` with the name of the specific disk you want to work with, selecting it from the list shown in the `/disk/print` output.
202+
This also applies to the next command.
203+
204+
:::
205+
206+
#### 2. Add the container and pull the image
207+
208+
```bash
209+
/container/add name=adguardvpn-cli remote-image=adguard/adguardvpn-cli:latest interface=veth1 root-dir=disk1/adguardvpn-cli start-on-boot=yes logging=yes
210+
```
211+
212+
**Available tags:**
213+
214+
- `adguard/adguardvpn-cli:latest` - latest stable version
215+
- `adguard/adguardvpn-cli:nightly` - latest nightly build
216+
- `adguard/adguardvpn-cli:beta` - latest beta version
217+
- `adguard/adguardvpn-cli:1.7.6-nightly` - specific version
218+
219+
**Parameters:**
220+
221+
- `name=adguardvpn-cli` - container name
222+
- `remote-image` - Docker Hub image name
223+
- `interface=veth1` - network interface for the container
224+
- `root-dir=disk1/adguardvpn-cli` - directory for container files
225+
- `start-on-boot=yes` - auto-start on router reboot
226+
- `logging=yes` - enable logging
227+
228+
#### 3. Check download status
229+
230+
```bash
231+
/container/print
232+
```
233+
234+
The image will be automatically downloaded and extracted. Wait for the download to complete (status will change to `stopped`).
235+
236+
#### 4. Start the container
237+
238+
```bash
239+
/container/start adguardvpn-cli
240+
```
241+
242+
Check the container status
243+
244+
```bash
245+
/container/print
246+
```
247+
248+
The container should have the `R` (RUNNING) flag in the first column.
249+
250+
## Initial Setup and AdGuard VPN CLI Authorization
251+
252+
On first launch, the container will not be able to connect to VPN as authentication is required.
253+
254+
### 1. Open a shell inside the container
255+
256+
```bash
257+
/container/shell adguardvpn-cli
258+
```
259+
260+
### 2. Set up AdGuard VPN CLI
261+
262+
1. Log in to your account
263+
264+
To use AdGuard VPN for Linux, you need an AdGuard account.
265+
266+
You can sign up or log in on our [website](https://auth.adguardaccount.com/login.html) or in the Terminal.
267+
268+
To sign up or log in, type:
269+
270+
```bash
271+
adguardvpn-cli login
272+
```
273+
274+
Note: If failed to link the binary to `/usr/local/bin`, use full file path to run all commands. For example, `/opt/adguardvpn_cli/adguardvpn-cli login`
275+
276+
2. Connect to VPN
277+
278+
Select a VPN server location that best suits your needs.
279+
280+
In general, the closer the server is to you, the faster the connection.
281+
282+
To view available locations, type:
283+
284+
```bash
285+
adguardvpn-cli list-locations
286+
```
287+
288+
To connect to a specific location, type:
289+
290+
```bash
291+
adguardvpn-cli connect -l LOCATION_NAME
292+
```
293+
294+
Replace LOCATION_NAME with the city, country, or ISO code of the location you want to connect to.
295+
296+
For quick connect, type:
297+
298+
```bash
299+
adguardvpn-cli connect
300+
```
301+
302+
AdGuard VPN will choose the fastest location available and remember it for future quick connections.
303+
304+
3. Adjust your settings
305+
306+
Get a list of all available AdGuard VPN commands and customize the VPN client to your needs.
307+
308+
To view all commands, type:
309+
310+
```bash
311+
adguardvpn-cli --help-all
312+
```
313+
314+
AdGuard VPN CLI will create a tun0 interface for VPN tunneling.
315+
316+
### 3) Exit the shell
317+
318+
```bash
319+
exit
320+
```
321+
322+
### 4. Restart the container
323+
324+
```bash
325+
/container/stop adguardvpn-cli
326+
/container/start adguardvpn-cli
327+
```
328+
329+
After restart, the container will automatically connect to the VPN.
330+
331+
## Check that the VPN is working
332+
333+
### 1. Enter the container shell
334+
335+
```bash
336+
/container/shell adguardvpn-cli
337+
```
338+
339+
### 2. Check VPN status
340+
341+
```bash
342+
adguardvpn-cli status
343+
```
344+
345+
:::note
346+
347+
For additional information on container configuration, networking, and alternative installation methods, see the [official MikroTik Container documentation](https://help.mikrotik.com/docs/spaces/ROS/pages/84901929/Container)
348+
349+
:::

i18n/cs/docusaurus-plugin-content-docs/current/adguard-vpn-for-linux/setting-up-on-a-router/setting-up-on-a-router.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ sidebar_position: 1
55

66
Přečtěte si, jak nastavit AdGuard VPN pro Linux na routeru.
77

8+
- [Instructions for MikroTik routers](/adguard-vpn-for-linux/setting-up-on-a-router/mikrotik.md)
9+
810
- [Pokyny pro routery Keenetic](/adguard-vpn-for-linux/setting-up-on-a-router/keenetic.md)
911

1012
- [Pokyny pro routery OpenWRT](/adguard-vpn-for-linux/setting-up-on-a-router/openwrt.md)

i18n/cs/docusaurus-plugin-content-docs/current/adguard-vpn-for-routers/installation/keenetic.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,12 @@ title: Instalace na routerech Keenetic
33
sidebar_position: 3
44
---
55

6+
:::note
7+
You can also install and run the AdGuard VPN for Linux on Keenetic routers. This method requires advanced technical knowledge but provides access to all AdGuard VPN features.
8+
9+
For more information and detailed instructions, refer to [our dedicated guide](/adguard-vpn-for-linux/setting-up-on-a-router/keenetic/).
10+
:::
11+
612
AdGuard VPN můžete nakonfigurovat na routerech Keenetic od verze KeeneticOS 3.5. Postupujte podle následujících kroků:
713

814
1. Nainstalujte systémovou komponentu klienta VPN IKEv2/IPsec. Přejděte do [webového rozhraní](https://help.keenetic.com/hc/en-us/articles/360001923020-Web-interface) výrobce → _Obecná nastavení systému__Aktualizace KeeneticOS a možnosti komponent_ a klikněte na _Možnosti komponent_.

i18n/cs/docusaurus-plugin-content-docs/current/adguard-vpn-for-routers/installation/mikrotik.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,12 @@ title: Instalace na routerech MikroTik
33
sidebar_position: 2
44
---
55

6+
:::note
7+
You can also install and run the AdGuard VPN for Linux Docker container on MikroTik routers with RouterOS. This method requires advanced technical knowledge but provides access to all AdGuard VPN features.
8+
9+
For more information and detailed instructions, refer to [our dedicated guide](/adguard-vpn-for-linux/setting-up-on-a-router/mikrotik/).
10+
:::
11+
612
Chcete-li nastavit AdGuard VPN na routeru MikroTik, postupujte podle těchto kroků:
713

814
1. Otevřete terminál MikroTik. To můžete provést pomocí příkazového řádku nebo terminálu na svém počítači zadáním: `ssh admin@192.168.88.1`. Alternativně se k němu můžete dostat také prostřednictvím prohlížeče, a to tak, že navštívíte stránku `http://192.168.88.1` a kliknete na záložku Terminál v pravém horním rohu.

0 commit comments

Comments
 (0)