embeddevio/awg-dash

Fork 0

T

embeddevio 20db51b7a2

ci / lint (push) Successful in 40s

Details

ci / lint (pull_request) Successful in 40s

Details

contract-openapi / openapi-contract (push) Successful in 51s

Details

contract-openapi / ts-client-is-current (push) Successful in 42s

Details

contract-openapi / openapi-contract (pull_request) Successful in 54s

Details

contract-openapi / ts-client-is-current (pull_request) Successful in 39s

Details

ci / unit (push) Successful in 46s

Details

ci / security (push) Successful in 1m24s

Details

ci / unit (pull_request) Successful in 58s

Details

ci / security (pull_request) Successful in 1m27s

Details

ci / build (push) Successful in 9m44s

Details

ci / build (pull_request) Successful in 35s

Details

ci / image-scan (push) Failing after 7s

Details

ci / image-scan (pull_request) Failing after 3s

Details

ci / push (push) Has been skipped

Details

ci / push (pull_request) Has been skipped

Details

fix(#61 ): бамп базовых образов и x/crypto под гейт image-scan

- GO_IMAGE golang:1.25-alpine → golang:1.26-alpine (CVE Go stdlib 1.25.14: CVE-2026-56857 CRITICAL, CVE-2026-111943/78667/97031 HIGH)
- golang.org/x/crypto → v0.43.0 в amneziawg-go (CVE-2025-47913 HIGH)
- runtime alpine:3.21 → alpine:3.23 + apk upgrade (HIGH в пакетах базы)

Refs #61, Refs #18, Refs #17

2026-10-29 21:09:52 +03:00

.gitea/workflows

Merge branch 'main' into feat/17-ci

2026-10-29 20:58:45 +03:00

backend

Merge pull request 'Sprint 0 / #20 : хранилище состояния — SQLite WAL, миграции, audit log, атомарный apply/rollback' (#50 ) from feat/20-storage into main

2026-10-28 21:35:41 +03:00

deploy

fix(#61 ): бамп базовых образов и x/crypto под гейт image-scan

2026-10-29 21:09:52 +03:00

docs

docs(ci): дефекты 6.4 (артефакты, #62 ) и 6.5 (contract-openapi checkout, #59 )

2026-10-28 23:40:43 +03:00

tests

docs(#21 ): README netns и runbook dev-stand — ci.sh, приоритет AWG_NS_EXEC_MODE, DEV_SKIP_BUILD

2026-10-28 21:58:15 +03:00

Merge pull request 'Sprint 0 / #19 : OpenAPI 3.1 контракт API v1 + TS-клиент и контрактные тесты' (#57 ) from feat/19-openapi into main

2026-10-28 21:21:13 +03:00

.editorconfig

chore(#16 ): skeleton репозитория — README, Makefile, линтеры, зависимости

2026-10-21 23:28:50 +03:00

.gitignore

chore(#16 ): skeleton репозитория — README, Makefile, линтеры, зависимости

2026-10-21 23:28:50 +03:00

.pre-commit-config.yaml

chore(#16 ): skeleton репозитория — README, Makefile, линтеры, зависимости

2026-10-21 23:28:50 +03:00

LICENSE

Initial commit

2026-10-16 22:45:47 +03:00

Makefile

deploy(#21 ): контракт кодов netns без make, AWG_NS_EXEC_MODE в приоритете, DEV_SKIP_BUILD

2026-10-28 21:57:44 +03:00

pyproject.toml

chore(#16 ): skeleton репозитория — README, Makefile, линтеры, зависимости

2026-10-21 23:28:50 +03:00

README.md

chore(#16 ): skeleton репозитория — README, Makefile, линтеры, зависимости

2026-10-21 23:28:50 +03:00

requirements-contract.txt

docs(api): OpenAPI 3.1 контракт API v1 как source of truth (Refs #19 )

2026-10-22 00:20:36 +03:00

requirements-dev.txt

chore(#16 ): skeleton репозитория — README, Makefile, линтеры, зависимости

2026-10-21 23:28:50 +03:00

requirements.txt

chore(#16 ): skeleton репозитория — README, Makefile, линтеры, зависимости

2026-10-21 23:28:50 +03:00

README.md

awg-dash

VPN-шлюз AmneziaWG с интеллектуальной маршрутизацией: один Docker-образ = туннель + policy routing + split-tunnel (GeoIP / DNS) + REST API v1 + Web UI (тёмная тема).

Эпик и декомпозиция: Gitea issue #15 (embeddevio/awg-dash).
Исполнение: Hermes Kanban, борда awg-dash (hermes kanban --board awg-dash list).
PoC-референс: embeddevio/amneziawg-docker-gateway (bash + iptables, docs/technical-specification.md).

Архитектура

Два процесса в одном образе:

Процесс	Пользователь	Ответственность
`awg-agent`	root	awg/wg-интерфейс, iptables/ipset, dnsmasq, policy routing, метрики
`awg-api`	непривилегированный	FastAPI: REST API v1, WebSocket, статика UI

Обмен — unix-socket /run/awg/agent.sock; состояние — SQLite в /data, конфиги .conf в /config. Принятые решения зафиксированы в docs/adr/.

Быстрый старт (после релиза 1.0)

docker run -dit --name=vpn-gateway \
  --network=host \
  --device=/dev/net/tun:/dev/net/tun \
  --cap-add=NET_ADMIN --cap-add=SYS_MODULE \
  --restart always \
  -v /srv/awg/config:/config -v /srv/awg/data:/data \
  registry.example.com/vpn-gateway:latest

Web UI: http://<host>:8080. До релиза образ собирается локально: make build.

Разработка

make venv    # локальное окружение (.venv)
make lint    # ruff + mypy
make test    # pytest + coverage (порог 70%)
make build   # docker build образа (задача #18)
make dev-up  # dev-стенд (задача #21)

Сетевые тесты выполняются в netns-стенде (tests/netns/), без реального VPN-провайдера.

Структура репозитория

Путь	Назначение
`backend/awg_agent/`	привилегированный агент: туннель, маршрутизация, GeoIP, DNS, метрики
`backend/awg_api/`	FastAPI-приложение (REST + WS + статика UI)
`backend/tests/`	unit/integration-тесты (pytest)
`ui/`	React + TypeScript + Tailwind + shadcn-ui
`deploy/`	Dockerfile, compose-профили, entrypoint, Grafana-дашборд
`docs/adr/`	архитектурные решения
`tests/netns/`	сетевой тестовый стенд

Процесс разработки

1 задача = 1 issue = 1 ветка feat/<issue>-slug = 1 PR.

Гейты мержа: CI green, coverage нового кода ≥ 70 %, security scan low/none, ревью владельца роли. Merge в main и деплой в prod — только TechLead после гейтов. Все операции с репозиторием — через Gitea MCP.