amnezia-vpn · diff
git:20260919.c5defa2 to git:20261013.df0a08f
35 added, 33 removed. Audit A to A.
---
name: amnezia-vpn
- description: "Amnezia VPN и AmneziaWG на Linux/VPS/Docker, не OpenWrt: handshake, awg show, amneziawg-go, kernel module, Jc/H1, /opt/amnezia, Ubuntu VPS, UDP. Триггеры: amneziawg, awg-quick, amneziawg-go, amnezia docker, VPS VPN, handshake."
+ description: "Amnezia VPN and AmneziaWG on Linux/VPS/Docker, not OpenWrt: handshake, awg show, amneziawg-go, kernel module, Jc/H1, /opt/amnezia, Ubuntu VPS, UDP. Triggers: amneziawg, awg-quick, amneziawg-go, amnezia docker, VPS VPN, handshake, впн, амнезия, сервер VPN, рукопожатие."
---
# Amnezia VPN (Linux / Docker)
- Skill про Amnezia на Linux-сервере и Docker-стеке приложения.
- Это не OpenWrt-интеграция: UCI/LuCI/`kmod-amneziawg` на роутере —
+ Skill for Amnezia on a Linux server and in an application Docker stack.
+ This is not the OpenWrt integration: UCI/LuCI/`kmod-amneziawg` on a router is
`amneziawg-openwrt-guide`.
- Селективный routing на OpenWrt через podkop — `podkop-openwrt-guide`.
- Policy routing на Linux-хосте — `linux-routing`.
+ Selective routing on OpenWrt via podkop is `podkop-openwrt-guide`.
+ Policy routing on a Linux host is `linux-routing`.
- ## Когда использовать
+ ## When to use
- - Поднять или чинить AmneziaVPN на VPS (официальный Docker-стек).
- - Linux AWG без GUI: `awg`, `awg-quick`, kernel module vs `amneziawg-go`.
- - Нет handshake, неверный Jc/Jmin/Jmax/S1/S2/H1-H4, порт закрыт.
- - Контейнеры `amnezia-*`, данные `/opt/amnezia`, docker logs.
- - Соседние протоколы стека: WireGuard, Xray/Reality, OpenVPN, Cloak, SS —
- только в контексте Amnezia, не как отдельный продукт.
+ - Bring up or fix AmneziaVPN on a VPS (the official Docker stack).
+ - Linux AWG without a GUI: `awg`, `awg-quick`, kernel module vs `amneziawg-go`.
+ - No handshake, wrong Jc/Jmin/Jmax/S1/S2/H1-H4, port closed.
+ - `amnezia-*` containers, `/opt/amnezia` data, docker logs.
+ - Neighbouring protocols of the stack: WireGuard, Xray/Reality, OpenVPN, Cloak, SS —
+ only in the Amnezia context, not as separate products.
## Workflow
- 1. Раздели сценарий:
- - GUI AmneziaVPN → Docker-контейнеры на VPS.
- - Голый AWG → `awg0` + `awg-quick` / kernel module.
- - OpenWrt роутер → другой skill.
- 2. Не логируй PrivateKey, preshared key, obfuscation secrets целиком.
- В ответах — плейсхолдеры.
- 3. Handshake = ключи + одинаковые obfuscation params + UDP порт + endpoint.
- 4. После изменений: `awg show` / `docker ps` / `ss -ulnp` / ping внутри туннеля.
+ 1. Split the scenario:
+ - AmneziaVPN GUI → Docker containers on a VPS.
+ - Bare AWG → `awg0` + `awg-quick` / kernel module.
+ - OpenWrt router → a different skill.
+ 2. Never log the PrivateKey, preshared key or obfuscation secrets in full.
+ Use placeholders in answers.
+ 3. Handshake = keys + identical obfuscation params + UDP port + endpoint.
+ 4. After changes: `awg show` / `docker ps` / `ss -ulnp` / ping inside the tunnel.
- ## Что есть в стеке
+ ## What is in the stack
- Официальное приложение поднимает Docker на сервере. Данные обычно в
- `/opt/amnezia`. Контейнеры именуются с префиксом `amnezia-`.
+ The official app deploys Docker on the server. Data usually lives in
+ `/opt/amnezia`. Containers are prefixed with `amnezia-`.
- Голый AmneziaWG совместим с WireGuard по модели ключей, но пакеты не
- пройдут, если junk/header params не совпали на обеих сторонах.
+ Bare AmneziaWG is compatible with WireGuard's key model, but packets will not
+ pass if the junk/header params differ between the two sides.
- | Слой | Зачем |
+ | Layer | Purpose |
|------|--------|
- | `kmod amneziawg` | kernel datapath, низкий overhead |
- | `amneziawg-go` | userspace fallback, если модуля нет |
- | `awg` / `awg-quick` | как `wg` / `wg-quick` |
+ | `kmod amneziawg` | kernel datapath, low overhead |
+ | `amneziawg-go` | userspace fallback when the module is missing |
+ | `awg` / `awg-quick` | like `wg` / `wg-quick` |
## Companion skills
- OpenWrt AWG → `amneziawg-openwrt-guide`.
- - Docker engine/compose синтаксис → `docker-ops`.
- - `ip rule`/nft для split-tunnel на Linux → `linux-routing`.
+ - Docker engine/compose syntax → `docker-ops`.
+ - `ip rule`/nft for split-tunnel on Linux → `linux-routing`.
- Host systemd/disk/ssh → `administering-linux`.
## References
- - `references/linux-awg.md` — awg-quick, kernel/userspace, диагностика.
- - `references/docker-stack.md` — контейнеры AmneziaVPN на VPS.
+ - `references/linux-awg.md` — awg-quick, kernel/userspace, diagnostics.
+ - `references/docker-stack.md` — AmneziaVPN containers on a VPS.
<!-- A-EVOLVE-ROUTING-SIGNALS:START -->
## Routing signals: amnezia amneziavpn amneziawg awg-quick awg0 opt/amnezia docker vpn jc jmin jmax handshake amneziawg-go vps
<!-- A-EVOLVE-ROUTING-SIGNALS:END -->
+
+ Russian version: [`references/README.ru.md`](references/README.ru.md).