nordz0r/skills / amneziawg-openwrt-guide
amneziawg-openwrt-guide
VerifiedAmneziaWG on OpenWrt routers: packages kmod-amneziawg, amneziawg-tools, luci-proto-amneziawg (Slava-Shchipunov/awg-openwrt builds, AWG 1.0-3.1), opkg .ipk on 23.05/24.10 vs apk feed on 25.12, proto amneziawg UCI options (awg_jc..awg_i5, awg_header_protection_key, awg_random_trailers, awg_disable_cookies, timers), peer sections, LuCI import/QR/status, watchdog, kernel vs userspace, router-side diagnostics. Parameter meaning and optimal values live in amnezia-vpn. Triggers: amneziawg openwrt, luci-proto-amneziawg, kmod-amneziawg, proto amneziawg, uci awg, awg на роутере, амнезия роутер, cudy awg.
AmneziaWG on OpenWrt
OpenWrt-specific layer only: packages, UCI/LuCI names, router runtime and diagnostics.
What each obfuscation parameter means and which values to choose → amnezia-vpn (awg-protocol.md, awg-config.md). Do not duplicate it here.
Upstream: Slava-Shchipunov/awg-openwrt @ 03b6226 (2026-09-23, AWG 3.1). amnezia-vpn/amneziawg-openwrt is abandoned since 2024-03 (AWG 1.0 only). Verified 2026-10-15.
Workflow
- Read-only first: OpenWrt version (
/etc/openwrt_release), package manager (apk on 25.x, opkg on ≤24.10), installedkmod-amneziawg/amneziawg-tools/luci-proto-amneziawgversions →references/build-and-debug.md. - Protocol version the packages support (3.1 needs builds
v24.10.8/v25.12.5+) must be ≥ the parameters in the config. - Map the server/client config to UCI options →
references/uci-model.md; choose values withamnezia-vpn. - Diagnose: kernel vs userspace,
logread,awg showwith keys filtered, handshake →references/build-and-debug.md. - Changes to interfaces, peers, keys or packages only with explicit approval; back up
/etc/config/networkfirst.
Key facts
- Packages build from official
amnezia-vpnsources by tag; kmod must match the firmware kernel exactly. - UCI:
awg_s3/s4,awg_i1..i5(2.0/1.5+),awg_header_protection_key,awg_content_padding_addition,awg_rekey_after_time,awg_rekey_timeout,awg_reject_after_time,awg_keepalive_timeout,awg_max_handshake_attempts(3.0+),awg_random_trailers,awg_disable_cookies(3.1, boolean). - Runtime config
/tmp/amneziawg/<iface>.conf; QR vialuci-lib-uqr(noqrencode). amneziawg-install.shcan reroute all traffic into the tunnel — never run it unattended on a live router.
Safety
- Never print
private_key,preshared_key,awg_header_protection_key; filteruci show/awg show. - Install only from the upstream Releases/feed with its signing key, pinned by version.
References
references/architecture.md— which upstream is current, packages and versions, runtime.references/uci-model.md— UCI option ↔.confkey ↔ AWG version, peer sections, template.references/build-and-debug.md— opkg vs apk, update rules, read-only diagnostics, build.
Routing signals: amneziawg awg openwrt luci uci proto peer interface handshake endpoint kmod apk opkg feed qr watchdog kernel userspace router cudy
Russian version: references/README.ru.md.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |