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

Установка LangGraph на свой сервер

Установка LangGraph на сервер бывает двух видов: библиотека внутри вашего Python-сервиса или Agent Server, который команда langgraph build упаковывает в Docker-образ. Agent Server нужны PostgreSQL и Redis, а в проде ещё ключ LangSmith и выход в интернет для проверки лицензии.

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

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

Для своего продукта без лицензионных ключей встраивайте LangGraph в сервис на FastAPI. Если нужны готовые потоки, фоновые запуски и стриминг, соберите Agent Server командой langgraph build и поднимите рядом PostgreSQL и Redis, но учтите требование ключа LangSmith и связь с beacon.langchain.com.

Agent Server, PostgreSQL и Redis на одном VPS с NVMe и почасовой оплатой.

Сколько ресурсов нужно LangGraph-серверу

01 · 1 мин

Два способа запустить LangGraph на VPS#

LangGraph это фреймворк для агентов в виде графа: шаги, переходы, состояние и паузы для проверки человеком. На сервер его ставят одним из двух способов.

СпособЧто получаетеЧто нужно
Библиотека в своём сервисеПолный контроль, никаких ключей платформыСвой API на FastAPI, хранилище состояния (например, PostgreSQL)
Agent ServerГотовый API: ассистенты, потоки, фоновые запуски, стриминг, долговременная памятьDocker-образ из langgraph build, PostgreSQL, Redis, ключ LangSmith

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

02 · 1 мин

Команды langgraph dev, build и dockerfile#

Утилита ставится командой pip install langgraph-cli и требует Python 3.11 или новее. Настройки проекта лежат в langgraph.json.

  • langgraph dev: лёгкий сервер для разработки без Docker, по умолчанию на порту 2024, состояние хранится в локальной папке. Нужен пакет langgraph-cli[inmem].
  • langgraph build -t my-image: собирает Docker-образ API-сервера на базе langchain/langgraph-api.
  • langgraph dockerfile: выводит Dockerfile по вашему конфигу, если сборку нужно настроить вручную.
  • langgraph up: запускает сервер локально в Docker вместе с базой.

Версию Python в образе задаёт поле python_version: допустимы 3.11, 3.12 и 3.13, по умолчанию 3.11.

03 · 1 мин

Docker Compose для LangGraph Agent Server#

  1. Соберите образ: langgraph build -t my-agent.
  2. Создайте .env с LANGSMITH_API_KEY и ключами моделей.
  3. Запустите compose-файл ниже: он взят из документации, но порт базы не публикуется, а пароль заменён.
services:
  langgraph-redis:
    image: redis:6
  langgraph-postgres:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: сменить-пароль
    volumes:
      - langgraph-data:/var/lib/postgresql/data
  langgraph-api:
    image: my-agent
    ports:
      - "127.0.0.1:8123:8000"
    env_file: .env
    environment:
      REDIS_URI: redis://langgraph-redis:6379
      DATABASE_URI: postgres://postgres:сменить-пароль@langgraph-postgres:5432/postgres?sslmode=disable
    depends_on:
      - langgraph-redis
      - langgraph-postgres
volumes:
  langgraph-data:

PostgreSQL хранит ассистентов, потоки, запуски, состояние графа и очередь фоновых задач. Redis работает брокером, через который сервер стримит ответы фоновых запусков. Чекпойнты можно вынести в MongoDB, но PostgreSQL всё равно остаётся обязательным.

04 · 1 мин

Что нужно LangGraph Agent Server кроме Docker#

Если эти условия не подходят, остаётся первый путь: граф внутри своего сервиса на FastAPI и чекпойнтер PostgreSQL из пакета langgraph-checkpoint-postgres.

  • Ключ. Сервер получает LANGSMITH_API_KEY или лицензионный LANGGRAPH_CLOUD_LICENSE_KEY; лицензия проверяется один раз при старте.
  • Исходящий доступ к beacon.langchain.com. Через него идут проверка лицензии и отчёты об использовании, если сервер не в изолированном режиме.
  • Масштаб. Docker документация называет вариантом для разработки и небольших нагрузок, для прода рекомендует Kubernetes с официальным Helm-чартом.
  • Не бессерверные платформы. Масштабирование до нуля может потерять задачи.

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

Сколько ресурсов нужно LangGraph-серверу#

Agent Server, PostgreSQL и Redis на одной машине работают постоянно, даже без запросов. Диск растёт вместе с историей потоков и долговременной памятью агентов, а процессор нужен под параллельные фоновые запуски.

Какой сервер взять под LangGraph

Оценка редакции для Agent Server с PostgreSQL и Redis на одной машине

Сколько истории хранить
Сколько запусков одновременно
Где модель

06 · 1 мин

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

Нужен ли LangGraph ключ LangSmith на своём сервере?

Для Agent Server да: он стартует с LANGSMITH_API_KEY или лицензионным ключом. Если LangGraph работает как библиотека внутри вашего сервиса, ключ платформы не нужен.

Чем langgraph dev отличается от langgraph up?

langgraph dev запускает лёгкий сервер без Docker с перезагрузкой кода и состоянием в локальной папке. langgraph up поднимает API-сервер в Docker вместе с базой, ближе к тому, что будет на сервере.

Можно ли хранить состояние LangGraph в MongoDB?

Чекпойнты можно: в langgraph.json задаётся бэкенд mongo. Остальные данные Agent Server всё равно держит в PostgreSQL.

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

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

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

Источники цифр на этой странице: VPS и VDS серверы Таймвеб Клауд, timeweb.cloud/services/vds-vps, проверено 14 октября 2026; Маркетплейс приложений Таймвеб Клауд, timeweb.cloud/marketplace, проверено 14 октября 2026; Документация LangSmith: автономный Agent Server в Docker, docs.langchain.com/langsmith/deploy-standalone-server, проверено 14 октября 2026; Документация LangSmith: LangGraph CLI, docs.langchain.com/langsmith/cli, проверено 14 октября 2026.

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

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

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

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