3X-UI Автоматическое Развертывание

Этот репозиторий содержит скрипты для автоматической установки и настройки панели 3X-UI на Ubuntu Linux.

📋 Что включено

• install.sh - Основной скрипт установки 3X-UI и всех необходимых компонентов
• configure-system.sh - Дополнительная настройка системы (swap, SSH, мониторинг)
• quick-start.sh - Пошаговый мастер установки для новичков
• check-status.sh - Проверка статуса системы и служб

🚀 Быстрый старт

Требования

• Ubuntu 20.04 / 22.04 / 24.04 LTS
• Минимум 1GB RAM (рекомендуется 2GB+)
• Минимум 10GB свободного места на диске
• Root доступ или sudo привилегии
• Публичный IP адрес

Установка

Быстрая установка (всё сразу):

git clone https://github.com/StickFun/3xui-deployment.git
cd 3xui-deployment
sudo chmod +x *.sh
sudo ./quick-start.sh

Скрипт quick-start.sh проведёт через все этапы установки в интерактивном режиме.

Пошаговая установка (точечно):

1. Клонируйте репозиторий:

git clone https://github.com/StickFun/3xui-deployment.git
cd 3xui-deployment

2. Дайте права на выполнение скриптам:

sudo chmod +x *.sh

3. Запустите основной скрипт установки:

sudo ./install.sh

Скрипт автоматически:

• Предложит создать нового пользователя со случайным паролем и sudo правами
• Обновит систему
• Установит все необходимые пакеты (fail2ban, htop и др.)
• Настроит firewall (UFW)
• Установит панель 3X-UI
• Применит ваши настройки (если есть)

4. (Опционально) Запустите дополнительную настройку:

sudo ./configure-system.sh

Этот скрипт предложит:

• Отключить IPv6
• Создать swap файл
• Настроить автоматические обновления безопасности
• Усилить безопасность SSH
• Установить инструменты мониторинга

🔧 После установки

Доступ к панели

Панель 3X-UI доступна по адресу:

http://ваш-ip:порт

(порт указан в настройках панели)

Стандартные данные для входа в панель:

• Логин: admin
• Пароль: admin

⚠️ ВАЖНО: Сразу после входа измените логин и пароль!

Данные для SSH доступа: Логин и пароль нового пользователя сохранены в /root/3xui-user-credentials.txt

Управление службой

# Статус службы
systemctl status x-ui

# Остановка
systemctl stop x-ui

# Запуск
systemctl start x-ui

# Перезапуск
systemctl restart x-ui

# Просмотр логов
journalctl -u x-ui -f

# Меню управления
x-ui

Настройка firewall

Скрипт автоматически открывает порты:

• 22 (SSH)
• 2053, 2096 (X-Ray)

Для просмотра статуса:

sudo ufw status

🔐 Настройка SSL сертификата

Скрипт quick-start.sh предлагает создать самоподписанный SSL сертификат.

Вручную можно создать так:

# Создание директории
sudo mkdir -p /etc/x-ui/certs

# Генерация самоподписанного сертификата (действителен 1 год)
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
    -keyout /etc/x-ui/certs/privkey.pem \
    -out /etc/x-ui/certs/fullchain.pem \
    -subj "/C=RU/ST=Moscow/L=Moscow/O=3X-UI/CN=ваш-домен.com"

# Установка прав
sudo chmod 600 /etc/x-ui/certs/privkey.pem
sudo chmod 644 /etc/x-ui/certs/fullchain.pem

Сертификаты будут сохранены в:

• /etc/x-ui/certs/fullchain.pem - сертификат
• /etc/x-ui/certs/privkey.pem - ключ

Подробная инструкция по настройке SSL находится в config/README.md

Мониторинг

Встроенные команды

# Общая статистика системы
htop

# Мониторинг сети
nethogs          # По процессам
iftop -i eth0    # Общий трафик
nload            # Скорость загрузки/отдачи

# Использование дисков
df -h

# Использование памяти
free -h

# Тест скорости интернета
speedtest-cli

Логи

# Логи 3X-UI
journalctl -u x-ui -f

# Логи X-Ray
tail -f /var/log/x-ui/access.log
tail -f /var/log/x-ui/error.log

# Системные логи
journalctl -xe

🔒 Рекомендации по безопасности

1. Используйте нестандартный порт для панели (настраивается в панели 3X-UI)
2. Используйте сильные пароли для панели администратора
3. Сохраните данные SSH пользователя из /root/3xui-user-credentials.txt
4. Используйте SSL/TLS для всех подключений
5. Регулярно обновляйте систему:

   sudo apt update && sudo apt upgrade -y

6. Включите двухфакторную аутентификацию в настройках панели
7. Ограничьте доступ по IP при необходимости через UFW
8. Используйте fail2ban (уже установлен и настроен)

🛠️ Полезные команды

Оптимизация базы данных

sudo systemctl stop x-ui
sudo sqlite3 /etc/x-ui/x-ui.db "VACUUM;"
sudo systemctl start x-ui

Очистка логов

# Очистка старых логов systemd (старше 7 дней)
sudo journalctl --vacuum-time=7d

# Очистка логов X-Ray
sudo truncate -s 0 /var/log/x-ui/*.log

Проверка производительности

# Проверка BBR (должно быть включено)
sysctl net.ipv4.tcp_congestion_control

# Проверка лимитов
ulimit -n

📝 Структура файлов

3xui-deployment/
├── install.sh              # Основной установочный скрипт
├── configure-system.sh     # Дополнительная настройка
├── quick-start.sh          # Пошаговый мастер установки
├── check-status.sh         # Проверка статуса системы
├── restore.sh              # Информация о ручном бэкапе
├── config/                 # Конфигурационные файлы
│   ├── README.md          # Подробная документация
│   ├── nginx-example.conf # Пример конфигурации Nginx
│   └── index.html         # Камуфляжная страница
└── README.md              # Этот файл

❓ Troubleshooting

Панель не открывается

1. Проверьте статус службы:

   sudo systemctl status x-ui

2. Проверьте firewall:

   sudo ufw status

3. Проверьте порт:

   sudo netstat -tulpn | grep 54321

Низкая скорость

1. Проверьте BBR:

   sysctl net.ipv4.tcp_congestion_control

2. Проверьте загрузку CPU:

   htop

3. Проверьте дисковое пространство:

   df -h

Проблемы с SSL

1. Проверьте сертификаты:

   sudo openssl x509 -in /etc/x-ui/certs/fullchain.pem -noout -text

2. Проверьте срок действия:

   sudo openssl x509 -in /etc/x-ui/certs/fullchain.pem -noout -dates

🤝 Вклад

Если у вас есть предложения по улучшению скриптов, создайте Issue или Pull Request.

📄 Лицензия

MIT License

⚠️ Disclaimer

Используйте этот софт ответственно и в соответствии с законодательством вашей страны. Автор не несет ответственности за использование данных скриптов.

📚 Полезные ссылки

• Официальный репозиторий 3X-UI
• Документация X-Ray
• Ubuntu Server Guide

---

Удачи с развертыванием! 🚀