basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    КонфигLinuxSSH

    ~/.ssh/config: короткие имена, свой ключ на каждый сервер, прыжок через сервер

    Файл настроек клиента: вместо ssh -i ~/.ssh/id_ed25519 -p 22 [email protected] пишем ssh web1, и то же имя понимают scp, rsync и git. Как и у сервера, действует первое найденное значение — общие настройки Host * ставим в конец.

    Как ssh читает этот файл

    Порядок источников: параметры командной строки, потом ~/.ssh/config, потом общий /etc/ssh/ssh_config. Внутри файла ssh идёт сверху вниз по блокам Host, подходящим к имени, и для каждого параметра берёт первое значение. Поэтому:

    • блоки конкретных серверов — наверху;
    • Host * с общими настройками — последним, иначе он перекроет всё ниже;
    • одно имя может попасть в несколько блоков: web1 подходит и к Host web1, и к Host *.

    Что получилось для конкретного имени, показывает ssh -G: он разбирает файл и печатает итог, никуда не подключаясь.

    Файл — ~/.ssh/config, на Windows — C:\Users\<имя>\.ssh\config. Тильда в путях работает и там.

    Файл по блокам

    Имена серверов и адреса — условные: web1, web2, db1, backup1, адреса — из диапазонов для документации.

    ~/.ssh/config
    Include ~/.ssh/config.d/*

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

    по умолчанию ничего не подключается

    Host web1
        HostName 203.0.113.10
        User example-user
        IdentityFile ~/.ssh/id_ed25519
        IdentitiesOnly yes
    Главное

    Короткое имя вместо адреса, пользователя и ключа. IdentitiesOnly yes — предлагать серверу только этот ключ, а не все из агента подряд: иначе при пяти ключах в агенте сервер с MaxAuthTries 3 порвёт соединение раньше, чем дойдёт до нужного («sshd_config»).

    по умолчанию:User имя на компьютереPort 22IdentitiesOnly no

    Host web2 db1 backup1
        HostName %h.example.org
        User example-user
        IdentityFile ~/.ssh/id_ed25519
        IdentitiesOnly yes

    Несколько имён в одной строке — общие настройки для группы серверов. Адрес у каждого свой, поэтому HostName — в отдельных блоках выше или в config.d. %h — имя, которое написали в команде.

    Host github-infra
        HostName github.com
        User git
        IdentityFile ~/.ssh/github_infra
        IdentitiesOnly yes

    Псевдоним для GitHub с отдельным ключом: deploy key открывает один репозиторий («Конфиги серверов в git», «Каждый ключ и токен — на один доступ»). В git адрес пишем через псевдоним: git@github-infra:example-user/infra-web1.git. Пользователь у GitHub всегда git.

    Host db-internal
        HostName 10.0.0.5
        User example-user
        ProxyJump web1

    Сервер без внешнего адреса — через первый. ProxyJump открывает соединение до web1, а через него — до 10.0.0.5; ключ остаётся на компьютере, на промежуточный сервер он не попадает. В командной строке то же — ssh -J web1 [email protected].

    по умолчанию напрямую

    Host *
        ServerAliveInterval 30
        ServerAliveCountMax 3

    Раз в 30 секунд клиент шлёт серверу пустой пакет; три пропущенных ответа подряд — соединение закрыто. Так NAT домашнего роутера не забывает тихую сессию, а мёртвая не висит минутами.

    по умолчанию:ServerAliveInterval 0 — не слатьServerAliveCountMax 3

        AddKeysToAgent yes

    Ключ с паролем при первом использовании попадает в агент, и пароль больше не спрашивается до конца сеанса агента («ssh-agent»). Нужен работающий агент: на Windows — служба ssh-agent.

    по умолчанию no

        StrictHostKeyChecking ask

    Неизвестный сервер — вопрос yes/no с отпечатком; изменившийся ключ — отказ. accept-new молча принимает только новые серверы, на смену ключа всё равно ругается — подходит для скриптов, которые ходят на свежие машины. В клиенте Ubuntu общий конфиг ещё и хэширует имена в known_hosts (HashKnownHosts yes): файл не выдаёт список серверов, но и читать его глазами нельзя.

    по умолчанию:StrictHostKeyChecking askHashKnownHosts no (в Ubuntu — yes)

    Host web1 web2 db1 backup1
        ControlMaster auto
        ControlPath ~/.ssh/cm/%C
        ControlPersist 10m

    Общее соединение: первое ssh web1 держит канал, следующие ssh, scp, git идут по нему без нового входа — вторая сессия открывается мгновенно. Только Linux и macOS. Каталог ~/.ssh/cm создаём заранее, права 700.

    по умолчанию no

        ForwardAgent yes

    Пересылку агента не включаем ни для Host *, ни для своих серверов: root на сервере может подписывать агентом что угодно, пока сессия открыта. Для прыжка через сервер есть ProxyJump («ssh-agent»).

    по умолчанию no

    Подстановки в значениях

    Код Что подставляется
    %h имя хоста после замены HostName; в строке HostName — имя из команды
    %n имя ровно как написали в команде
    %r пользователь на сервере
    %p порт
    %C хэш от %l%h%p%r — короткое имя для сокета ControlPath
    %d домашний каталог на компьютере

    Если не работает

    Настройка из блока хоста не действует

    Причина
    Выше в файле стоит Host * или другой подходящий блок с той же настройкой — а действует первое значение.
    Делаем
    ssh -G web1 | grep -i <настройка> покажет итог. Блоки конкретных хостов — вверх, Host * — в самый конец.

    Bad owner or permissions on /home/me/.ssh/config

    Причина
    Файл доступен на запись группе или остальным.
    Делаем
    chmod 600 ~/.ssh/config.

    На Windows с ControlMaster соединение не устанавливается

    Причина
    OpenSSH для Windows не умеет общее соединение через Unix-сокет: с любым ControlPath ssh падает — getsockname failed: Not a socket, затем Read from remote host …: Unknown error.
    Делаем
    Блок ControlMaster держим только в конфиге Linux и macOS или под Match exec, который на Windows не срабатывает.

    git clone git@github-infra:… — Could not resolve hostname github-infra

    Причина
    Git запускает ssh, который читает другой конфиг: например, Git for Windows со своим ssh.exe и другим HOME.
    Делаем
    Указываем git, какой ssh брать: git config --global core.sshCommand C:/Windows/System32/OpenSSH/ssh.exe, и проверяем ssh -G github-infra.

    Через ProxyJump — channel 0: open failed: administratively prohibited

    Причина
    На промежуточном сервере AllowTcpForwarding no, а прыжок идёт через проброс.
    Делаем
    Разрешаем проброс на нём: AllowTcpForwarding yes, или хотя бы Match User example-user с этой строкой.

    Как проверить

    ssh -G разбирает файл для имени и печатает итог, не подключаясь. Для web1 из файла выше:

    ssh -G web1 | grep -E '^(hostname|user|port|identityfile|identitiesonly|serveraliveinterval) '
    # user example-user
    # hostname 203.0.113.10
    # port 22
    # identitiesonly yes
    # serveraliveinterval 30
    # identityfile ~/.ssh/id_ed25519

    Прыжок через сервер — какой путь выберет ssh:

    ssh -G db-internal | grep -i '^proxyjump'
    # proxyjump web1

    Псевдоним для git:

    ssh -T github-infra
    # Hi example-user/infra-web1! You've successfully authenticated, but GitHub does not provide shell access.