Перейти к содержимому

Статья 127 из 141

Гайды

code-server на VPS: VS Code в браузере через Docker, пароль, HTTPS и расширения

code-server — это VS Code, который работает на сервере и открывается в браузере. Редактор, терминал, Git и расширения живут на VPS, а вы подключаетесь с любого компьютера или планшета. Удобно, если нужно писать код или править конфиги прямо на сервере, без локальной среды.

Статья проверена на code-server 4.145.2 (VS Code 1.145.2), ноябрь 2026.

Ресурс Минимум
RAM 1 ГБ, лучше 2 ГБ: расширения вроде Python заметно добавляют
vCPU 2
Диск 2 ГБ плюс ваши проекты
ПО Docker и Docker Compose или Ubuntu для установки скриптом

Для доступа извне нужен поддомен с A-записью на IP сервера (DNS) и Nginx.

Контейнер работает от пользователя coder с UID 1000. Создайте каталоги и отдайте их этому пользователю:

Окно терминала
mkdir -p /opt/code-server/{config,local,project}
cd /opt/code-server
chown -R 1000:1000 config local project
nano compose.yaml
services:
code-server:
image: codercom/code-server:latest
restart: unless-stopped
user: "1000:1000"
ports:
- "127.0.0.1:8080:8080"
volumes:
- ./config:/home/coder/.config
- ./local:/home/coder/.local
- ./project:/home/coder/project
Путь в контейнере Что там
/home/coder/.config code-server/config.yaml с паролем
/home/coder/.local настройки редактора и установленные расширения
/home/coder/project ваши файлы, они же /opt/code-server/project на сервере
Окно терминала
docker compose up -d
docker compose logs

В логе будут строки HTTP server listening on http://0.0.0.0:8080/ и Using password from /home/coder/.config/code-server/config.yaml.

Учтите: редактор видит только подключённые папки. Внутри контейнера нет компиляторов и интерпретаторов, кроме базовых (git, sudo есть, python3 нет). Для разработки на конкретном языке либо соберите свой образ на основе codercom/code-server, либо ставьте code-server скриптом прямо на сервер.

Скрипт сам определяет систему и на Ubuntu ставит deb-пакет с GitHub. Сначала можно посмотреть, что он сделает:

Окно терминала
curl -fsSL https://code-server.dev/install.sh | sh -s -- --dry-run

Установка и запуск как службы от вашего пользователя:

Окно терминала
curl -fsSL https://code-server.dev/install.sh | sh
sudo systemctl enable --now code-server@$USER

Так code-server работает с правами этого пользователя и видит его домашний каталог и все установленные на сервере программы. Не запускайте его от root: создайте обычного пользователя.

При первом запуске code-server создаёт файл config.yaml со случайным паролем:

Окно терминала
cat /opt/code-server/config/code-server/config.yaml

При установке скриптом файл лежит в ~/.config/code-server/config.yaml.

bind-addr: 127.0.0.1:8080
auth: password
password: СЛУЧАЙНЫЙ_ПАРОЛЬ
cert: false

Чтобы задать свой пароль, замените значение password на длинную случайную строку и перезапустите code-server (docker compose restart или sudo systemctl restart code-server@$USER). Сгенерировать пароль:

Окно терминала
openssl rand -base64 24

Вместо открытого пароля можно указать хеш в поле hashed-password, он важнее поля password. Никогда не ставьте auth: none на сервере, доступном из сети.

code-server держит соединение с браузером через WebSocket. Без заголовков Upgrade и Connection редактор откроется, но сразу потеряет связь с сервером.

Конфиг /etc/nginx/sites-available/code-server:

server {
listen 80;
server_name code.example.com;
location / {
proxy_pass http://127.0.0.1:8080/;
proxy_set_header Host $http_host;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection upgrade;
proxy_set_header Accept-Encoding gzip;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/code-server /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d code.example.com

HTTPS обязателен: без него пароль уходит открытым текстом, а часть функций браузера (буфер обмена, service worker для веб-представлений расширений) работает только на защищённых страницах. Подробнее: Let’s Encrypt.

Откройте https://code.example.com, введите пароль из config.yaml и нажмите Submit.

Страница входа code-server

Чтобы сразу открыть нужную папку, добавьте её в адрес: https://code.example.com/?folder=/home/coder/project.

При первом открытии папки VS Code включает Restricted Mode: можно читать и править файлы, но терминал, задачи и часть расширений выключены. Когда вы откроете терминал (Ctrl+`), редактор спросит Do you trust the authors of the files in this folder?. Для своих файлов нажмите Trust Folder & Continue.

code-server с открытой папкой проекта в Restricted Mode

Интерфейс на английском. Русский включается расширением Russian Language Pack: установите его и выполните команду Configure Display Language из палитры Ctrl+Shift+P.

code-server берёт расширения из Open VSX, а не из магазина Microsoft. Большинство популярных расширений там есть, но некоторые фирменные (например, Pylance или Remote-SSH) отсутствуют.

Установить можно на панели Extensions (Ctrl+Shift+X) или из командной строки:

Окно терминала
docker compose exec code-server code-server --install-extension ms-python.python
docker compose exec code-server code-server --list-extensions --show-versions

Проверено: команда установила ms-python.python вместе с зависимостями ms-python.debugpy и ms-python.vscode-python-envs.

Панель Extensions с установленными расширениями Python

При установке скриптом команды те же, только без docker compose exec code-server.

  • В Docker-варианте редактор видит только /opt/code-server/project. Подключайте нужные каталоги отдельными строками в volumes, например - /var/www/site:/home/coder/site, и выдавайте права UID 1000.
  • Не подключайте / и /var/run/docker.sock: это даст полный доступ к серверу всем, кто узнает пароль.
  • Встроенный терминал работает внутри контейнера, а не на хосте.
  • Git настройте внутри code-server: git config --global user.name и user.email, ключи для GitHub держите отдельные, не ключ root сервера.
  • Порт 8080 только на 127.0.0.1. В файрволе оставьте 22, 80 и 443.
  • Пароль длинный и случайный. Терминал в code-server даёт выполнять любые команды, поэтому утечка пароля равна доступу к серверу.
  • Добавьте в Nginx ограничение по IP (allow ВАШ_IP; deny all;) или HTTP Basic Auth.
  • Подключите fail2ban и вход по SSH-ключам на сам сервер.

Docker:

Окно терминала
cd /opt/code-server
docker compose pull && docker compose up -d

При установке скриптом запустите его ещё раз, он поставит новую версию, затем sudo systemctl restart code-server@$USER.

Для бэкапа сохраняйте config (пароль), local (настройки и расширения) и, главное, project:

Окно терминала
tar -czf /root/code-server-$(date +%F).tar.gz -C /opt/code-server config local project

Код лучше дополнительно хранить в Git-репозитории. Про копии вне сервера: бэкапы.

Симптом Причина и решение
Редактор открывается и пишет о потере соединения В Nginx нет заголовков Upgrade и Connection
Контейнер не запускается, permission denied Папки не принадлежат UID 1000. Выполните chown -R 1000:1000 config local project
Пароль не подходит Смотрите актуальный config.yaml, после правки перезапустите контейнер
Терминал не открывается, в строке состояния Restricted Mode Доверьтесь папке: Trust Folder & Continue
Нужное расширение не находится Его нет в Open VSX. Скачайте .vsix и поставьте через --install-extension путь/к/файлу.vsix, если лицензия это позволяет
python3: not found в терминале В образе нет интерпретатора. Соберите свой образ или используйте установку скриптом
Не хватает памяти, процесс убивается Добавьте swap или перейдите на тариф с 2 ГБ RAM