码桶

发现社区成员的开源项目

main
installation.ru.md5.5 KB
---
title: Развёртывание и установка
summary: Что нужно сделать, чтобы запустить всё с нуля на чистом VPS
order: 1
updated: 2026-07-22
tags: [развёртывание, установка, VPS]
---

## Поддерживаемое окружение

Установочный скрипт в настоящее время поддерживает Ubuntu 20.04/22.04/24.04
и Debian 11/12. Рекомендуется использовать новый VPS, чтобы избежать
конфликтов с уже установленными сервисами.

## Что делает установка

При запуске установочного скрипта последовательно проходят несколько
этапов:

1. **Выбор языка** — сейчас поддерживаются китайский/английский/японский/
   немецкий/русский; после установки и подсказки в терминале, и интерфейс
   панели будут следовать этому выбору
2. **Проверка зависимостей** — подтверждается, что версия Node.js на
   сервере достаточна; если чего-то не хватает, будет показано, как это
   установить
3. **Установка базового прокси-сервиса** — на этом шаге вызывается
   распространённый в сообществе скрипт установки в один клик для
   установки собственно рабочего прокси-сервиса (xray/sing-box);
   NodeNanny не изобретает эту часть заново, а лишь «присматривает» за
   ней
4. **Запись конфигурации** — генерируется `config/config.json`, включая
   пароль панели, адрес привязки и другие настройки
5. **Запуск трёх постоянных процессов через PM2** — `nodenanny-monitor`
   (мониторинг живости), `nodenanny-panel` (веб-панель),
   `nodenanny-pool` (обслуживание резервного пула узлов)

## Об обрыве соединения

Если сервером управляют удалённо по SSH и во время установки соединение
обрывается из-за сетевых помех, сам установочный скрипт спроектирован так,
чтобы не прерываться из-за этого — но всё же надёжнее заранее открыть на
сервере сессию `tmux` или `screen` и запускать установочный скрипт в ней:
тогда после обрыва связи можно выполнить `tmux attach` и продолжить
наблюдать за прогрессом.

## Как открыть панель после установки

По умолчанию панель слушает только локальный адрес (`127.0.0.1`), то есть
по умолчанию вы не можете открыть её в браузере напрямую по публичному IP
сервера — это сознательное решение по безопасности, чтобы панель не
оказалась открытой в интернет сразу после установки. Есть два
распространённых способа её открыть:

- **SSH-туннель**: локально выполните `ssh -L локальный_порт:127.0.0.1:порт_панели ваш_сервер`,
  затем откройте в браузере `http://127.0.0.1:локальный_порт`
- **Настроить обратный прокси Nginx + пароль**: если хотите обращаться
  напрямую по домену/публичному IP, нужно явно задать пароль панели в
  конфигурации и настроить обратный прокси по примеру файла
  `deploy/nginx-nodenanny.conf.example`. Если панель обнаруживает, что
  адрес привязки изменён на нелокальный, а пароль всё ещё пуст, она
  откажется запускаться — это защита от случая «забыли задать пароль и
  оказались открыты в интернет», а не баг.

## Первым делом после установки: убедиться, что все три процесса запущены

```bash
pm2 status
```

Должны отображаться `nodenanny-monitor`, `nodenanny-panel` и
`nodenanny-pool` в статусе `online`. Если какой-то процесс постоянно
перезапускается или находится в состоянии `errored`, посмотрите конкретную
ошибку через `pm2 logs имя_процесса` — это также типичная отправная точка
для поиска неполадок, которая постепенно пополняется как в разделе
«Общие знания о сетях и протоколах», так и здесь.