Как обновить sing-box: версия core, клиент и конфиг
Обновление sing-box состоит из трёх разных изменений: core, приложения и формата конфигурации. Сохраняйте рабочие версии и проверяйте их совместимость по отдельности.
Содержание
Что именно вы обновляете
Core обрабатывает соединение и конфигурацию. Графический клиент импортирует профиль, управляет разрешениями ОС и может поставлять собственную версию core. JSON-конфиг — отдельный объект: его схема меняется между версиями. Поэтому одинаковая фраза «обновил sing-box» может означать три разных действия. Перед работой запишите версии всех трёх компонентов и источник релиза.
Сохраните работающий вариант
Скопируйте бинарник и конфиг в защищённое место, экспортируйте профиль из приложения штатным способом и сохраните журнал успешного запуска без секретов. На удалённом роутере или сервере нужен независимый доступ: ошибка маршрута может оборвать SSH. Не переписывайте единственный рабочий файл и не запускайте миграцию на устройстве, с которого администрируете сеть.
Проверяйте по шагам
- Откройте официальный changelog и Migration для целевой версии.
- Обновите core в тестовом окружении, проверьте копию JSON командой
sing-box check -c /path/to/config.json. - Проверьте подключение и DNS, не меняя одновременно все route-правила.
- Обновите приложение только после подтверждения его совместимости с целевой версией core.
- При сбое верните бинарник и конфиг вместе; сохраните текст ошибки для анализа.
Схема 1.14 описана отдельно. Подготовка TUN для будущей ветки 1.15 — другая миграция, которая на дату проверки относится к alpha-релизам.
Как проверить результат
Успешный check означает, что синтаксис принят, а не что клиент вышел в сеть. Проверьте хотя бы один домен, DNS-ответ, локальную сеть и отключение клиента с восстановлением обычного маршрута. Если профили импортируются, но сайты не открываются, локализуйте DNS и route отдельно.
Проверено на практике
- Дата проверки: 2026-09-29
- Среда: Сверено с указанными первоисточниками; устройство читателя не проверялось
- Версии: Зависит от версии core, клиента и прошивки
Мини-чеклист
- Записать версии core, клиента и схемы
- Сохранить рабочие бинарник и конфиг
- Сверить Migration и changelog
- Проверить копию JSON
- Проверить сеть и откат
Частые ошибки
- Называть разные компоненты одной версией
- Менять JSON и core без бэкапа
- Считать check тестом связи
Источники и документация
FAQ
Нужно ли обновлять приложение и core одновременно?
Только если их совместимость подтверждена. Обычно надёжнее менять по одному компоненту и проверять результат.
Хотите перейти сразу к рабочему доступу?
Если сценарий уже ясен и не хочется проходить все шаги вручную, оформите доступ и проверьте подключение на своем устройстве.
Получить доступ