Skip to content

Commit f493980

Browse files
hwdsl2hwdsl2
committed
Update docs
1 parent cedc537 commit f493980

4 files changed

Lines changed: 228 additions & 200 deletions

File tree

‎README-ru.md‎

Lines changed: 57 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,28 @@ Docker-образ для запуска сервера IPsec VPN с поддер
1010

1111
IPsec VPN шифрует сетевой трафик, поэтому никто между вами и VPN-сервером не сможет перехватывать ваши данные во время их передачи через Интернет. Это особенно полезно при использовании незащищённых сетей, например в кофейнях, аэропортах или гостиничных номерах.
1212

13+
**Возможности:**
14+
15+
- Автоматическая генерация учётных данных VPN и конфигурации IKEv2 при первом запуске
16+
- Поддержка IKEv2 с мощными и быстрыми шифрами (например, AES-GCM)
17+
- Генерация VPN-профилей для автоматической настройки устройств iOS, macOS и Android
18+
- Поддержка Windows, macOS, iOS, Android, Chrome OS и Linux в качестве VPN-клиентов
19+
- Включает вспомогательный скрипт для управления пользователями и сертификатами IKEv2
20+
- Автоматически собирается и публикуется через [GitHub Actions](https://github.com/hwdsl2/docker-ipsec-vpn-server/actions/workflows/main-alpine.yml)
21+
- Постоянное хранение данных через Docker volume
22+
- Поддержка нескольких архитектур: `linux/amd64`, `linux/arm64`, `linux/arm/v7`
23+
1324
**Также доступно:**
25+
1426
- VPN: [WireGuard](https://github.com/hwdsl2/docker-wireguard/blob/main/README-ru.md), [OpenVPN](https://github.com/hwdsl2/docker-openvpn/blob/main/README-ru.md), [Headscale](https://github.com/hwdsl2/docker-headscale/blob/main/README-ru.md)
1527
- ИИ/Аудио: [Whisper (STT)](https://github.com/hwdsl2/docker-whisper/blob/main/README-ru.md), [Kokoro (TTS)](https://github.com/hwdsl2/docker-kokoro/blob/main/README-ru.md), [Embeddings](https://github.com/hwdsl2/docker-embeddings/blob/main/README-ru.md), [LiteLLM](https://github.com/hwdsl2/docker-litellm/blob/main/README-ru.md)
16-
17-
**[» :book: Книга: Privacy Tools in the Age of AI](docs/vpn-book.md)  [Build Your Own VPN Server](docs/vpn-book.md)**
28+
- :book: Книга: [Privacy Tools in the Age of AI](docs/vpn-book.md), [Build Your Own VPN Server](docs/vpn-book.md)
1829

1930
## Быстрый старт
2031

2132
Используйте эту команду для настройки сервера IPsec VPN в Docker:
2233

23-
```
34+
```bash
2435
docker run \
2536
--name ipsec-vpn-server \
2637
--restart=always \
@@ -36,30 +47,26 @@ docker run \
3647

3748
В качестве альтернативы вы можете [настроить IPsec VPN без Docker](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/README-ru.md). Чтобы узнать больше о том, как использовать этот образ, прочитайте разделы ниже.
3849

39-
## Возможности
40-
41-
- Поддержка IKEv2 с мощными и быстрыми шифрами (например, AES-GCM)
42-
- Генерация VPN-профилей для автоматической настройки устройств iOS, macOS и Android
43-
- Поддержка Windows, macOS, iOS, Android, Chrome OS и Linux в качестве VPN-клиентов
44-
- Включает вспомогательный скрипт для управления пользователями и сертификатами IKEv2
45-
46-
## Установка Docker
50+
## Требования
4751

48-
Сначала [установите Docker](https://docs.docker.com/engine/install/) на ваш Linux-сервер. Вы также можете использовать [Podman](https://podman.io) для запуска этого образа после [создания псевдонима](https://podman.io/whatis.html) для `docker`.
52+
- Linux-сервер с публичным IP-адресом или DNS-именем
53+
- Установленный Docker
54+
- Открытые VPN-порты в брандмауэре (UDP 500 и 4500)
55+
- Вы также можете использовать [Podman](https://docs.podman.io) для запуска этого образа после создания псевдонима для `docker`
4956

50-
Продвинутые пользователи могут использовать этот образ на macOS с помощью [Docker for Mac](https://docs.docker.com/docker-for-mac/). Перед использованием режима IPsec/L2TP может потребоваться один раз перезапустить контейнер Docker с помощью `docker restart ipsec-vpn-server`. Этот образ не поддерживает Docker for Windows.
57+
**Примечание:** Продвинутые пользователи могут использовать этот образ на macOS с помощью [Docker for Mac](https://docs.docker.com/desktop/setup/install/mac-install/). Перед использованием режима IPsec/L2TP может потребоваться один раз перезапустить контейнер с помощью `docker restart ipsec-vpn-server`. Этот образ не поддерживает Docker for Windows.
5158

5259
## Загрузка
5360

5461
Получите доверенную сборку из [реестра Docker Hub](https://hub.docker.com/r/hwdsl2/ipsec-vpn-server/):
5562

56-
```
63+
```bash
5764
docker pull hwdsl2/ipsec-vpn-server
5865
```
5966

6067
В качестве альтернативы можно скачать из [Quay.io](https://quay.io/repository/hwdsl2/ipsec-vpn-server):
6168

62-
```
69+
```bash
6370
docker pull quay.io/hwdsl2/ipsec-vpn-server
6471
docker image tag quay.io/hwdsl2/ipsec-vpn-server hwdsl2/ipsec-vpn-server
6572
```
@@ -92,7 +99,7 @@ docker image tag quay.io/hwdsl2/ipsec-vpn-server hwdsl2/ipsec-vpn-server
9299

93100
Обычно рекомендуется использовать последнюю версию [Libreswan](https://libreswan.org/) 5, которая является версией по умолчанию в этом проекте. Однако если вы хотите использовать более старую версию Libreswan 4, вы можете собрать Docker-образ из исходного кода:
94101

95-
```
102+
```bash
96103
git clone https://github.com/hwdsl2/docker-ipsec-vpn-server
97104
cd docker-ipsec-vpn-server
98105
# Указать версию Libreswan 4
@@ -176,7 +183,7 @@ VPN_PROTECT_CONFIG=yes
176183

177184
Создайте новый Docker-контейнер из этого образа (замените `./vpn.env` на ваш собственный файл `env`):
178185

179-
```
186+
```bash
180187
docker run \
181188
--name ipsec-vpn-server \
182189
--env-file ./vpn.env \
@@ -199,7 +206,7 @@ docker run \
199206

200207
Если вы не указали файл `env` в команде `docker run` выше, значение `VPN_USER` по умолчанию будет `vpnuser`, а `VPN_IPSEC_PSK` и `VPN_PASSWORD` будут сгенерированы случайным образом. Чтобы получить их, просмотрите журналы контейнера:
201208

202-
```
209+
```bash
203210
docker logs ipsec-vpn-server
204211
```
205212

@@ -218,38 +225,10 @@ Password: your_vpn_password
218225

219226
(Необязательно) Сохраните сгенерированные данные для входа в VPN (если они есть) в текущий каталог:
220227

221-
```
228+
```bash
222229
docker cp ipsec-vpn-server:/etc/ipsec.d/vpn-gen.env ./
223230
```
224231

225-
## Следующие шаги
226-
227-
*Прочитать на других языках: [English](README.md#next-steps), [简体中文](README-zh.md#下一步), [繁體中文](README-zh-Hant.md#下一步), [Русский](README-ru.md#следующие-шаги).*
228-
229-
Настройте ваш компьютер или устройство для использования VPN. Пожалуйста, обратитесь к следующим инструкциям (на английском языке):
230-
231-
**[Настройка и использование IKEv2 VPN (рекомендуется)](#настройка-и-использование-ikev2-vpn)**
232-
233-
**[Настройка клиентов IPsec/L2TP VPN](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients.md)**
234-
235-
**[Настройка клиентов IPsec/XAuth («Cisco IPsec»)](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients-xauth.md)**
236-
237-
**Прочитайте [:book: книгу о VPN](docs/vpn-book.md), чтобы получить доступ к [дополнительному контенту](https://ko-fi.com/post/Support-this-project-and-get-access-to-supporter-o-O5O7FVF8J).**
238-
239-
Наслаждайтесь собственным VPN! :sparkles::tada::rocket::sparkles:
240-
241-
## Важные замечания
242-
243-
**Пользователи Windows**: для режима IPsec/L2TP требуется [одноразовое изменение реестра](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients.md#windows-error-809), если VPN-сервер или клиент находится за NAT (например, домашним роутером).
244-
245-
Одна и та же учетная запись VPN может использоваться на нескольких ваших устройствах. Однако из-за ограничения IPsec/L2TP, если вы хотите подключить несколько устройств из-за одного NAT (например, домашнего роутера), необходимо использовать режим [IKEv2](#настройка-и-использование-ikev2-vpn) или [IPsec/XAuth](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients-xauth.md).
246-
247-
Если вы хотите добавить, изменить или удалить учетные записи пользователей VPN, сначала обновите файл `env`, затем удалите и заново создайте Docker-контейнер, следуя инструкциям из [следующего раздела](#обновление-docker-образа). Продвинутые пользователи могут использовать [bind mount](docs/advanced-usage.md#bind-mount-the-env-file) для файла `env`.
248-
249-
Для серверов с внешним файрволом (например, [EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html)/[GCE](https://cloud.google.com/vpc/docs/firewalls)) откройте UDP-порты 500 и 4500 для VPN. Пользователям Aliyun см. [#433](https://github.com/hwdsl2/setup-ipsec-vpn/issues/433).
250-
251-
Клиенты настроены использовать [Google Public DNS](https://developers.google.com/speed/public-dns/) при активном VPN. Если вы предпочитаете другого DNS-провайдера, прочитайте [этот раздел](docs/advanced-usage.md#use-alternative-dns-servers).
252-
253232
## Использование docker-compose
254233

255234
```bash
@@ -282,11 +261,39 @@ services:
282261
- /lib/modules:/lib/modules:ro
283262
```
284263
264+
## Следующие шаги
265+
266+
*Прочитать на других языках: [English](README.md#next-steps), [简体中文](README-zh.md#下一步), [繁體中文](README-zh-Hant.md#下一步), [Русский](README-ru.md#следующие-шаги).*
267+
268+
Настройте ваш компьютер или устройство для использования VPN. Пожалуйста, обратитесь к следующим инструкциям (на английском языке):
269+
270+
**[Настройка и использование IKEv2 VPN (рекомендуется)](#настройка-и-использование-ikev2-vpn)**
271+
272+
**[Настройка клиентов IPsec/L2TP VPN](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients.md)**
273+
274+
**[Настройка клиентов IPsec/XAuth («Cisco IPsec»)](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients-xauth.md)**
275+
276+
**Прочитайте [:book: книгу о VPN](docs/vpn-book.md), чтобы получить доступ к [дополнительному контенту](https://ko-fi.com/post/Support-this-project-and-get-access-to-supporter-o-O5O7FVF8J).**
277+
278+
Наслаждайтесь собственным VPN! :sparkles::tada::rocket::sparkles:
279+
280+
## Важные замечания
281+
282+
**Пользователи Windows**: для режима IPsec/L2TP требуется [одноразовое изменение реестра](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients.md#windows-error-809), если VPN-сервер или клиент находится за NAT (например, домашним роутером).
283+
284+
Одна и та же учетная запись VPN может использоваться на нескольких ваших устройствах. Однако из-за ограничения IPsec/L2TP, если вы хотите подключить несколько устройств из-за одного NAT (например, домашнего роутера), необходимо использовать режим [IKEv2](#настройка-и-использование-ikev2-vpn) или [IPsec/XAuth](https://github.com/hwdsl2/setup-ipsec-vpn/blob/master/docs/clients-xauth.md).
285+
286+
Если вы хотите добавить, изменить или удалить учетные записи пользователей VPN, сначала обновите файл `env`, затем удалите и заново создайте Docker-контейнер, следуя инструкциям из [следующего раздела](#обновление-docker-образа). Продвинутые пользователи могут использовать [bind mount](docs/advanced-usage.md#bind-mount-the-env-file) для файла `env`.
287+
288+
Для серверов с внешним файрволом (например, [EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-security-groups.html)/[GCE](https://cloud.google.com/vpc/docs/firewalls)) откройте UDP-порты 500 и 4500 для VPN. Пользователям Aliyun см. [#433](https://github.com/hwdsl2/setup-ipsec-vpn/issues/433).
289+
290+
Клиенты настроены использовать [Google Public DNS](https://developers.google.com/speed/public-dns/) при активном VPN. Если вы предпочитаете другого DNS-провайдера, прочитайте [этот раздел](docs/advanced-usage.md#use-alternative-dns-servers).
291+
285292
## Обновление Docker-образа
286293

287294
Чтобы обновить Docker-образ и контейнер, сначала [загрузите](#загрузка) последнюю версию:
288295

289-
```
296+
```bash
290297
docker pull hwdsl2/ipsec-vpn-server
291298
```
292299

@@ -312,7 +319,7 @@ docker logs ipsec-vpn-server
312319

313320
Во время настройки IKEv2 создаётся клиент IKEv2 (с именем по умолчанию `vpnclient`), а его конфигурация экспортируется в `/etc/ipsec.d` **внутри контейнера**. Чтобы скопировать файл(ы) конфигурации на Docker-хост:
314321

315-
```
322+
```bash
316323
# Проверить содержимое /etc/ipsec.d в контейнере
317324
docker exec -it ipsec-vpn-server ls -l /etc/ipsec.d
318325
# Пример: копирование файла конфигурации клиента из контейнера
@@ -379,7 +386,7 @@ docker exec -it ipsec-vpn-server ikev2.sh
379386

380387
## Расширенное использование
381388

382-
См. [Расширенное использование](docs/advanced-usage.md) (на английском языке).
389+
См. [Расширенное использование (на английском)](docs/advanced-usage.md).
383390

384391
- [Использование альтернативных DNS-серверов](docs/advanced-usage.md#use-alternative-dns-servers)
385392
- [Запуск без привилегированного режима](docs/advanced-usage.md#run-without-privileged-mode)

0 commit comments

Comments
 (0)