AI-агент на базе Claude Code для настройки обхода DPI-блокировок через zapret2.
Обёртка над zapret2 — низкоуровневым инструментом обхода DPI. Вместо ручной настройки iptables и nfqws ты разговариваешь с агентом: он сам разбирается в системе, задаёт вопросы и делает всё по шагам.
Не нужно знать что такое DPI, nfqws или iptables — агент объяснит каждый шаг и предложит правильный вариант для твоей системы.
- Диагностика системы (ОС, ядро, тип firewall, VPN, DNS-отравление)
- Установка zapret2 с нуля через пошаговый диалог
- Автоматический подбор стратегии обхода (через blockcheck)
- Два режима работы: прямой обход (без VPN) / защита туннеля (с VPN)
- Определение VPN-клиента при запуске (Throne, Nekoray, Hiddify, v2rayA, AmneziaVPN, Clash, sing-box, WireGuard, OpenVPN)
- Управление сервисом (старт, стоп, рестарт, статус)
- Управление списком доменов (добавить, удалить, просмотреть)
- Полный seed-список ТСПУ-блокировок с автоматическим мержем
- Бэкап и восстановление конфигурации
- Таймер отката для безопасных изменений iptables/nftables
- Linux: Ubuntu, Fedora, Arch, Manjaro
- Claude Code — установлен и авторизован
- git, bash, curl, sudo, ip
- dig — опционально (для проверки DNS)
macOS / Windows: не поддерживается. zapret2 использует nfqws (Linux netfilter). На macOS есть ограниченная поддержка через tpws, на Windows — через WinDivert, но этот агент их не реализует.
Быстрый старт:
git clone https://github.com/howdeploy/Zapret2agent.git
cd Zapret2agent
claudeЧерез install.sh:
bash <(curl -fsSL https://raw.githubusercontent.com/howdeploy/Zapret2agent/main/install.sh)Глобальная регистрация скиллов (Claude Code управляет zapret из любой папки):
bash install.sh --globalАгент поприветствует тебя и предложит меню. Скажи что нужно — установить, настроить или починить.
Совместим с Codex CLI — читает
AGENTS.md.
Проект состоит из трёх слоёв:
CLAUDE.md — инструкции для агента: как себя вести, что говорить, протокол безопасности. Читается Claude Code автоматически при запуске.
.claude/skills/ — пять скиллов с детальными процедурами:
zapret-diagnose— диагностика системыzapret-install— установка zapret с нуляzapret-config— настройка стратегии обходаzapret-manage— управление сервисом и спискамиzapret-modes— режимы работы (прямой обход / защита туннеля)
scripts/ — bash и python скрипты для надёжных операций: диагностика системы, бэкапы конфигов, парсинг результатов blockcheck, применение стратегий.
Перед каждой системной операцией (iptables, systemctl, запись в конфиг) агент показывает точную команду и ждёт подтверждения. Без «да» — ничего не выполняется.
Перед изменением iptables/nftables автоматически запускается таймер отката на 5 минут. Если что-то пошло не так — правила откатятся сами.
Конфигурация /opt/zapret2/config бэкапится автоматически перед каждым изменением.
Если агент сломался или нужно управлять zapret вручную:
# Статус сервиса
sudo systemctl status zapret2
# Остановить
sudo systemctl stop zapret2
# Отключить автозапуск
sudo systemctl disable zapret2
# Включить обратно
sudo systemctl enable zapret2 && sudo systemctl start zapret2
# Полное удаление
sudo /opt/zapret2/uninstall_easy.sh- zapret2: https://github.com/bol-van/zapret2
- Claude Code: https://docs.anthropic.com/en/docs/claude-code/overview
AI agent powered by Claude Code for configuring DPI bypass via zapret2.
A wrapper around zapret2 — a low-level DPI bypass tool. Instead of manually configuring iptables and nfqws, you talk to an agent: it analyzes your system, asks questions, and walks you through everything step by step.
No need to know what DPI, nfqws, or iptables are — the agent explains each step and suggests the right option for your system.
- System diagnostics (OS, kernel, firewall type, VPN, DNS poisoning)
- Full zapret2 installation through a guided dialog
- Automatic bypass strategy selection (via blockcheck)
- Two operating modes: direct bypass (no VPN) / tunnel protection (with VPN)
- VPN client detection at startup (Throne, Nekoray, Hiddify, v2rayA, AmneziaVPN, Clash, sing-box, WireGuard, OpenVPN)
- Service management (start, stop, restart, status)
- Domain list management (add, remove, view)
- Full TSPU block seed list with automatic merging
- Configuration backup and restore
- Rollback timer for safe iptables/nftables changes
- Linux: Ubuntu, Fedora, Arch, Manjaro
- Claude Code — installed and authorized
- git, bash, curl, sudo, ip
- dig — optional (for DNS checks)
macOS / Windows: not supported. zapret2 uses nfqws (Linux netfilter). macOS has limited support via tpws, Windows via WinDivert, but this agent does not implement them.
Quick start:
git clone https://github.com/howdeploy/Zapret2agent.git
cd Zapret2agent
claudeVia install.sh:
bash <(curl -fsSL https://raw.githubusercontent.com/howdeploy/Zapret2agent/main/install.sh)Global skill registration (Claude Code manages zapret from any directory):
bash install.sh --globalThe agent will greet you and offer a menu. Tell it what you need — install, configure, or troubleshoot.
Compatible with Codex CLI — reads
AGENTS.md.
The project has three layers:
CLAUDE.md — agent instructions: behavior, safety protocol, conversation style. Automatically loaded by Claude Code when launched in the repo directory.
.claude/skills/ — five skills with detailed procedures:
zapret-diagnose— system diagnosticszapret-install— zapret installation from scratchzapret-config— bypass strategy configurationzapret-manage— service and list managementzapret-modes— operating modes (direct bypass / tunnel protection)
scripts/ — bash and python scripts for reliable operations: system diagnostics, config backups, blockcheck result parsing, strategy application.
Before every system operation (iptables, systemctl, config writes), the agent shows the exact command and waits for confirmation. Nothing runs without an explicit "yes".
Before modifying iptables/nftables, a 5-minute rollback timer starts automatically. If something goes wrong — the rules revert on their own.
The /opt/zapret2/config is backed up automatically before every change.
If the agent breaks or you need to manage zapret manually:
# Service status
sudo systemctl status zapret2
# Stop
sudo systemctl stop zapret2
# Disable autostart
sudo systemctl disable zapret2
# Re-enable
sudo systemctl enable zapret2 && sudo systemctl start zapret2
# Full removal
sudo /opt/zapret2/uninstall_easy.sh- zapret2: https://github.com/bol-van/zapret2
- Claude Code: https://docs.anthropic.com/en/docs/claude-code/overview
Built with Claude Code
Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com