Полное руководство по установке 3x-ui в Docker в 2026 году

В современном мире управления криптовалютными узлами всё больше пользователей ищут простые и надежные решения. Одним из таких решений является 3x-ui — современный и удобный интерфейс для мониторинга и управления Bitcoin- и Lightning-узлами. В этой статье мы подробно расскажем, как установить 3x-ui в Docker, настроить его и обеспечить стабильную работу на практике.

---

Что такое 3x-ui и зачем он нужен?

3x-ui — это графический интерфейс пользователя (GUI), предназначенный для упрощения работы с Bitcoin- и Lightning-узлами. Он предоставляет удобную панель для мониторинга, управления каналами Lightning, просмотра транзакций и настройки узла без необходимости работы через командную строку.

Преимущества 3x-ui:

• Интуитивный интерфейс
• Быстрая установка и настройка
• Возможность управлять несколькими узлами
• Поддержка современных криптографических протоколов

В 2026 году использование 3x-ui особенно актуально для тех, кто ценит удобство и безопасность, а также хочет минимизировать время на техническое обслуживание.

---

Почему Docker — лучший выбор для установки 3x-ui?

Docker позволяет изолировать приложение от основной системы, облегчает обновление и масштабирование. В случае с 3x-ui это дает:

• Быструю и чистую установку
• Возможность легко переносить конфигурации
• Обеспечение стабильной работы независимо от системы хоста
• Легкое обновление до новых версий

В этом руководстве мы покажем, как установить 3x-ui в Docker на сервере с Linux.

---

Предварительные требования

Перед началом убедитесь, что у вас есть:

• Сервер с ОС Linux (например, Ubuntu 22.04 или более новая)
• Установленный Docker и Docker Compose
• Доступ к командной строке с правами администратора
• Ваша Bitcoin-нод или доступ к удаленному узлу (например, LND, c-lightning, Bitcoin Core)

Шаг 1. Установка Docker и Docker Compose

Если Docker еще не установлен, выполните следующую команду:

`bash sudo apt update sudo apt install -y docker.io `

Убедитесь, что Docker работает правильно:

`bash sudo systemctl start docker sudo systemctl enable docker docker --version `

Для Docker Compose:

`bash sudo apt install -y docker-compose docker-compose --version `

Шаг 2. Создание директории для проекта

Создайте папку, где будет храниться конфигурация и файлы контейнера:

`bash mkdir -p ~/3x-ui-docker cd ~/3x-ui-docker `

Шаг 3. Создание файла docker-compose.yml

Создайте файл docker-compose.yml со следующим содержимым:

`yaml version: '3.8'

services: 3x-ui: image: ghcr.io/3x-ui/3x-ui:latest container_name: 3x-ui restart: unless-stopped ports:

• "8080:8080" # порт для доступа к интерфейсу

environment:

• NODE_TYPE=ln # или bitcoin, в зависимости от типа узла
• RPC_HOST=host.docker.internal # адрес вашего биткоин-узла
• RPC_PORT=8332 # порт RPC
• RPC_USER=ваш_пользователь
• RPC_PASS=ваш_пароль
• LIGHTNING_HOST=localhost # хост Lightning узла
• LIGHTNING_PORT=9735 # порт Lightning
• LIGHTNING_MACAROON=путь_к_macaroon

volumes:

• ./config:/app/config # папка для конфигурационных файлов
• /path/to/your/bitcoin/data:/root/.bitcoin # если нужно подключить данные биткоина

`

Обратите внимание:

• Замените RPC_HOST, RPC_PORT, RPC_USER, RPC_PASS на параметры вашего Bitcoin-узла.
• Настройте параметры Lightning, если используете Lightning-узел, например, LND или c-lightning.

Шаг 4. Конфигурация подключения к узлу

Создайте или отредактируйте файл конфигурации в папке ./config, например, settings.yaml:

`yaml node: type: ln # или bitcoin rpc: host: "host.docker.internal" port: 8332 user: "ваш_пользователь" pass: "ваш_пароль" lightning: host: "localhost" port: 9735 macaroon_path: "/path/to/admin.macaroon" `

Убедитесь, что пути к macaroon-файлам правильные и доступны внутри контейнера.

Шаг 5. Запуск контейнера

В директории с файлом docker-compose.yml выполните команду:

`bash docker-compose up -d `

Это запустит контейнер в фоновом режиме. Через несколько минут интерфейс станет доступен по адресу:

`

`

Шаг 6. Первоначальная настройка и проверка

Откройте браузер и перейдите по адресу:

` http://<IP-адрес вашего сервера>:8080 `

Вы увидите панель управления 3x-ui. Введите необходимые данные, если потребуется, и убедитесь, что:

• Узел подключен корректно
• Можно просматривать баланс, транзакции и каналы Lightning
• Можно управлять каналами и мониторить их состояние

Шаг 7. Обеспечение безопасности и автоматического запуска

Для защиты интерфейса рекомендуется настроить HTTPS, например, через обратный прокси с Let's Encrypt. Также стоит настроить автоматический запуск контейнера при старте системы:

`bash docker-compose start `

или:

`bash sudo systemctl enable docker `

Итоги

Вы успешно установили и настроили 3x-ui в Docker в 2026 году. Теперь у вас есть современный и удобный инструмент для управления Bitcoin- и Lightning-узлами. Регулярно обновляйте контейнеры и следите за безопасностью своей инфраструктуры.

---

Дополнительные советы

• Обновляйте образ 3x-ui командой:

`bash docker-compose pull docker-compose up -d `

• Используйте VPS или защищенные сети для доступа к интерфейсу.
• Регулярно делайте резервные копии конфигурационных файлов и данных.

Если возникнут сложности — обращайтесь к официальной документации или сообществу 3x-ui и Docker.

---

Установка 3x-ui в Docker — это быстрый и надежный способ обеспечить удобное управление криптовалютными узлами. Следуя данной инструкции, вы сможете настроить свою систему максимально эффективно и безопасно в 2026 году.