podkop-anabasis/README.md

Podkop Evolution

Podkop's fork with HWID and Subscription URL support

Этот форк добавляет поддержку ссылок подписки (subscription URL) с кастомными заголовками (HWID, Device-OS, Device-Model) и автоматическим обновлением. Основан на itdoginfo/podkop.

---

Вещи, которые вам нужно знать перед установкой

• Это бета-версия, которая находится в активной разработке. Из версии в версию что-то может меняться.
• При возникновении проблем, нужен технически грамотный фидбэк в чат. Ознакомьтесь с закрепом в топике.
• При обновлении обязательно сбрасывайте кэш LuCI.
• Также при обновлении всегда заходите в конфигурацию и проверяйте свои настройки. Конфигурация может измениться.
• Необходимо минимум 25МБ свободного места на роутере. Роутеры с флешками на 16МБ сразу мимо.
• При старте программы редактируется конфиг Dnsmasq.
• Podkop редактирует конфиг sing-box. Обязательно сохраните ваш конфиг sing-box перед установкой, если он вам нужен.
• Информация здесь может быть устаревшей. Все изменения фиксируются в телеграм-чате.
• Если у вас что-то не работает.
• Если у вас установлен Getdomains, его следует удалить.
• Требуется версия OpenWrt 24.10.
• Dashboard доступен, если вы заходите по http (из-за особенностей clash api). И не будет работать, если вы заходите по https и/или домену.

Документация

https://podkop.net/

Установка Podkop Evolution

Полная информация в документации

Вкратце, достаточно одного скрипта для установки и обновления:

sh <(wget -O - https://raw.githubusercontent.com/yandexru45/podkop-evolution/refs/heads/main/install.sh)

Новое в этом форке: Подписки (Subscription)

Добавлена поддержка subscription URL — ссылки подписки от провайдера прокси. При выборе типа конфигурации Subscription в LuCI:

• Введите URL подписки от вашего провайдера
• Выберите интервал автообновления (от 30 минут до 1 дня)
• Все серверы из подписки автоматически появятся в дашборде
• Автоматический выбор лучшего сервера по задержке (URLTest)
• Ручное переключение между серверами через дашборд

При скачивании подписки отправляются заголовки:

• User-Agent: singbox/<версия>
• X-HWID — уникальный идентификатор роутера
• X-Device-OS: OpenWrt Linux
• X-Device-Model — модель роутера
• X-Ver-OS — версия ядра

Пример конфигурации через UCI:

uci set podkop.my_sub=section
uci set podkop.my_sub.connection_type='proxy'
uci set podkop.my_sub.proxy_config_type='subscription'
uci set podkop.my_sub.subscription_url='https://your-provider.com/api/sub'
uci set podkop.my_sub.subscription_update_interval='1h'
uci add_list podkop.my_sub.community_lists='russia_inside'
uci commit podkop

Ручное обновление подписки:

/usr/bin/podkop subscription_update

Изменения 0.7.0

Начиная с версии 0.7.0 изменена структура конфига /etc/config/podkop. Старые значения несовместимы с новыми. Нужно заново настроить Podkop.

Скрипт установки обнаружит старую версию и предупредит вас об этом. Если вы согласитесь, то он сделает автоматически написанное ниже.

При обновлении вручную нужно:

0. Не ныть в issue и чатик.
1. Забэкапить старый конфиг:

mv /etc/config/podkop /etc/config/podkop-070

2. Стянуть новый дефолтный конфиг:

wget -O /etc/config/podkop https://raw.githubusercontent.com/yandexru45/podkop-evolution/refs/heads/main/podkop/files/etc/config/podkop

3. Настроить заново ваш Podkop через Luci или UCI.

ToDo

Important

PR принимаются только по согласованию с авторами в ТГ-чате. Остальные PR на данный момент не рассматриваются. Не тратьте зря своё время.

Будущее

• Подписка — реализовано в этом форке!
• Весь трафик в sing-box и маршрутизация полностью на его уровне.
• При успешном запуске переходит в фоновый режим и следит за состоянием sing-box. Если вдруг идёт exit 1, выполняется dnsmasq restore и снова следит за состоянием. Issue
• Галочка, которая режет доступ к doh серверам.
• IPv6. Только после наполнения Wiki.

Тесты

• Unit тесты (BATS)
• Интеграционные тесты бекенда (OpenWrt rootfs + BATS)