git:20260312.7b57caf to git:20260317.0f1e07a

14 added, 1 removed. Audit A to A.

---

name: amneziawg-openwrt-guide

- description: "Полная русскоязычная справка по `amneziawg-openwrt`. Используй этот skill при любых задачах по AmneziaWG на OpenWrt: установка пакетов `amneziawg-tools`, `kmod-amneziawg`, `luci-proto-amneziawg`, настройка `proto amneziawg`, UCI/LuCI-конфигурация интерфейсов и peers, генерация ключей, QR, watchdog, сборка пакетов и отладка kernel/userspace fallback. Триггеры: amneziawg, amnezia, awg, luci-proto-amneziawg, kmod-amneziawg, amneziawg-tools, amneziawg-go, openwrt awg."

+ description: >-

+ Полная русскоязычная справка по `amneziawg-openwrt`. Используй этот skill

+ при любых задачах по AmneziaWG на OpenWrt: установка пакетов

+ `amneziawg-tools`, `kmod-amneziawg`, `luci-proto-amneziawg`, настройка

+ `proto amneziawg`, UCI/LuCI-конфигурация интерфейсов и peers, генерация

+ ключей, QR, watchdog, сборка пакетов и отладка kernel/userspace fallback.

+ Триггеры: amneziawg, amnezia, awg, luci-proto-amneziawg, kmod-amneziawg,

+ amneziawg-tools, amneziawg-go, openwrt awg.

---

# AmneziaWG OpenWrt Guide

Этот skill описывает именно интеграцию протокола AmneziaWG в OpenWrt, а не "весь Amnezia-продукт". Репозиторий содержит kernel module, userspace tools, `netifd` helper и LuCI UI.

Используй его, когда нужно понять, как поднять `proto 'amneziawg'`, как устроены peer sections, как работает fallback на userspace и где чинить LuCI/RPC часть.

## Когда использовать

- Настройка интерфейса AmneziaWG на OpenWrt.

- Разбор UCI schema или полей LuCI формы.

- Отладка handshakes, endpoint resolution, key generation, status page.

- Сборка пакетов в OpenWrt SDK/Buildroot.

- Работа с `kmod-amneziawg`, `amneziawg-tools`, `luci-proto-amneziawg`.

- Проверка, почему не загрузился kernel module и включился userspace fallback.

## Быстрый выбор workflow

- Если задача про роутер и UCI/LuCI: начни с `references/uci-model.md`.

- Если задача про устройство репозитория: открой `references/architecture.md`.

- Если задача про сборку, совместимость или диагностику: открой `references/build-and-debug.md`.

Открывай только нужный reference, потому что upstream почти не объясняет workflow словами и важные детали спрятаны в коде.

## Router Workflow

1. Уточни, нужен ли kernel mode или допустим userspace fallback.

2. Проверь, какие пакеты реально стоят на роутере: `amneziawg-tools`, `luci-proto-amneziawg`, `kmod-amneziawg`.

3. Сверь UCI-модель интерфейса и peer sections.

4. Если проблема в endpoint/динамическом DNS, проверь `persistent_keepalive` и watchdog workflow.

5. Если задача про LuCI, проверь JS форму, RPC ucode и status page вместе.

## Development Workflow

- `amneziawg-tools/` дает бинарник `awg`, `netifd` helper и watchdog.

- `kmod-amneziawg/` патчит in-tree WireGuard sources OpenWrt и потому очень чувствителен к смене kernel layout.

- `luci-proto-amneziawg/` содержит форму протокола, RPC методы, ACL и страницу статуса.

- При любых изменениях нужно держать в голове и runtime на роутере, и packaging в Buildroot.

## На что обращать внимание

- Репозиторий не поставляет "полный клиент Amnezia", а только OpenWrt integration layer.

- Userspace fallback требует `amneziawg-go`, но этот бинарник upstream-репозиторий не кладет.

- QR generation требует установленный `qrencode`.

- Изменения kernel patch легко ломаются на новых версиях OpenWrt/kernel tree.

+ ## Security Notes

+ - Ставь пакеты и бинарники только из проверенного feed, релизного артефакта или зафиксированного commit/tag, а не из непроверенного зеркала.

+ - Для `amneziawg-go`, kernel patches и LuCI-компонентов фиксируй версию и сверяй источник перед обновлением.

+ - Не подмешивай в UCI/LuCI значения, которые пришли из недоверенного внешнего источника, без ручной проверки.

## References

- `references/architecture.md`: роли пакетов и карта ключевых файлов.

- `references/uci-model.md`: интерфейс `proto amneziawg`, peer sections, опции и их смысл.

- `references/build-and-debug.md`: сборка, kernel/userspace fallback, watchdog и runtime-диагностика.