Troubleshooting

Решение частых проблем с панелью и нодами

Нода не подключается

Проверьте:

Порт открыт: по умолчанию нода слушает на порту 2222. Убедитесь, что firewall пропускает TCP-трафик.

Bash

# Проверка порта
ss -tlnp | grep 2222
 
# Открыть в ufw
ufw allow 2222/tcp

DNS резолвится: с сервера ноды домен панели должен резолвиться.

Bash

nslookup aezaspb.towersflowerss.com

Логи ноды: проверьте подключение к панели.

Bash

docker logs v2raytunpanel-node-nl-vless --tail 20

mTLS-сертификат: если сертификат повреждён, удалите ноду в панели и создайте заново.

SSL-сертификат не выпускается

Caddy использует Let's Encrypt с автоматическим выпуском. Частые причины:

DNS A-запись не указывает на IP сервера
Порт 80 или 443 заняты другим сервисом
Cloudflare proxy включён (Caddy нужен прямой доступ для ACME challenge)

Bash

# Проверить логи Caddy
docker logs v2raytunpanel-caddy --tail 30
 
# Проверить порты
ss -tlnp | grep -E ':80|:443'

AWG: Protocol not supported

AmneziaWG требует kernel module amneziawg. Если хостинг не предоставляет kernel headers, модуль не соберётся.

Bash

# Проверить наличие модуля
lsmod | grep amneziawg
 
# Установить (если есть headers)
apt-get install linux-headers-$(uname -r) dkms
# Затем собрать из https://github.com/amnezia-vpn/amneziawg-linux-kernel-module

Альтернатива: используйте VLESS Reality или Hysteria2.

Frontend unhealthy

Bash

# Проверить статус
docker ps --format '{{.Names}} {{.Status}}' | grep frontend
 
# Перезапустить
docker restart v2raytunpanel-frontend
 
# Логи
docker logs v2raytunpanel-frontend --tail 20

Конфликт портов

Если на сервере уже есть Caddy, nginx или другой reverse-proxy:

Bash

# Найти что занимает порт
ss -tlnp | grep :443
 
# Остановить системный caddy
systemctl stop caddy && systemctl disable caddy

Контейнер backend не стартует

Bash

# Проверить зависимости
docker logs v2raytunpanel-backend --tail 30
 
# Частая причина: PostgreSQL не готов
docker restart v2raytunpanel-backend

Сброс пароля admin

Используйте прямой запрос к БД:

Bash

docker exec -it v2raytunpanel-postgres psql -U v2raytun -d v2raytunpanel -c \
  "UPDATE admins SET password_hash = '...' WHERE username = 'admin';"

Или пересоздайте первого админа через /register (если других нет).