Установка

Официальный скрипт — рекомендуемый способ. В процессе установки он генерирует случайные имя пользователя, пароль и путь доступа (базовый веб-путь), настраивает службу и устанавливает команду управления x-ui.

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh)

Чтобы установить конкретную версию, добавьте её тег:

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) v3.4.0

Чтобы установить скользящую dev-сборку (последний предварительный релиз по каждому коммиту из main — не стабильный релиз), передайте dev-latest:

bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh) dev-latest

По завершении запишите выведенные данные для входа и выполните x-ui, чтобы открыть меню управления, а затем переходите к разделу Первый вход.

В конфигурации Compose по умолчанию используется SQLite. Клонируйте репозиторий (или скопируйте его файлы docker-compose.yml и Dockerfile) и запустите:

docker compose up -d

Чтобы запустить со встроенной службой PostgreSQL, раскомментируйте две строки XUI_DB_* в docker-compose.yml и запустите с соответствующим профилем:

docker compose --profile postgres up -d

Предпочитаете готовый образ? Он публикуется в GitHub Container Registry. Образ включает Fail2ban (для ограничений по IP), который блокирует через iptables и поэтому требует NET_ADMIN (а для IPv6 — ещё и NET_RAW); в противном случае блокировки логируются, но никогда не применяются:

docker run -d \
  --cap-add=NET_ADMIN \
  --cap-add=NET_RAW \
  -e XUI_ENABLE_FAIL2BAN=true \
  -v $PWD/db/:/etc/x-ui/ \
  -v $PWD/cert/:/root/cert/ \
  --network=host \
  --restart=unless-stopped \
  --name 3x-ui \
  ghcr.io/mhsanaei/3x-ui:latest

Том db/ хранит базу данных SQLite (/etc/x-ui/x-ui.db), а cert/ — TLS-сертификаты, поэтому ваши данные сохраняются при обновлениях.

Опытные пользователи могут скачать архив релиза для своей архитектуры со страницы релизов, распаковать его и запустить бинарный файл как службу systemd. Установочный скрипт автоматизирует ровно эти шаги, поэтому он предпочтительнее, если только у вас нет особой причины устанавливать вручную.