Skip to content
View saymer-alt's full-sized avatar
  • Moscow
  • 17:16 (UTC +03:00)

Block or report saymer-alt

Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
saymer-alt/README.md

Saymer — Networking & Infrastructure Projects

EN: Personal toolbox for home-network and VPS infrastructure: self-healing VPN gateways on Keenetic routers, DPI-aware routing with Mihomo, WARP/AmneziaWG tunnels and local-first browser config generators. Documentation is mostly in Russian.

Разрабатываю инструменты для домашней сети и VPS: автоматизирую настройку Keenetic с Entware, сборку и обновление Mihomo, маршрутизацию VPN и диагностику серверов. Среди отдельных проектов — резервная запись видео с IP-камер на Keenetic.

Platforms VPN core Tunnels Shell Go JavaScript

Основные проекты

Проект Что внутри
keenetic-auto-setup CI Автоматическая установка Mihomo на Keenetic + Entware одной командой: watchdog самовосстановления, Doctor-диагностика, безопасный импорт конфигурации, транзакционные обновления с откатом
keenetic-nvr CI Резервный RTSP-видеорегистратор на Keenetic + Entware: автономная запись IP-камер в 72-часовой архив без перекодирования (FFmpeg), watchdog для восстановления записи и необязательные уведомления через Telegram или webhook
link-generators CI · открыть веб-версию Браузерный генератор конфигураций Mihomo и ссылок WARP MASQUE: локальная сборка YAML, проверка конфигураций и предпросмотр подписок (для загрузки подписок может использоваться Cloudflare Worker)
keenetic-knowledge-base CI · открыть справочник База знаний по Keenetic, Entware, DPI, VPN и маршрутизации: тематические статьи, поиск и явные статусы подтверждения материалов
amnezia-mihomo-gateway CI VPS-шлюз: клиентский трафик AmneziaWG выходит в интернет через Mihomo TUN и Cloudflare WARP. Сайты видят выходной IP WARP вместо IP VPS; VPN-клиенты при этом знают адрес VPS как endpoint подключения
vps-gateway-bootstrap Экспериментальный safety-first CLI для VPS: read-only диагностика (discover / doctor / validate) и dry-run-планирование; реальные изменения — только через жизненный цикл с подтверждением плана по SHA-256-отпечатку. Исследовательский проект, а не готовый автодеплой
entware-go Поддерживаемый форк Entware package feed: IPK-пакеты Mihomo для нескольких архитектур, WARPSCOUT для ARM64 и другие утилиты. Сборка и публикация через GitHub Actions

С чего начать

  • Поднять VPN-шлюз на роутере Keenetic → keenetic-auto-setup: в README быстрый старт, требования к железу и памяти.
  • Организовать резервную запись IP-камер на Keenetic → keenetic-nvr: описание возможностей, требования и инструкция по установке в документации проекта.
  • Собрать конфиг Mihomo, не редактируя YAML руками → откройте веб-генератор или его исходники — link-generators.
  • Разобраться, как это устроено → онлайн-справочник или исходники базы знаний: статьи о Keenetic, Entware, DPI и VPN с поиском.
  • Выводить клиентский трафик VPS через WARP → amnezia-mihomo-gateway: сайты видят IP WARP, но адрес VPS не скрывается от VPN-клиентов.
  • Продиагностировать VPS, не рискуя продакшеном → vps-gateway-bootstrap: по умолчанию работает в режиме только чтения.
  • Нужны готовые IPK-пакеты Mihomo для Entware или WARPSCOUT для ARM64 → entware-go, актуальный релиз latest.
  • Нужен бинарник Mihomo под старые MIPSel-роутеры (MT7621, soft-float) → mihomo-auto-build: сборка из точного upstream-тега в GitHub Actions с проверкой SHA-256 и лицензионными уведомлениями (upstream Mihomo — GPL-3.0).

Технологии и направления

  • Платформы: Keenetic (KeeneticOS + Entware), Debian/Ubuntu на VPS, GitHub Actions CI.
  • Языки: POSIX shell (busybox/ash), Go, ванильный JavaScript, Python для утилит.
  • Сети и VPN: Mihomo, AmneziaWG / WireGuard, Cloudflare WARP (MASQUE), TUN-маршрутизация, policy routing, обход DPI.
  • Инфраструктура: идемпотентные установщики, systemd / procd, Docker, watchdog'и, FFmpeg/RTSP-архивирование, CI с регрессионными тестами.

Документация и релизы

Принципы разработки

  • Простота по умолчанию. До разработки сравнивать ручной путь, минимальную функцию и расширенную архитектуру; при росте сложности нужна повторная проверка необходимости. Сквозной контракт для всех проектов — SIMPLICITY-FIRST.
  • Воспроизводимость. Детерминированные сборки, зафиксированные версии, проверяемое происхождение артефактов.
  • Проверка изменений. Регрессионные тесты и CI перед публикацией; живые роутеры и серверы — не полигон: реальные изменения проходят отдельное подтверждение владельца.
  • Откат. Атомарная замена файлов, бэкапы перед изменениями, автоматический rollback при провале валидации.
  • Приватность. Разбор ссылок и сборка конфигураций в генераторе выполняются локально. Предпросмотр подписок может обращаться к серверу подписки через промежуточный Cloudflare Worker, а диагностика — напрямую к указанному пользователем Mihomo Controller. Подробности и ограничения: модель данных и сети.

Вопросы и сообщения о багах — через Issues в соответствующем репозитории.

Pinned Loading

  1. keenetic-auto-setup keenetic-auto-setup Public

    Mihomo (Clash Meta) on Keenetic + Entware: one-command installer, VPN routing, watchdog, diagnostics and safe updates

    Shell 9

  2. link-generators link-generators Public

    Local-first Mihomo config & WARP MASQUE link generator; subscription preview may use a Cloudflare Worker

    JavaScript 2

  3. entware-go entware-go Public

    Forked from spatiumstas/entware-go

    Entware IPK package builds for Keenetic: Mihomo, WARPSCOUT and other Go-based tools

    Makefile 1

  4. vps-gateway-bootstrap vps-gateway-bootstrap Public

    Early-stage Go framework for auditable VPS gateway provisioning: read-only discovery/doctor/validate and dry-run planning today; mutations confined to an orchestrated, fingerprint-confirmed lifecycle.

    Go 1

  5. amnezia-mihomo-gateway amnezia-mihomo-gateway Public

    Route AmneziaWG (Docker) client traffic through a Mihomo TUN so egress exits via Cloudflare WARP: internet services see WARP IPs, not the VPS IP. VPN clients still know the VPS IP as their tunnel e…

    Shell 1

  6. keenetic-knowledge-base keenetic-knowledge-base Public

    Keenetic & Entware engineering knowledge base: research notes and verified articles on Mihomo, VPN, routing and DPI bypass (in Russian)

    Shell 1