Установка LangGraph на свой сервер
Установка LangGraph на сервер бывает двух видов: библиотека внутри вашего Python-сервиса или Agent Server, который команда langgraph build упаковывает в Docker-образ. Agent Server нужны PostgreSQL и Redis, а в проде ещё ключ LangSmith и выход в интернет для проверки лицензии.
Ответ за 30 секунд
Для своего продукта без лицензионных ключей встраивайте LangGraph в сервис на FastAPI. Если нужны готовые потоки, фоновые запуски и стриминг, соберите Agent Server командой langgraph build и поднимите рядом PostgreSQL и Redis, но учтите требование ключа LangSmith и связь с beacon.langchain.com.
Agent Server, PostgreSQL и Redis на одном VPS с NVMe и почасовой оплатой.
Сколько ресурсов нужно LangGraph-серверу8123порт Agent Server в примере compose
2024порт langgraph dev
3.11Python в образе по умолчанию
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#
- Соберите образ:
langgraph build -t my-agent. - Создайте .env с
LANGSMITH_API_KEYи ключами моделей. - Запустите 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.
Запустите свой сервер за пару минут
Почасовая оплата: тестовый стенд на сутки стоит десятки рублей, а не месячный тариф.
- NVMe-диски и гарантированная доля процессора
- Root-доступ и любой софт, от Docker до игровых серверов
- Маркетплейс: 91 приложение в один клик
- Бесплатный перенос проекта силами специалистов