Быстрый старт Обновление Обновлено 6 мин Linux, Windows, macOS, Android

Как обновить sing-box: версия core, клиент и конфиг

Обновление sing-box состоит из трёх разных изменений: core, приложения и формата конфигурации. Сохраняйте рабочие версии и проверяйте их совместимость по отдельности.

sing-boxобновлениеcoreконфиг
Три отдельно проверяемых компонента обновления sing-box
Проверяйте core, приложение и конфиг отдельно.
Содержание
КороткоОбновление sing-box состоит из трёх разных изменений: core, приложения и формата конфигурации. Сохраняйте рабочие версии и проверяйте их совместимость по отдельности.

Что именно вы обновляете

Core, приложение и конфигурация проходят отдельные проверки перед обновлением
Общее обновление состоит из независимых изменений.

Core обрабатывает соединение и конфигурацию. Графический клиент импортирует профиль, управляет разрешениями ОС и может поставлять собственную версию core. JSON-конфиг — отдельный объект: его схема меняется между версиями. Поэтому одинаковая фраза «обновил sing-box» может означать три разных действия. Перед работой запишите версии всех трёх компонентов и источник релиза.

Сохраните работающий вариант

Скопируйте бинарник и конфиг в защищённое место, экспортируйте профиль из приложения штатным способом и сохраните журнал успешного запуска без секретов. На удалённом роутере или сервере нужен независимый доступ: ошибка маршрута может оборвать SSH. Не переписывайте единственный рабочий файл и не запускайте миграцию на устройстве, с которого администрируете сеть.

Проверяйте по шагам

  1. Откройте официальный changelog и Migration для целевой версии.
  2. Обновите core в тестовом окружении, проверьте копию JSON командой sing-box check -c /path/to/config.json.
  3. Проверьте подключение и DNS, не меняя одновременно все route-правила.
  4. Обновите приложение только после подтверждения его совместимости с целевой версией core.
  5. При сбое верните бинарник и конфиг вместе; сохраните текст ошибки для анализа.

Схема 1.14 описана отдельно. Подготовка TUN для будущей ветки 1.15 — другая миграция, которая на дату проверки относится к alpha-релизам.

Как проверить результат

Успешный check означает, что синтаксис принят, а не что клиент вышел в сеть. Проверьте хотя бы один домен, DNS-ответ, локальную сеть и отключение клиента с восстановлением обычного маршрута. Если профили импортируются, но сайты не открываются, локализуйте DNS и route отдельно.

Проверено на практике

  • Дата проверки: 2026-09-29
  • Среда: Сверено с указанными первоисточниками; устройство читателя не проверялось
  • Версии: Зависит от версии core, клиента и прошивки

Мини-чеклист

  • Записать версии core, клиента и схемы
  • Сохранить рабочие бинарник и конфиг
  • Сверить Migration и changelog
  • Проверить копию JSON
  • Проверить сеть и откат

Частые ошибки

  • Называть разные компоненты одной версией
  • Менять JSON и core без бэкапа
  • Считать check тестом связи

Источники и документация

FAQ

Нужно ли обновлять приложение и core одновременно?

Только если их совместимость подтверждена. Обычно надёжнее менять по одному компоненту и проверять результат.

Хотите перейти сразу к рабочему доступу?

Если сценарий уже ясен и не хочется проходить все шаги вручную, оформите доступ и проверьте подключение на своем устройстве.

Получить доступ

Дальше по теме

Связанные статьи