Установка 3x-ui в Docker на личный VPS SANSARA (2026)
Как установить 3x-ui в Docker на личный VPS SANSARA в 2026 году: пошаговая инструкция для iPhone, Android, Windows, macOS. Настройка защищённого канала без терминала через кабинет и Telegram-бота.
3x-ui — это веб-панель для управления прокси-сервером Xray на вашем личном VPS. Она позволяет настраивать конфигурации, создавать пользователей, смотреть статистику и управлять трафиком через удобный веб-интерфейс. С помощью Docker вы можете запустить 3x-ui в изолированном контейнере на вашем личном VPS SANSARA, не затрагивая основную систему. Это полезно тем, кто хочет самостоятельно управлять защищённым каналом на выделенном узле и настраивать клиенты под свои устройства.
Коротко:
- 3x-ui — веб-панель для управления Xray-сервером на вашем VPS.
- Docker — инструмент для запуска приложений в контейнерах, упрощает установку и обновление.
- SANSARA предоставляет личный VPS с готовым подключением: регистрация → данные в кабинете → импорт в клиент.
- Поддерживаются iPhone, Android, Windows, macOS.
- Начать можно без терминала: через кабинет SANSARA и Telegram-бота SANSARA.
- Вся настройка — это развёртывание Docker-контейнера с 3x-ui на вашем личном сервере.
Что это такое и зачем нужно
3x-ui — это веб-интерфейс для управления сервером Xray. Xray — это фреймворк для построения защищённых туннелей и шлюзов, который работает на вашем личном VPS. Панель 3x-ui позволяет:
- Создавать и удалять пользователей.
- Настраивать протоколы и порты.
- Просматривать статистику трафика и подключений.
- Обновлять конфигурации без прямого редактирования файлов.
Запуск 3x-ui в Docker даёт несколько преимуществ:
- Изоляция: приложение работает в контейнере и не влияет на основную систему.
- Простота установки: достаточно запустить готовый образ Docker.
- Лёгкость обновления: обновить версию — значит перезапустить контейнер с новым образом.
В связке с личным VPS SANSARA вы получаете выделенный узел, на котором можете развернуть собственную конфигурацию 3x-ui и подключать к ней свои устройства через клиентское ПО.
Как настроить с SANSARA (пошагово)
Ниже — пошаговая инструкция по развёртыванию 3x-ui в Docker на вашем личном VPS SANSARA. Для обычного пользователя есть путь без терминала через кабинет и Telegram-бота SANSARA, а для тех, кто хочет больше контроля, — вариант с Docker.
Шаг 1. Регистрация и получение личного VPS
- 01Зарегистрируйтесь в SANSARA.
- 02Выберите тариф с личным VPS и одну из доступных локаций (более 9 стран, включая европейские узлы).
- 03После оплаты в кабинете появятся данные подключения: IP-адрес сервера, логин, пароль или токен для импорта в клиент.
На этом этапе у вас уже есть работающий личный VPS с готовым подключением. Для большинства пользователей достаточно импортировать конфигурацию в клиентское приложение и начать пользоваться защищённым каналом.
Шаг 2. Доступ к серверу
Если вы хотите установить 3x-ui самостоятельно, вам понадобится доступ к командной строке вашего VPS:
- Через SSH-клиент (например, на Windows — PuTTY или встроенный SSH в PowerShell; на macOS и Linux — терминал).
- Либо через веб-консоль в кабинете SANSARA, если она доступна.
Войдите на сервер под учётной записью с правами на установку ПО (обычно root или пользователь с sudo).
Шаг 3. Установка Docker (если не установлен)
Проверьте, установлен ли Docker:
`bash docker --version `
Если команда не найдена, установите Docker по официальной инструкции для вашей ОС сервера (обычно Ubuntu/Debian или CentOS/Rocky). Например, для Ubuntu:
`bash
apt update && apt upgrade -y
curl -fsSL https://get.docker.com -o get-docker.sh sh get-docker.sh
usermod -aG docker $USER `
После установки перезапустите сессию SSH или выполните newgrp docker.
Шаг 4. Запуск 3x-ui в Docker
Используйте готовый Docker-образ 3x-ui. Пример команды для запуска:
`bash docker run -d \ --name=3x-ui \ -p 2053:2053 \ -p 2087:2087 \ -v /etc/3x-ui:/etc/3x-ui \ --restart unless-stopped \ misakanetwork/3x-ui:latest `
Пояснение параметров:
- -d — запуск в фоновом режиме.
- --name=3x-ui — имя контейнера.
- -p 2053:2053 и -p 2087:2087 — проброс портов (панель и API).
- -v /etc/3x-ui:/etc/3x-ui — монтирование директории для хранения конфигурации на хосте.
- --restart unless-stopped — автоматический перезапуск при перезагрузке сервера.
- misakanetwork/3x-ui:latest — образ из репозитория (уточните актуальный тег в документации проекта).
После запуска проверьте, что контейнер работает:
`bash docker ps `
Шаг 5. Настройка 3x-ui через веб-интерфейс
- 01Откройте браузер и перейдите по адресу http://ваш-ip-vps:2053.
- 02Первый вход обычно выполняется с логином и паролем по умолчанию (указываются в документации 3x-ui, например admin / admin).
- 03Смените пароль администратора.
- 04Настройте параметры сервера Xray: порты, протоколы, TLS-сертификаты при необходимости.
- 05Создайте пользователя (клиентскую конфигурацию) для подключения с ваших устройств.
Шаг 6. Импорт конфигурации в клиентское приложение
После создания пользователя в 3x-ui вы получите ссылку или QR-код для импорта в клиент:
- На телефоне (iPhone/Android) отсканируйте QR-код через приложение.
- На компьютере (Windows/macOS) импортируйте конфигурационный файл или ссылку.
Подключитесь к своему личному VPS через клиент и проверьте, что трафик идёт через ваш выделенный узел.
Шаг 7. Проверка работы
- В клиенте убедитесь, что статус подключения активен.
- В 3x-ui посмотрите статистику трафика для вашего пользователя.
- Проверьте доступность нужных ресурсов через ваш защищённый канал.
Если что-то не работает, проверьте:
- Состояние контейнера: docker logs 3x-ui.
- Открыты ли порты на VPS (фаервол, правила облачного провайдера).
- Корректность конфигурации в 3x-ui.
Устройства: iPhone, Android, Windows, macOS
3x-ui работает на стороне сервера (ваш личный VPS SANSARA), а на устройствах используются клиентские приложения, совместимые с Xray.
| Устройство | Типичное клиентское приложение | Способ настройки |
|---|---|---|
| iPhone | Приложения из App Store | Импорт по QR-коду или ссылке из 3x-ui |
| Android | Приложения из Play Маркет | Импорт по QR-коду или файлу config |
| Windows | Десктопный клиент | Импорт файла конфигурации или ссылки |
| macOS | Десктопный клиент | Импорт файла конфигурации или ссылки |
После импорта настройки достаточно включить подключение в клиенте, чтобы трафик с устройства шёл через ваш личный VPS.
Практический чек-лист на 7–10 пунктов
- 01Зарегистрируйтесь в SANSARA и получите личный VPS в нужной локации.
- 02Проверьте данные в кабинете: IP, логин, пароль/токен для клиента.
- 03Решите, нужен ли вам Docker: если хотите простой готовый канал — используйте стандартную конфигурацию SANSARA; если хотите управлять сервером сами — разверните 3x-ui.
- 04Установите Docker на VPS, если его нет (только для ручной установки).
- 05Запустите контейнер 3x-ui с правильными портами и томом для конфигов.
- 06Зайдите в веб-панель 3x-ui, смените пароль и настройте сервер.
- 07Создайте пользователя в 3x-ui и получите ссылку/QR-код для импорта.
- 08Импортируйте конфигурацию в клиент на своём устройстве (телефон или компьютер).
- 09Включите подключение в клиенте и проверьте статус.
- 10Следите за статистикой в 3x-ui и при необходимости корректируйте настройки.
FAQ
Нужно ли мне знать Linux и командную строку, чтобы использовать 3x-ui с SANSARA?+
Для стандартного использования личного VPS SANSARA терминал не требуется: вы получаете готовую конфигурацию в кабинете и импортируете её в клиент. Если же вы хотите установить 3x-ui в Docker самостоятельно, то базовые навыки работы с командной строкой и Docker будут полезны.
Можно ли использовать 3x-ui на том же VPS, где уже работает стандартная конфигурация SANSARA?+
Теоретически — да, если порты не конфликтуют и ресурсов сервера хватает. Но на практике проще либо использовать готовую конфигурацию SANSARA, либо развернуть 3x-ui на отдельном VPS, чтобы избежать сложностей с настройкой.
Поддерживает ли SANSARA автоматическое развёртывание 3x-ui через Docker?+
На момент 2026 года SANSARA фокусируется на предоставлении готового защищённого канала через личный VPS с простым импортом в клиент. Установка 3x-ui в Docker — это дополнительная опция для продвинутых пользователей, которая выполняется вручную на стороне сервера.
Что делать, если после настройки 3x-ui подключение не работает?+
Проверьте:
- статус контейнера (docker ps, docker logs 3x-ui),
- открыты ли порты на VPS и в облачной панели,
- корректность конфигурации в 3x-ui,
- правильность импорта в клиент.
При необходимости обратитесь в поддержку вашего VPS-провайдера.
Итог
- Используйте личный VPS SANSARA для развёртывания 3x-ui в Docker, если вам нужен полный контроль над серверной конфигурацией.
- Для большинства пользователей достаточно готового канала SANSARA: регистрация → данные в кабинете → импорт в клиент на iPhone, Android, Windows или macOS.
- Docker упрощает установку и обновление 3x-ui, изолируя её от основной системы.
- Всегда меняйте пароли по умолчанию в панелях управления и используйте актуальные версии ПО.
- Следите за статистикой трафика и состоянием сервера, чтобы вовремя заметить проблемы.
Ещё по теме
Читайте также
CTA · SANSARA
Личный VPS — без терминала и очередей
Регистрация, импорт профиля и стабильный канал на телефон и компьютер. Тот же принцип, о котором мы пишем в блоге — на практике.