Настройка SSL-прокси nginx для Home Assistant через личный VPS (2026)

Чтобы получить безопасный доступ к Home Assistant извне, настройте на своём личном VPS nginx как SSL-прокси. После регистрации в SANSARA вы получаете данные подключения в кабинете, импортируете их в клиент и запускаете защищённый канал к своему умному дому. Всё работает без терминала для обычного пользователя и поддерживает iPhone, Android, Windows и macOS.

Коротко:

• На личном VPS SANSARA вы ставите nginx и Let’s Encrypt, получаете SSL-сертификат и настраиваете обратный прокси для Home Assistant.
• Доступ к Home Assistant идёт через HTTPS с вашим доменом, а не по IP-адресу или локальной сети.
• Подключение работает через выделенный узел SANSARA в одной из 9+ стран (Европа и другие локации).
• Вы управляете доступом через Telegram-бота SANSARA и кабинет, где видны статус канала и статистика.
• Клиенты для iPhone, Android, Windows и macOS подключаются к вашему личному серверу одним импортом конфигурации.

Что это и кому подходит

nginx — популярный веб-сервер, который часто используют как обратный прокси: он принимает HTTPS-запросы из интернета и пересылает их на внутренний сервис, например Home Assistant. SSL-прокси означает, что весь трафик шифруется с помощью SSL/TLS-сертификата (обычно от Let’s Encrypt).

Такая схема подходит:

• Если вы хотите зайти в Home Assistant извне безопасно, без открытия портов на домашнем роутере.
• Если нужен красивый домен для Home Assistant вместо IP-адреса.
• Если вы уже используете личный VPS SANSARA как шлюз для других сервисов и хотите добавить умный дом.

Вместо того чтобы настраивать всё вручную на домашней сети, вы поднимаете прокси на своём личном сервере SANSARA и направляете трафик через защищённый канал.

Как настроить по шагам (с личным VPS SANSARA)

1. 01Получите личный VPS и данные подключения

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

1. 01Зарегистрируйте домен и настройте DNS

Купите домен у любого регистратора. В панели DNS укажите A-запись для поддомена (например, home.example.com), которая ведёт на IP-адрес вашего личного VPS SANSARA.

1. 01Установите nginx и Certbot на VPS

Подключитесь к VPS по SSH (если нужно) или используйте готовый образ с предустановленным ПО, если SANSARA его предоставляет. Установите nginx и certbot (клиент Let’s Encrypt):

`bash sudo apt update sudo apt install nginx certbot python3-certbot-nginx `

1. 01Получите SSL-сертификат

Запустите Certbot для вашего домена:

`bash sudo certbot --nginx -d home.example.com `

Certbot автоматически настроит nginx, добавит редирект с HTTP на HTTPS и обновит конфигурацию.

1. 01Настройте обратный прокси для Home Assistant

Отредактируйте конфигурацию сайта в /etc/nginx/sites-available/home.example.com:

`nginx server { listen 80; server_name home.example.com; return 301 https://$server_name$request_uri; }

server { listen 443 ssl; server_name home.example.com;

ssl_certificate /etc/letsencrypt/live/home.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/home.example.com/privkey.pem;

location / { proxy_pass http://ВАШ_ДОМАШНИЙ_IP:8123; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } `

Вместо ВАШ_ДОМАШНИЙ_IP укажите внутренний IP Home Assistant в вашей домашней сети.

1. 01Включите сайт и перезапустите nginx

`bash sudo ln -s /etc/nginx/sites-available/home.example.com /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl reload nginx `

1. 01Настройте Home Assistant

В configuration.yaml добавьте или проверьте блок для доверенных прокси и базовый URL:

`yaml http: use_x_forwarded_for: true trusted_proxies:

• IP_ВАШЕГО_VPS_SANSARA

base_url: https://home.example.com `

Перезапустите Home Assistant.

1. 01Проверьте доступ

Откройте https://home.example.com в браузере. Должна загрузиться страница входа Home Assistant по HTTPS с вашим доменом.

Вся связь идёт через выделенный узел SANSARA, а не через общий пул. Статус канала можно отслеживать в кабинете и через Telegram-бота SANSARA.

Устройства: iPhone, Android, Windows, macOS

После настройки SSL-прокси Home Assistant доступен из любого места через ваш личный сервер.

• iPhone, Android: в официальном приложении Home Assistant укажите внешний URL https://home.example.com. Если нужно, добавьте параметры для работы через ваш защищённый канал SANSARA.
• Windows, macOS: откройте браузер и перейдите по https://home.example.com. Если вы используете клиент SANSARA, сначала подключитесь к своему личному VPS, затем откройте Home Assistant.

На всех платформах подключение выглядит как обычный HTTPS-сайт, но трафик идёт через ваш выделенный узел SANSARA.

Частые ошибки и как их избежать

• Неверный IP в proxy_pass

Убедитесь, что в proxy_pass указан правильный внутренний IP Home Assistant. Проверьте его в настройках роутера или в самом Home Assistant.

• Проблемы с trusted_proxies в Home Assistant

Если Home Assistant не доверяет заголовкам от nginx, добавьте IP вашего VPS SANSARA в trusted_proxies. Без этого могут не работать автоматизации, зависящие от IP-адреса.

• Забыли включить сайт в nginx

После создания конфига в sites-available не забудьте симлинк в sites-enabled и nginx -t для проверки синтаксиса.

• DNS-кэш

После изменения DNS подождите несколько минут или часов. Если домен не резолвится, проверьте записи в панели регистратора.

• Блокировка портов

Убедитесь, что на вашем VPS открыты порты 80 и 443 для входящих подключений. В SANSARA обычно это настраивается автоматически, но можно проверить в кабинете.

FAQ

Итог

• Зарегистрируйтесь в SANSARA, получите личный VPS и импортируйте конфигурацию в клиент.
• Настройте домен, установите nginx и Let’s Encrypt на VPS, создайте SSL-прокси для Home Assistant.
• Укажите внешний HTTPS-URL в настройках Home Assistant и клиентах на iPhone, Android, Windows, macOS.
• Проверьте доступ через браузер и приложения, отслеживайте статус канала в кабинете и через Telegram-бота SANSARA.
• Регулярно обновляйте сертификаты и следите за логами nginx при проблемах.