SSH-доступ к серверу
Подключайтесь к своей машине по имени, даже за NAT
Для домашнего сервера, рабочей машины или GPU-сервера: подключайтесь через CLI, используя свой аккаунт xTunnel и привычный OpenSSH.

Что понадобится

Установите xTunnel на сервер и на свой компьютер. Нужны один аккаунт xTunnel и активная лицензия тарифа «Личный» или «Профессиональный», активированная на сервере. Бесплатный тариф не включает SSH.

На сервере должен работать обычный SSH-сервер. На Linux используйте существующий sshd; в macOS включите «Удалённый вход» в настройках общего доступа. На компьютере нужен OpenSSH-клиент. xTunnel не устанавливает SSH-сервер и не создаёт пользователей ОС.

1. Подключите сервер

Запустите xtunnel без аргументов. Выберите SSH → Share this machine, активированную лицензию и имя машины, например gpu-dev. Войдите в свой аккаунт по ссылке и коду из терминала.

По ссылке из терминала откроется страница входа. Введите одноразовый код, который показал клиент xTunnel, и войдите в свой аккаунт.

Страница авторизации xTunnel: поле для одноразового кода из терминала
Окно авторизации в браузере. Код нужно взять из своего терминала.

Если у сервера нет браузера, откройте ссылку на своём компьютере. Для запуска из командной строки:

xtunnel access register --name gpu-dev
xtunnel access serve

Оставьте агент работающим: он поддерживает соединение с xTunnel. После перезапуска достаточно xtunnel access serve — повторная регистрация и вход не нужны. Для постоянной работы запускайте агент через сервисный менеджер своей ОС.

2. Подключитесь со своего компьютера

Запустите xtunnel и выберите SSH → Connect to a server. Войдите в тот же аккаунт, выберите машину и укажите пользователя ОС на сервере. Либо выполните:

xtunnel access login
xtunnel access list
xtunnel ssh ubuntu@gpu-dev

ubuntu — существующий пользователь Linux, gpu-dev — имя зарегистрированной машины. Для Mac подставьте имя своего пользователя macOS. Учётная запись xTunnel и пользователь ОС — разные вещи.

3. Используйте свой SSH-ключ или пароль

OpenSSH использует привычные ключи и ssh-agent либо запросит пароль, если это разрешено SSH-сервером. Например, с конкретным ключом:

xtunnel ssh ubuntu@gpu-dev -i ~/.ssh/id_ed25519

Пользовательские SSH-ключи и пароли не загружаются в xTunnel и не хранятся на платформе. OpenSSH проверяет ключ сервера при подключении. Приватный режим не открывает публичный TCP-порт: для доступа требуется ваш аккаунт и обычная SSH-аутентификация.

Пример успешного подключения

После входа откроется обычный терминал удалённой машины. В примере ниже подключение выполнено с Mac к Ubuntu-серверу с GeForce RTX 3090. Команда whoami показывает пользователя, а nvidia-smi — видеокарту и запущенные на ней процессы.

Результат SSH-подключения: пользователь georgy и вывод nvidia-smi с GeForce RTX 3090
На скриншоте пользователь сервера — georgy. В командах выше используется ubuntu: подставьте имя своего пользователя ОС.

Нажмите на скриншот, чтобы открыть его в полном размере. Для сервера без NVIDIA проверять подключение через nvidia-smi не требуется.

Файлы и привычный SSH-клиент

Для ssh, scp, sftp и rsync сгенерируйте профиль OpenSSH:

xtunnel access ssh-config ubuntu@gpu-dev

Добавьте выведенный блок в ~/.ssh/config и используйте имя из строки Host. Профиль не содержит SSH-ключей и паролей.

Если подключение не получилось

Машина offline: проверьте, что агент xtunnel access serve запущен и сервер имеет доступ в интернет.
Connection refused: проверьте, что sshd слушает порт 22; на Mac включите «Удалённый вход». Для другого порта при регистрации укажите --local localhost:2222.
Permission denied: проверьте пользователя ОС и его SSH-ключ или пароль.
Лицензия недоступна: активируйте платную лицензию на сервере и войдите в аккаунт, которому она принадлежит.

Агент можно запускать и в контейнере: SSH через Docker. Подключение выполняется с помощью CLI на вашем компьютере.

Вход / Регистрация