Установка OpenCode на свой сервер: термины и чек-лист

Подробности, цифры, термины и чек-лист по теме «Установка OpenCode на свой сервер». Страница справочника целиком: Установка OpenCode на сервер.

Коротко о теме

Установка OpenCode на VPS: команды для OpenCode 2 и 1, Docker-образ ghcr.io, свой OpenAI-совместимый провайдер и веб-интерфейс по паролю.

Подробности по разделам

OpenCode 1 или OpenCode 2: что ставить на сервер

Первую версию оставляют, если на ней уже настроены плагины и конфигурация: документация второй версии содержит отдельный раздел о переезде.

Установка OpenCode на Ubuntu и в Docker

На сервере это касается вашего компьютера: SSH-сессию открывайте из такого терминала, и интерфейс будет отображаться без искажений. Отметьте нагрузку проекта и способ работы

Какие модели подключаются к OpenCode

Любой OpenAI-совместимый API подключается как свой провайдер. В OpenCode 2 это выглядит так: Так подключается и AI Gateway Таймвеб Клауд с оплатой в рублях, и своя модель на GPU через vLLM или Ollama. В OpenCode 1 ключи, добавленные через /connect, лежат в ~/.local/share/opencode/auth.json: этот файл не должен попадать в бэкапы проекта.

Как открыть веб-интерфейс OpenCode на сервере безопасно

В OpenCode 2 работает общий фоновый сервис, а opencode pair печатает адрес, имя пользователя и пароль для веб-интерфейса. Самый спокойный вариант для обеих версий: не публиковать порт вовсе и пробросить его к себе командой ssh -L 4096:127.0.0.1:4096 user@сервер. Если нужен постоянный адрес с HTTPS, поставьте перед OpenCode Caddy и оставьте пароль включённым.

Ключевые цифры

Термины на странице

SSH
SSH это защищённое подключение к серверу через командную строку. Вход по ключу безопаснее, чем по паролю.
GPU
GPU это видеокарта. На сервере её используют для нейросетей, рендера и расчётов.
Ollama
Ollama запускает языковые модели на своём компьютере или сервере одной командой.
Docker
Docker запускает программы в контейнерах: всё нужное для работы упаковано в образ.
VPS
VPS это виртуальный сервер: часть физической машины с выделенными ядрами, памятью и диском и собственной операционной системой.
Root-доступ
Root-доступ это права администратора на сервере: можно ставить любые программы и менять любые настройки.

Что проверить

  1. Выберите конфигурацию по памяти и диску под задачу, процессор обычно вторичен.
  2. Проверьте тип виртуализации: KVM даёт свою систему и гарантированные ресурсы.
  3. Уточните, входит ли IPv4 и сколько стоит трафик сверх пакета.
  4. Храните данные контейнеров в томах.
  5. Закрепляйте версии образов, а не latest.
  6. Ограничьте ресурсы контейнеров, чтобы один не съел весь сервер.

Связанные страницы