Формат конфигурации sing-box в 2026 году
Формат конфигурации sing-box в 2026 году — это JSON с разделами log, dns, inbounds, outbounds, route. Практическое руководство: как получить готовую конфигурацию для личного VPS SANSARA и импортировать её в клиенты на iPhone, Android, Windows, macOS.
Чтобы подключиться к своему личному VPS через sing-box, вам нужен файл конфигурации в формате JSON. Он описывает, как клиент должен подключаться к вашему выделенному узлу в SANSARA и как маршрутизировать трафик. Если вы используете личный VPS SANSARA, то готовая конфигурация уже создана за вас и доступна для импорта в кабинете или через Telegram-бот SANSARA.
Коротко:
- Конфигурация sing-box — это файл config.json в формате JSON.
- Основные разделы: log, dns, inbounds, outbounds, route.
- В SANSARA конфигурация генерируется автоматически под ваш личный сервер.
- Доступны готовые профили для iPhone, Android, Windows, macOS.
- Работает через выделенный узел в одной из 9+ стран без общего пула.
Что это и кому подходит
sing-box — это клиент и серверная платформа, которая работает с разными протоколами и настройками маршрутизации. Вместо одного готового приложения это гибкий движок, который читает JSON-конфиг и на его основе строит защищённый канал.
Кому подходит такой подход:
- Тем, кто хочет полный контроль над маршрутизацией: какие сайты идут через личный VPS, какие напрямую.
- Тем, кто уже использует личный VPS SANSARA и хочет единую конфигурацию на всех устройствах.
- Тем, кому важна стабильность выделенного узла, а не общий перегруженный шлюз.
Если вы просто хотите быстро подключиться к своему серверу — вам достаточно импортировать готовый профиль из кабинета SANSARA в клиент sing-box на своём устройстве.
Как настроить по шагам (с личным VPS SANSARA)
- 01Зарегистрируйтесь в SANSARA и получите личный VPS
После регистрации вы получаете доступ к кабинету, где отображаются данные вашего выделенного узла: IP-адрес, порт, метод шифрования, пароль и другие параметры.
- 01Выберите тип конфигурации в кабинете
В кабинете SANSARA есть раздел с готовыми конфигурациями для разных клиентов, включая sing-box. Вы можете выбрать:
- Базовая конфигурация (простой туннель через ваш сервер).
- Расширенная конфигурация с правилами маршрутизации (например, обход блокировок только для определённых сайтов).
- 01Скачайте или скопируйте JSON-конфиг
В зависимости от выбранного варианта вы получите:
- Ссылку на config.json для импорта в клиент.
- Текст конфигурации, который можно скопировать вручную.
Пример минимальной структуры:
`json { "log": { "level": "info", "timestamp": true }, "dns": { "servers": [ { "tag": "local-dns", "address": "local", "detour": "direct" } ] }, "inbounds": [ { "type": "mixed", "tag": "mixed-in", "listen": "127.0.0.1", "listen_port": 1080, "set_system_proxy": true, "sniff": true } ], "outbounds": [ { "type": "shadowsocks", "tag": "proxy-out", "server": "ваш.сервер.sansara", "server_port": 443, "method": "chacha20-ietf-poly1305", "password": "ваш-пароль" }, { "type": "direct", "tag": "direct" } ], "route": { "rules": [ { "geoip": [ "private", "cn" ], "outbound": "direct" }, { "geosite": [ "category-ads-all" ], "outbound": "direct" } ], "final": "proxy-out" } } `
В реальной конфигурации от SANSARA все поля уже заполнены под ваш сервер.
- 01Импортируйте конфигурацию в клиент sing-box
На каждом устройстве процедура немного отличается, но общий принцип одинаков:
- Откройте клиент sing-box.
- Найдите пункт «Импорт конфигурации» или «Import from URL».
- Вставьте ссылку из кабинета SANSARA или загрузите файл config.json.
- Сохраните профиль и активируйте его.
- 01Проверьте подключение
После активации клиент должен показать статус «подключено» или аналогичный. Вы можете проверить IP-адрес через любой сервис проверки — он должен соответствовать локации вашего личного VPS SANSARA.
Никакой работы в терминале не требуется: всё настраивается через графический интерфейс клиента и готовые конфигурации из кабинета.
Устройства: iPhone, Android, Windows, macOS
iPhone
- Установите клиент sing-box из App Store.
- В кабинете SANSARA выберите профиль для iOS/sing-box.
- Скопируйте ссылку или QR-код конфигурации.
- В приложении нажмите «Импорт из URL» или «Сканировать QR-код».
- Сохраните профиль и включите туннель.
Android
- Установите клиент sing-box (например, через официальный сайт или магазин приложений).
- В кабинете SANSARA выберите профиль для Android.
- Импортируйте конфигурацию по ссылке или через файл.
- Включите сервис sing-box; при необходимости предоставьте разрешение на создание TUN-интерфейса.
Windows
- Скачайте клиент sing-box для Windows.
- Запустите его и перейдите в раздел настройки.
- Импортируйте config.json из кабинета SANSARA.
- Активируйте профиль; клиент может предложить установить системный туннель или настроить прокси.
macOS
- Установите sing-box для macOS (обычно через Homebrew или готовый бинарник).
- Откройте настройки и импортируйте конфигурацию от SANSARA.
- Включите туннель; система может запросить разрешение на установку сетевого расширения.
Во всех случаях ключевой шаг — не ручное редактирование JSON, а импорт готовой конфигурации, которая уже настроена под ваш личный VPS.
Частые ошибки и как их избежать
- 01Неправильный JSON-синтаксис
Если вы редактируете конфиг вручную, любая лишняя запятая или кавычка ломает весь файл. Решение: используйте JSON-валидатор или просто импортируйте готовую конфигурацию из кабинета SANSARA.
- 01Несовпадение параметров сервера
Адрес сервера, порт, метод шифрования или пароль должны точно соответствовать данным из кабинета. Решение: не копируйте параметры «на глаз» — берите их напрямую из кабинета или готового профиля.
- 01Заблокированные порты или ограничения провайдера
Иногда провайдер блокирует стандартные порты. Решение: в SANSARA можно выбрать альтернативный порт или протокол; если проблема сохраняется, обратитесь в поддержку через Telegram-бот SANSARA.
- 01Клиент не имеет прав на создание туннеля
На Android и iOS клиенту нужны разрешения на управление соединением. Решение: при первом запуске предоставьте запрошенные разрешения и, если нужно, перезапустите приложение.
- 01Конфигурация устарела после обновления sing-box
Формат конфигурации со временем меняется. Решение: SANSARA обновляет шаблоны конфигураций под актуальные версии sing-box; если клиент ругается на неизвестные поля, скачайте свежий профиль из кабинета.
FAQ
Где взять актуальную документацию по формату конфигурации sing-box?+
Официальная документация по формату JSON-конфигурации находится на сайте проекта sing-box. Там описаны все разделы: log, dns, inbounds, outbounds, route, а также новые поля, добавленные в 2025–2026 годах.
Можно ли использовать одну конфигурацию на всех устройствах?+
Да, если все устройства подключаются к одному личному VPS. Конфигурация от SANSARA универсальна; различия обычно только в настройках интерфейса клиента (например, порт локального прокси).
Нужно ли мне редактировать JSON вручную, если я беру VPS в SANSARA?+
Нет. Вся конфигурация генерируется автоматически под ваш сервер. Вам достаточно импортировать готовый профиль в клиент sing-box на своём устройстве.
Что делать, если клиент пишет «неверный формат конфигурации»?+
Скорее всего, файл повреждён или не соответствует версии sing-box. Скачайте новый профиль из кабинета SANSARA и импортируйте его заново.
Сколько локаций доступно для личного VPS в SANSARA?+
В 2026 году SANSARA предлагает личные VPS в 9+ странах, включая узлы в Европе и других регионах. Конкретный список локаций можно посмотреть в кабинете при заказе сервера.
Сравнение подходов к настройке
| Подход | Сложность | Гибкость | Подходит для SANSARA |
|---|---|---|---|
| Ручное редактирование JSON | Высокая | Максимальная | Да, но избыточно для большинства |
| Готовый профиль из кабинета | Низкая | Достаточная | Рекомендуется |
| Использование Telegram-бота | Минимальная | Базовая | Удобно для быстрого старта |
Итог
- Конфигурация sing-box — это JSON-файл с разделами log, dns, inbounds, outbounds, route.
- В SANSARA вам не нужно разбираться в тонкостях формата: готовая конфигурация создаётся автоматически под ваш личный VPS.
- Импортируйте профиль из кабинета в клиент sing-box на iPhone, Android, Windows или macOS.
- Все настройки уже подогнаны под выделенный узел в одной из 9+ стран.
- Если что-то не работает, скачайте свежий профиль из кабинета или обратитесь через Telegram-бот SANSARA.
Ещё по теме
Читайте также
CTA · SANSARA
Личный VPS — без терминала и очередей
Регистрация, импорт профиля и стабильный канал на телефон и компьютер. Тот же принцип, о котором мы пишем в блоге — на практике.