Hiddify Manager: установка и первичная настройка на сервере

Установка Hiddify Manager начинается не с команды в терминале, а с проверки сервера: панель разворачивается на чистой системе Ubuntu (поддерживаются актуальные LTS-версии), и если на VPS уже крутится веб-сервер, панель хостинга или другой прокси-скрипт, установщик может завершиться с ошибкой или занять нужные порты. Поэтому первое действие — убедиться, что система свежая, а порты 80 и 443 ничем не заняты.

Hiddify Manager — это панель управления прокси-сервером на базе Xray и ряда других ядер. Она автоматизирует выпуск сертификатов, настройку протоколов и выдачу подписок клиентам. Ниже разберём весь путь: от выбора VPS до первого входа в админ-панель, с акцентом на типичные ошибки при развёртывании.

Требования к серверу и подготовка

Перед установкой убедитесь, что сервер соответствует минимальным условиям. Точные системные требования могут меняться от версии к версии, поэтому сверяйтесь с официальной документацией проекта на GitHub. Общие ориентиры таковы: виртуальный сервер с KVM-виртуализацией, свежая Ubuntu LTS, root-доступ по SSH и выделенный внешний IP-адрес без CG-NAT.

Отдельно проверьте сетевую часть. Если VPS находится за NAT провайдера или у него «серый» IP, автоматический выпуск TLS-сертификата не сработает, и панель не сможет нормально обслуживать подключения по HTTPS.

  • 🖥️ Чистая установка Ubuntu актуальной LTS-версии без сторонних панелей и веб-серверов
  • 🌐 Публичный статический IP-адрес и открытые порты 80 и 443
  • 🔑 SSH-доступ с правами root или пользователем с sudo
  • 📦 Обновлённые пакеты системы: выполните apt update && apt upgrade -y до запуска установщика
  • 🧭 Желательно заранее зарегистрировать домен и направить A-запись на IP сервера

Подключение к серверу по SSH

Для подключения с Windows подойдёт PowerShell или Windows Terminal со встроенным OpenSSH-клиентом, с Linux и macOS — обычный терминал. Команда подключения выглядит стандартно:

ssh root@IP_ВАШЕГО_СЕРВЕРА

При первом подключении система попросит подтвердить отпечаток ключа — введите yes. Если вход по паролю отклоняется, проверьте, не требует ли хостер ключевую авторизацию: многие VPS-провайдеры по умолчанию выдают доступ только по SSH-ключу, который нужно добавить при создании сервера.

⚠️ Внимание: не устанавливайте Hiddify Manager поверх production-сервера с сайтами или базами данных. Установщик меняет сетевую конфигурацию, ставит Docker-контейнеры и веб-компоненты — соседние сервисы могут перестать работать.

Запуск скрипта установки

Официальный способ установки — запуск скрипта из репозитория проекта. Актуальную команду всегда берите из официальной документации Hiddify Manager на GitHub, поскольку адреса и параметры могут обновляться. Классический вариант выглядит так:

bash -c "$(curl -Lfo- https://raw.githubusercontent.com/hiddify/Hiddify-Manager/main/common/google_installer.sh)"

Скрипт сам подтянет зависимости, развернёт контейнеры и настроит сервисы. Процесс занимает заметное время — не закрывайте терминал до завершения. По окончании установщик выведет ссылки для входа в админ-панель: сохраните их сразу, они содержат секретный путь.

☑️ Что сделать сразу после установки

Выполнено: 0 / 5

Если скрипт прерывается с ошибкой сети, возможная причина — блокировка доступа к GitHub или Docker Hub с вашего хостинга. В таком случае проверьте доступность этих ресурсов командой curl -I https://github.com и при необходимости воспользуйтесь зеркалами, описанными в документации проекта.

📊 На какой системе вы разворачиваете Hiddify Manager?
Ubuntu 22.04
Ubuntu 24.04
Debian
Другая / ещё не выбрал

Настройка домена и первый вход в панель

Панель может работать в нескольких режимах: с доменом и автоматическим сертификатом, через CDN (например, Cloudflare) или вообще без домена. Режим с собственным доменом — самый предсказуемый: вы создаёте A-запись, указываете домен при установке или в настройках панели, и выпуск сертификата происходит автоматически.

Вход в административную часть выполняется по секретной ссылке вида https://ваш-домен/секретный-путь/, которую выдал установщик. Внутри доступны разделы управления пользователями, протоколами, доменами и подписками. Секретный путь панели — единственный барьер перед управлением сервером: никому его не передавайте и не публикуйте в скриншотах.

Режим работыЧто нужноОсобенности
Прямой доменA-запись на IP сервераАвтоматический TLS, простая схема
CDN-режимДомен через CloudflareСкрывает реальный IP, есть ограничения по протоколам
Relay / без доменаТолько IP сервераПодходит для тестов, сертификаты самоподписанные
Поддомены для подписокОтдельная A-записьРазделение админки и клиентских ссылок
Что делать, если панель не открывается по HTTPS

Проверьте, что DNS-запись уже обновилась (команда nslookup ваш-домен). Убедитесь, что порты 80 и 443 открыты в файрволе хостера — у многих провайдеров есть внешний сетевой экран в личном кабинете. Также проверьте статус сервисов: войдите по SSH и посмотрите логи установки. Если сертификат не выпустился, повторно примените настройки домена в панели после исправления DNS.

Типичные ошибки при установке

Большинство проблем на этапе развёртывания связано не с самой панелью, а с окружением. Разберём частые сценарии и порядок диагностики.

  • 🚫 Скрипт обрывается на скачивании — проверьте доступность GitHub и Docker Hub с сервера, при блокировках используйте варианты установки из документации
  • 🔒 Сертификат не выпускается — возможная причина: DNS ещё не обновился или порт 80 закрыт файрволом хостера
  • 🧩 Панель установилась, но не открывается — проверьте, что вы используете полную секретную ссылку, а не просто домен
  • 🔁 Конфликт портов — на сервере уже работает nginx, Apache или другая панель; установку нужно делать на чистую систему

⚠️ Внимание: не пытайтесь «чинить» неудачную установку ручным удалением контейнеров и пакетов — проще и надёжнее переустановить ОС из панели хостера и запустить скрипт заново на чистой системе.

Обновление и обслуживание панели

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

Полезно настроить регулярное резервное копирование конфигурации: в панели предусмотрен экспорт настроек, который позволит быстро восстановиться при переезде на другой сервер. Также следите за сроком действия домена — его истечение приведёт к полной недоступности панели и подписок.

Часто задаваемые вопросы

Можно ли установить Hiddify Manager на Debian или CentOS?

Официально поддерживаемая и наиболее проверенная платформа — Ubuntu актуальных LTS-версий. На других дистрибутивах установка может пройти с ошибками или потребовать ручной доработки. Рекомендуется использовать именно Ubuntu, как указано в документации проекта.

Обязательно ли нужен домен для установки?

Нет, панель умеет работать и без домена, например в тестовом режиме по IP. Однако для стабильной работы с автоматическими TLS-сертификатами и корректной выдачи подписок собственный домен настоятельно упрощает эксплуатацию.

Установщик выдал ошибку сети — что проверить в первую очередь?

Проверьте доступность GitHub и Docker Hub с сервера командами curl, убедитесь, что DNS-резолвер работает (ping 8.8.8.8 и резолв доменов), а также что хостер не блокирует исходящие соединения. При блокировках используйте альтернативные способы установки из официальной документации.

Как вернуть доступ к панели, если потеряна секретная ссылка?

Ссылку для входа можно восстановить через SSH: в документации проекта описан способ вывода админских ссылок из командной строки сервера. Именно поэтому SSH-доступ нужно хранить надёжно — он является запасным ключом ко всей системе.

Можно ли перенести панель на другой сервер?

Да. Сделайте резервную копию конфигурации в панели, разверните Hiddify Manager на новом VPS, перенесите DNS-записи на новый IP и восстановите настройки из бэкапа. После переноса проверьте работоспособность подписок у клиентов.