Главная/ИИ/OpenHands

OpenHands: установка на свой сервер

OpenHands установка на сервер идёт через лаунчер uv или одну команду docker run, после чего веб-интерфейс открывается на порту 3000. Агент выполняет задачи в отдельных контейнерах, поэтому ему нужен Docker, доступ к его сокету и от 4 ГБ памяти.

4 мин чтенияДанные проверены 16 октября 2026

Ответ за 30 секунд

Для одной задачи за раз хватит 2 ядер и 4 ГБ памяти, но песочницы с проектом быстро съедают диск. Ставьте через uv tool install openhands и не публикуйте порт 3000 в интернет: заходите через SSH-туннель.

VPS с root-доступом для Docker, тарифы до 8 ядер и 16 ГБ, почасовая оплата.

Сколько памяти и что нужно серверу для OpenHands

01 · 1 мин

OpenHands: агент, который работает в своей песочнице#

OpenHands: открытая платформа агентов для разработки. В веб-интерфейсе вы ставите задачу, агент пишет код, запускает команды и тесты внутри отдельного контейнера, а вы смотрите за ходом работы. Есть и терминальная версия, и режим без интерфейса для скриптов и CI.

Песочница отличает OpenHands от терминальных агентов вроде Aider: команды агента не выполняются прямо в вашей системе. Цена за это: Docker на сервере и запас памяти и диска под образы.

Инструмент · 1 мин

Сколько памяти и что нужно серверу для OpenHands#

ПараметрПо документации
СистемаLinux (проверено на Ubuntu 22.04), macOS или Windows с WSL
Памятьот 4 ГБ, современный процессор
Dockerобязателен, агенту нужен доступ к сокету
Python3.12 для установки через uv
Порт3000 у веб-интерфейса, в лаунчере не меняется

Какой сервер нужен OpenHands

OpenHands запускает каждую задачу в контейнере, поэтому считаем с запасом на Docker

Сколько разговоров с агентом идёт одновременно
Что агент делает в песочнице
Где работает модель

03 · 1 мин

Установка OpenHands через uv и через docker run#

Через uv (рекомендует документация). Лаунчер сам проверит Docker, скачает образы и поднимет интерфейс:

uv tool install openhands --python 3.12
openhands serve              # веб-интерфейс на порту 3000
openhands serve --mount-cwd  # с текущим каталогом внутри

Обновление: uv tool upgrade openhands --python 3.12. Флаг --gpu пробрасывает видеокарту и требует NVIDIA Container Toolkit, о нём на странице CUDA.

Через Docker напрямую. Команда из документации, где порт привязан только к локальному адресу:

docker run -it --rm --pull=always \
  -e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
  -e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.openhands:/.openhands \
  -p 127.0.0.1:3000:3000 \
  --add-host host.docker.internal:host-gateway \
  --name openhands-app \
  docker.openhands.dev/openhands/openhands:1.8

Версии образов в этой команде меняются с выпусками, берите актуальные из документации. Готового файла docker compose в инструкции нет, но эти же параметры переносятся в compose один к одному. Каталог ~/.openhands подключается в контейнер как /.openhands: это данные OpenHands на сервере, его и копируйте в бэкап.

04 · 1 мин

Как подключить модель к OpenHands#

После первого входа OpenHands требует выбрать провайдера, модель и ввести ключ API. Если нужной модели нет в списке, включите расширенные настройки во вкладке LLM и укажите модель вручную.

Для OpenAI-совместимого API документация даёт простое правило: в поле Custom Model пишете openai/имя-модели, в поле Base URL адрес сервиса. Внутри работает библиотека LiteLLM. Так подключается AI Gateway Таймвеб Клауд с оплатой в рублях за токены и модель на своём GPU через vLLM.

Если модель запущена на том же сервере вне контейнера, используйте адрес host.docker.internal: для этого в команде и стоит параметр --add-host.

05 · 1 мин

Как закрыть OpenHands от чужих на VPS#

OpenHands получает сокет Docker, а это права, сравнимые с правами администратора сервера. Поэтому интерфейс не должен быть доступен из интернета.

  • Привяжите порт к 127.0.0.1, как в команде выше, и подключайтесь туннелем: ssh -L 3000:127.0.0.1:3000 user@сервер, затем откройте http://localhost:3000 у себя.
  • Терминальная версия запускает веб-доступ командой openhands web на порту 12000 и по умолчанию слушает все адреса. Документация советует --host 127.0.0.1 и предупреждает, что веб-интерфейс даёт полный доступ к возможностям агента.
  • Держите на этом сервере только проекты для агента, без чужих данных и боевых ключей.

06 · 1 мин

Вопросы об установке OpenHands#

Можно ли запустить OpenHands через docker compose?

Готового файла в документации нет, но параметры команды docker run (сокет Docker, том ~/.openhands, порт 3000, host.docker.internal) переносятся в compose без изменений.

Как сменить порт OpenHands?

В лаунчере openhands serve порт 3000 не настраивается. При запуске через docker run меняют левую часть параметра -p, например 127.0.0.1:8300:3000.

Нужна ли видеокарта для OpenHands?

Нет, если модель работает у провайдера по API. Видеокарта нужна, только если вы запускаете свою модель или задачи агента используют GPU.

Как подключить OpenHands к OpenAI-совместимому API?

В расширенных настройках LLM укажите модель с префиксом openai/ и адрес сервиса в поле Base URL.

Почему этому можно верить

Как мы проверяли

Требования из документацииРесурсы, порты и команды сверены с официальной документацией, дата проверки указана.
Всё можно повторитьКоманды и расчёты описаны так, что их повторит любой читатель.
Независимый справочникНе связан с разработчиками приложений и провайдерами и пишет о минусах тоже.

Источники цифр на этой странице: VPS и VDS серверы Таймвеб Клауд, timeweb.cloud/services/vds-vps, проверено 14 октября 2026; AI Gateway Таймвеб Клауд, timeweb.cloud/services/ai-gateway, проверено 14 октября 2026; Маркетплейс приложений Таймвеб Клауд, timeweb.cloud/marketplace, проверено 14 октября 2026; Документация OpenHands: локальная установка, docs.openhands.dev/openhands/usage/run-openhands/local-setup, проверено 14 октября 2026; Документация OpenHands: CLI и веб-интерфейс, docs.openhands.dev/openhands/usage/cli/web-interface, проверено 14 октября 2026; Документация OpenHands: GUI-сервер, docs.openhands.dev/openhands/usage/cli/gui-server, проверено 14 октября 2026; Документация OpenHands: OpenAI-совместимые модели, docs.openhands.dev/openhands/usage/llms/openai-llms, проверено 14 октября 2026; NVIDIA Container Toolkit: установка и настройка Docker, docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html, проверено 15 октября 2026.

SBРедакция SelfBase · обновлено 16 октября 2026

Запустите свой сервер за пару минут

Почасовая оплата: тестовый стенд на сутки стоит десятки рублей, а не месячный тариф.

  • NVMe-диски и гарантированная доля процессора
  • Root-доступ и любой софт, от Docker до игровых серверов
  • Маркетплейс: 91 приложение в один клик
  • Бесплатный перенос проекта силами специалистов
Требования

Что посмотреть дальше

AiderАгент без песочницы vLLMСвоя модель с API CUDA и DockerGPU в контейнерах Агенты для кодаКак выбрать