sing-box: что это, где скачать и как устроена конфигурация

sing-box ищут примерно десять тысяч раз в месяц, и под этим названием люди имеют в виду разное: ядро для технических пользователей, приложение для Android или iPhone, файл настроек. Объясняем простыми словами, что к чему, где качать и как читать конфигурацию. Сразу главное: sing-box — клиент и «движок». Без подписки или данных сервера он никуда не подключит, серверов у проекта нет.

Что такое sing-box

Официальный сайт проекта — sing-box.sagernet.org, код лежит в репозитории SagerNet/sing-box на GitHub. Автор описывает его как универсальную прокси-платформу. Это ядро: программа, которая принимает трафик и отправляет его туда, куда сказано в настройках. Одно ядро умеет много протоколов, поэтому на нём строят приложения, в том числе Karing и NekoBox.

Из этого следуют два варианта использования:

1. Готовое приложение. Самые простые: официальные клиенты проекта для телефонов и компьютера. Вы добавляете профиль или ссылку и нажимаете кнопку.
2. Ядро из командной строки. Для тех, кто пишет конфигурацию вручную. Обычному пользователю это не нужно.

Клиенты: SFA, SFI, SFM

У проекта есть официальные графические клиенты. В релизах на GitHub их названия видны по префиксам файлов.

• SFA — sing-box for Android.
• SFI — для iOS (и tvOS), SFM — для macOS. Сайт проекта называет общий клиент для яблочных систем «sing-box for Apple».
• SFL — пакеты для Linux (deb, rpm, Arch).

Для Windows отдельного приложения с кнопкой в списке релизов мы не нашли. Но ядро для Windows ставится через менеджеры пакетов (см. ниже), а многие сторонние приложения используют sing-box «внутри». Если вам нужна программа с окном, посмотрите Karing, Happ или V2RayTun.

Где скачать (и как не нарваться на фейк)

Берите приложение только по ссылкам с официального сайта проекта. Мы проверили, что они открываются.

• Android (SFA): по странице sing-box.sagernet.org/clients/android доступны Google Play (в том числе бета-канал), раздел Releases на GitHub и F-Droid. Требуется Android 5.0 или новее. В релизе 1.14.4 есть APK под arm64-v8a, armeabi-v7a, x86, x86_64, universal, а также версии «legacy-android-5» для самых старых устройств.
• iPhone, iPad, Apple TV: App Store по ссылке с сайта проекта. Нужна iOS 15 и новее. Страница проекта отдельно требует аккаунт Apple вне материкового Китая. Бета-версии через TestFlight доступны спонсорам проекта.
• macOS: по документации, через Homebrew (brew install sfm) или из GitHub Releases. Нужна macOS 13 и новее.
• Windows, Linux и ядро: страница установки через менеджеры пакетов приводит, например, winget install sing-box, scoop install sing-box, choco install sing-box, а для Linux — репозитории apt и dnf, AUR и другие.
• OpenWrt: по той же странице есть скрипт установки (curl -fsSL https://sing-box.app/install.sh | sh), который поддерживает deb/rpm, Arch и OpenWrt. Пошаговой инструкции именно для роутеров на сайте проекта мы не нашли, а эффект зависит от модели; для стандартных настроек роутера смотрите OpenWrt.

Как не нарваться на фейк:

1. Не качайте «sing-box» с сайтов, которые выглядят как официальные, но имеют другой адрес. Основные адреса — sing-box.sagernet.org, github.com/SagerNet и sing-box.app.
2. Не запускайте скрипт установки, если не понимаете, что он делает. Прочитайте его перед запуском.
3. В магазинах сверяйте разработчика и ссылку: открывайте магазин по ссылке с сайта проекта, а не через поиск.
4. Файлы .apk и .exe из чатов и роликов — риск. Любой файл проверяйте антивирусом.
5. Не платите за «активацию». Сам проект открытый, подписку выдаёт ваш сервис.

Как устроена конфигурация простыми словами

Файл настроек sing-box — это JSON. По документации sing-box.sagernet.org/configuration в нём такие верхние разделы:

• log — как и что записывать в журнал;
• dns — как приложение узнаёт адреса сайтов;
• inbounds — «входы»: откуда принимать трафик (например, виртуальный сетевой интерфейс TUN или локальный прокси);
• outbounds — «выходы»: куда отправлять трафик (сервер из вашей подписки, прямое соединение);
• route — правила маршрутизации: какой трафик на какой выход;
• experimental — дополнительные возможности.

Есть и другие разделы (ntp, endpoints, services и т. д.), которые нужны реже. Идея простая: трафик заходит через inbound, правило из route выбирает outbound, и он уходит на сервер. Проверить файл можно командой sing-box check, а привести в порядок — sing-box format. Файл можно собирать и из нескольких частей: ядру передают файл (-c) и каталог (-D).

Для обычного пользователя всё проще: если вы используете приложение и подписку, то профиль создаёт сервис, а вы просто его импортируете. Подробности про протоколы: Протоколы подключения простыми словами.

Как добавить подписку

Для клиентов проекта в описании общих функций есть «удалённый профиль»: профиль, который загружается по ссылке и автоматически обновляется (по умолчанию раз в 60 минут). Клиент должен поддерживать импорт по ссылке вида sing-box://import-remote-profile?url=.... Общий порядок такой:

1. Откройте приложение и найдите добавление профиля (раздел Profiles или похожий; названия зависят от версии).
2. Выберите удалённый профиль (по ссылке) и вставьте ссылку из подписки.
3. Сохраните и обновите профиль.
4. Включите профиль в панели управления и разрешите системе создать подключение.

Важное ограничение: sing-box ждёт профиль в формате sing-box. Если сервис выдаёт обычную подписку со ссылками vless://..., напрямую она может не подойти; уточните у сервиса, какие форматы он поддерживает.

Если не подключается

• Проверьте, что профиль загрузился и не пустой.
• Убедитесь, что подписка не закончилась.
• Проверьте время на устройстве.
• Не запускайте несколько подобных приложений одновременно.
• Ошибка в JSON (лишняя запятая) не даст ядру запуститься: sing-box check покажет место.

Общий порядок диагностики: Не подключается: 8 причин и что делать.

Проще через подписку MEDOED

Бот @Medoed_net_bot выдаёт ссылку-подписку, которую вы добавляете в Happ, V2RayTun или INCY. Первый день бесплатно, а возиться с конфигурацией не придётся.

Частые вопросы

sing-box — это приложение или ядро? И то и другое. Само ядро — программа без окна; на его основе есть официальные приложения (SFA, SFI, SFM) и сторонние клиенты.

Где скачать sing-box для Android? По ссылкам с официального сайта: Google Play, GitHub Releases или F-Droid.

Есть ли sing-box для Windows? Ядро ставится через winget, Scoop или Chocolatey. Официального приложения с окном для Windows мы в списке релизов не нашли.

Можно ли поставить sing-box на OpenWrt? Сайт проекта упоминает скрипт установки для OpenWrt. Подробной инструкции для роутеров там нет, поэтому настройку лучше начинать с инструкции по OpenWrt.

Нужно ли писать конфигурацию вручную? Нет. Обычно профиль создаёт сервис, а вы импортируете его по ссылке.