176 lines
10 KiB
Markdown
176 lines
10 KiB
Markdown
# Общий SSH-конфиг в локальной сети
|
||
|
||
Добавьте секцию `ssh` к нужному веб-сервису. SSH-адрес по умолчанию берётся из IP
|
||
его `upstream`; при необходимости задайте другой `ssh.host`:
|
||
|
||
```yaml
|
||
services:
|
||
- hostname: pve.home
|
||
upstream: https://192.168.0.137:8006
|
||
upstream_tls_verify: false
|
||
ssh:
|
||
alias: pve
|
||
user: root
|
||
port: 22
|
||
```
|
||
|
||
Выгрузка содержит:
|
||
|
||
```sshconfig
|
||
Host pve pve.home
|
||
HostName 192.168.0.137
|
||
Port 22
|
||
User root
|
||
StrictHostKeyChecking ask
|
||
```
|
||
|
||
`ssh pve` и `ssh pve.home` подключаются **напрямую к VM**, а не к NPM.
|
||
Без этого Include обычное DNS-разрешение `pve.home` возвращает NPM, предназначенный для HTTPS.
|
||
Это не SSH-прокси и не SSH-сервер: на целевой машине должен уже работать `sshd`, а ключи
|
||
авторизации и доступ из LAN на нужный порт настраиваются отдельно.
|
||
|
||
Для машин без веб-сервиса есть независимый список. DNS/Proxy Host для них не создаётся:
|
||
|
||
```yaml
|
||
ssh_hosts:
|
||
- aliases: [backup, backup.lab.internal]
|
||
host: 192.168.0.150
|
||
port: 2222
|
||
user: admin
|
||
```
|
||
|
||
Секция `ssh` необязательна. Если её нет, сервис не включается в выгрузку. `user` тоже
|
||
необязателен: тогда применяется личный SSH-конфиг/имя пользователя ПК. Для отключения
|
||
экспорта одного сервиса используйте `ssh.enabled: false`; `enabled: false` у веб-сервиса
|
||
также исключает его из SSH-конфига. Записи `ssh_hosts` поддерживают собственный `enabled`.
|
||
Алиасы должны быть уникальными, без wildcard, пробелов и управляющих конструкций.
|
||
SSH HostName может быть RFC1918 IPv4 или ULA IPv6.
|
||
|
||
## Адрес выгрузки
|
||
|
||
В `.env` укажите IP **Docker-хоста Homegate**, который может отличаться от IP NPM:
|
||
|
||
```dotenv
|
||
SSH_BIND_IP=192.168.0.10
|
||
SSH_PORT=8099
|
||
```
|
||
|
||
В `config/services.yaml` задайте свою подсеть:
|
||
|
||
```yaml
|
||
allowed_networks:
|
||
- 192.168.0.0/24
|
||
```
|
||
|
||
После `docker compose up -d --build` файл доступен по адресу:
|
||
|
||
```text
|
||
http://192.168.0.10:8099/ssh-config
|
||
```
|
||
|
||
Замените `.10` своим адресом. Список генерируется при каждом запросе из текущего YAML,
|
||
поэтому изменение адреса/порта или удаление SSH-записи отражается сразу и не требует
|
||
доступных Pi-hole/NPM. При невалидной конфигурации сервер возвращает HTTP 503.
|
||
Для просмотра без HTTP можно выполнить `docker compose run --rm homegate ssh-config`;
|
||
эта команда не использует API и не блокирует работающий контроллер.
|
||
|
||
Выгрузка открыта без логина **только разрешённым IP**. Она содержит топологию сети и
|
||
имена пользователей, но не приватные ключи, пароли, CA или SSH host keys.
|
||
Сервер не раздаёт каталоги и игнорирует `X-Forwarded-For` при проверке клиента.
|
||
В контейнер `ssh-export` вообще не монтируются ключ CA и пароли управления.
|
||
|
||
Docker публикует порт на конкретном адресе хоста; это описано в
|
||
[документации Docker](https://docs.docker.com/engine/network/port-publishing/).
|
||
Не пробрасывайте этот порт из WAN и не включайте для него UPnP. Привязка IP и ACL
|
||
не заменяют firewall, если перед сервером стоит NAT, подменяющий внешний IP разрешённым
|
||
LAN-адресом. На Docker Desktop источник может выглядеть иначе, чем на Linux;
|
||
эта конфигурация рассчитана на Linux-хост с сохранением исходного IP клиента.
|
||
|
||
## Подключение на ПК
|
||
|
||
Скопируйте `sync_ssh.py` из проекта на ПК. Нужны Python 3.9+ и OpenSSH;
|
||
дополнительные Python-пакеты не требуются. Первый запуск на Linux/macOS:
|
||
|
||
```sh
|
||
python3 sync_ssh.py http://192.168.0.10:8099/ssh-config --install
|
||
ssh pve
|
||
```
|
||
|
||
На Windows с Python и OpenSSH Client:
|
||
|
||
```powershell
|
||
py -3 sync_ssh.py http://192.168.0.10:8099/ssh-config --install
|
||
ssh pve
|
||
```
|
||
|
||
Скрипт сохраняет отдельный файл `~/.ssh/config.d/homegate.conf`. Флаг `--install` один раз
|
||
добавляет в конец основного `~/.ssh/config` блок `Host *` с `Include` на абсолютный путь
|
||
этого файла. Перед изменением основной файл копируется в `config.before-homegate-*`.
|
||
Повторный запуск не дублирует Include. На Windows используется `.ssh` в профиле пользователя.
|
||
Другой каталог можно задать через `--ssh-dir`; OpenSSH сам должен быть настроен читать
|
||
находящийся там основной конфиг, например через `ssh -F /path/config pve`.
|
||
|
||
Существующие настройки имеют приоритет по правилу первого значения OpenSSH.
|
||
Приватные ключи и `IdentityFile` задавайте в личном конфиге:
|
||
|
||
```sshconfig
|
||
Host pve
|
||
IdentityFile ~/.ssh/id_ed25519_homelab
|
||
IdentitiesOnly yes
|
||
```
|
||
|
||
Этот блок разместите **до** Homegate Include. Если прежде был `Host *` с `User` или
|
||
`Port`, он также имеет приоритет перед загруженными значениями. При необходимости
|
||
переместите весь блок Homegate Include выше общих настроек, сохранив его маркеры.
|
||
Проверить результат без подключения: `ssh -G pve`.
|
||
OpenSSH описывает [порядок применения и Include](https://man.openbsd.org/ssh_config#Include).
|
||
|
||
Скрипт не меняет NTFS ACL на Windows: используйте обычный приватный каталог профиля,
|
||
не общую сетевую папку. Windows-вариант написан на стандартной библиотеке Python,
|
||
но отдельно на Windows не запускался. Symlink основного конфига автоматически не
|
||
перезаписывается: в таком случае добавьте Include вручную и запускайте скрипт без `--install`.
|
||
|
||
## Обновление
|
||
|
||
Для последующих обновлений достаточно той же команды без `--install`:
|
||
|
||
```sh
|
||
python3 sync_ssh.py http://192.168.0.10:8099/ssh-config
|
||
```
|
||
|
||
Обновление атомарное: при ошибке сети или проверок старый файл сохраняется. Удалённые
|
||
SSH-записи исчезают из дополнительного файла при следующем успешном обновлении.
|
||
Основной конфиг и `known_hosts` при обновлении не меняются. Файл на ПК обновляется
|
||
только при запуске скрипта; автоматическое расписание не создаётся.
|
||
На Linux/macOS файл получает права `0600`, каталог — `0700`.
|
||
|
||
Скрипт принимает только `Host`, `HostName`, `Port`, `User` и `StrictHostKeyChecking ask`,
|
||
проверяет значения и заново собирает текст перед записью. Скачанные `ProxyCommand`,
|
||
`Match exec`, вложенные `Include`, глобальные wildcard-настройки и выключение проверки
|
||
SSH host key отклоняются. Первый SSH-вход требует проверки отпечатка ключа
|
||
сервера обычным способом. Скрипт не выполняет скачанный код, не следует HTTP-редиректам
|
||
и не использует прокси из переменных окружения.
|
||
|
||
## HTTPS для загрузки
|
||
|
||
HTTP не защищает список адресов от подмены внутри LAN. Для аутентифицированной загрузки
|
||
добавьте HTTPS Proxy Host через существующий NPM на exporter, включив в `services`:
|
||
|
||
```yaml
|
||
- hostname: config.home
|
||
upstream: http://192.168.0.10:8099
|
||
```
|
||
|
||
Тогда на ПК:
|
||
|
||
```sh
|
||
python3 sync_ssh.py https://config.home/ssh-config --ca-file root-ca.crt --install
|
||
```
|
||
|
||
Это опциональный маршрут; домен должен входить в `domain_zones`.
|
||
NPM применяет LAN ACL к клиенту; exporter должен видеть разрешённый LAN-IP NPM.
|
||
Если Docker NAT показывает другой адрес, настройте сетевой путь или узкое правило
|
||
для этого конкретного адреса, не разрешайте весь Docker subnet без необходимости.
|
||
Проверка HTTPS у скрипта всегда включена. Корневой сертификат берите по доверенному
|
||
каналу из `state/root-ca.crt`. Ни HTTP-, ни HTTPS-вариант не требует логина для скачивания из LAN.
|