Как подключить VS Code Remote SSH к серверу: пошаговый гайд

Введение

Visual Studio Code с расширением Remote SSH позволяет работать с кодом на удалённом сервере так же удобно, как на локальной машине. Вы получаете полноценную среду разработки: подсветку синтаксиса, отладку, терминал и расширения — всё выполняется на сервере, а интерфейс остаётся локальным. Это особенно полезно при работе с продакшн-серверами, тестовыми стендами или при разработке в команде.

В этом руководстве мы разберём, как настроить подключение к удалённому серверу через SSH в VS Code, начиная с установки необходимых компонентов и заканчивая решением типичных проблем. Инструкция подойдёт как для новичков, так и для опытных пользователей, которые хотят систематизировать знания.

Требования

Прежде чем начать, убедитесь, что у вас есть:

• Локальный компьютер с установленным Visual Studio Code (версия 1.60 или новее).

• Удалённый сервер (физический или виртуальный) с доступом по SSH. Подойдёт любой Linux-сервер (Ubuntu, Debian, CentOS и т.д.) или macOS.

• Права на выполнение команд в терминале сервера (желательно с возможностью sudo).

• Установленный SSH-клиент на локальной машине. В Linux и macOS он есть по умолчанию, в Windows 10/11 можно использовать встроенный OpenSSH или установить Git Bash.

• Базовые знания командной строки.

Шаг 1: Установка расширения Remote SSH

Откройте Visual Studio Code. Перейдите в панель расширений (иконка квадратов слева или сочетание клавиш Ctrl+Shift+X). В поиске введите Remote - SSH. Найдите расширение от Microsoft с названием "Remote - SSH" и нажмите "Установить". После установки перезагрузите VS Code, если потребуется.

Шаг 2: Проверка SSH-клиента на локальной машине

Откройте терминал (в VS Code можно через Ctrl+ `). Выполните команду:

ssh -V

Вы должны увидеть версию OpenSSH. Если команда не найдена, установите клиент:

• Windows: включите компонент "Клиент OpenSSH" в параметрах системы ("Приложения" → "Дополнительные компоненты").

• macOS/Linux: обычно уже установлен. Если нет, установите через пакетный менеджер (sudo apt install openssh-client для Debian/Ubuntu).

Шаг 3: Генерация SSH-ключа (рекомендуется)

Аутентификация по паролю менее безопасна и менее удобна. Создадим пару ключей. В локальном терминале выполните:

ssh-keygen -t ed25519 -C "your_email@example.com"

Нажмите Enter, чтобы сохранить ключ в стандартной папке (~/.ssh/id_ed25519). Можно задать парольную фразу для дополнительной защиты (рекомендуется). После генерации у вас появятся два файла: приватный ключ id_ed25519 и публичный id_ed25519.pub.

Шаг 4: Копирование публичного ключа на сервер

Самый простой способ — использовать утилиту ssh-copy-id. В локальном терминале выполните:

ssh-copy-id username@server_ip

Где username — ваше имя пользователя на сервере, server_ip — IP-адрес или доменное имя. Вас попросят ввести пароль от сервера. После успешного копирования вы сможете входить без пароля.

Если ssh-copy-id недоступна (например, в Windows), скопируйте содержимое публичного ключа вручную и добавьте его в файл ~/.ssh/authorized_keys на сервере.

Шаг 5: Настройка SSH-конфига для удобства

Создайте или отредактируйте файл ~/.ssh/config на локальной машине. Добавьте запись для вашего сервера:

Host myserver
    HostName 192.168.1.100
    User username
    Port 22
    IdentityFile ~/.ssh/id_ed25519

Замените значения на свои. Теперь можно подключаться по короткому имени myserver. Этот же конфиг будет использоваться VS Code.

Шаг 6: Подключение через VS Code

В VS Code нажмите F1 или Ctrl+Shift+P, чтобы открыть командную палитру. Введите Remote-SSH: Connect to Host.... Выберите ваш сервер из списка (если вы настроили конфиг, он появится как myserver). Если конфига нет, выберите "Add New SSH Host..." и введите команду подключения, например ssh username@server_ip.

После выбора хоста VS Code откроет новое окно и начнёт установку VS Code Server на удалённой машине. Это может занять некоторое время. По завершении вы увидите зелёный индикатор в левом нижнем углу с надписью "SSH: myserver".

Шаг 7: Открытие папки на сервере

После подключения нажмите "Open Folder" и выберите директорию на удалённом сервере, с которой будете работать. VS Code загрузит файлы и позволит редактировать их напрямую. Все изменения сохраняются на сервере.

Шаг 8: Установка расширений на удалённом сервере

Некоторые расширения (например, Python, ESLint) должны работать на сервере. VS Code автоматически предложит установить их в удалённом окружении. Вы также можете открыть панель расширений и увидеть две вкладки: "Local" и "SSH: myserver". Устанавливайте нужные расширения во вкладке удалённого сервера.

Шаг 9: Настройка терминала и отладки

Встроенный терминал VS Code автоматически подключается к серверу. Вы можете запускать команды прямо в нём. Для отладки создайте конфигурацию запуска (.vscode/launch.json) в проекте на сервере — она будет работать с удалёнными процессами.

Шаг 10: Использование Port Forwarding

Remote SSH позволяет пробрасывать порты с сервера на локальную машину. Это удобно для доступа к веб-приложениям, запущенным на сервере. В VS Code откройте панель "Ports" (вкладка рядом с терминалом) и добавьте порт, например 3000. Теперь вы можете открыть http://localhost:3000 в браузере и увидеть приложение с сервера.

Типичные ошибки и их решение

Ошибка: "Could not establish connection to ..."

• Проверьте, запущен ли SSH-сервер на удалённой машине (sudo systemctl status ssh).

• Убедитесь, что брандмауэр не блокирует порт 22.

• Проверьте правильность IP-адреса и учётных данных.

Ошибка: "Permission denied (publickey)"

• Убедитесь, что публичный ключ добавлен в ~/.ssh/authorized_keys на сервере.

• Проверьте права доступа: файл authorized_keys должен иметь права 600, папка .ssh — 700.

• Убедитесь, что в конфиге указан правильный приватный ключ.

VS Code Server не устанавливается

• Проверьте наличие свободного места на сервере.

• Убедитесь, что на сервере есть интернет для загрузки компонентов.

• Попробуйте удалить папку ~/.vscode-server на сервере и подключиться заново.

Медленная работа

• Используйте сжатие SSH: добавьте Compression yes в ~/.ssh/config.

• Отключите ненужные расширения на удалённой стороне.

FAQ

Можно ли использовать Remote SSH без пароля? Да, для этого и нужны SSH-ключи. После настройки ключей пароль не потребуется.

Работает ли Remote SSH на Windows-сервере? Да, начиная с версии VS Code 1.60 поддерживается подключение к Windows Server с OpenSSH. Однако большинство пользователей предпочитают Linux.

Где хранятся настройки удалённого сервера? На сервере в папке ~/.vscode-server. Там же хранятся установленные расширения и кэш.

Как переключиться обратно на локальную разработку? Закройте окно с удалённым подключением или выберите "File" → "Close Remote Connection".

Безопасно ли использовать Remote SSH для продакшн-сервера? Да, если вы используете ключи и ограничиваете доступ. Однако для продакшна лучше иметь отдельного пользователя с ограниченными правами.

Итог

Настройка Remote SSH в VS Code занимает немного времени, но значительно упрощает работу с удалёнными серверами. Вы получаете полноценную IDE с доступом к файлам, терминалу и отладке. Следуя шагам, вы сможете быстро организовать удалённое рабочее место. Не забывайте про безопасность: используйте SSH-ключи и регулярно обновляйте компоненты.