В повседневной работе любого разработчика, системного администратора или технической команды накапливаются десятки скриптов: парсеры цен конкурентов, выгрузки остатков на маркетплейсы, синхронизация баз данных, триггерные рассылки и цепочки обращений к языковым моделям (LLM). Обычно эти скрипты запускаются через системный cron на сервере, не имеют интерфейса для менеджеров, не сохраняют историю выполнения и тихо падают без уведомлений. В то же время тяжеловесные оркестраторы вроде Apache Airflow или Temporal требуют сложной инфраструктуры и гигабайтов оперативной памяти, а no-code платформы вроде n8n часто неудобны для написания чистого кода со сложной логикой.
Windmill — это сверхбыстрая платформа оркестрации и автоматизации рабочих процессов, распространяемая с открытым исходным кодом (Open Source, лицензия AGPLv3 для Community Edition). Она решает задачу запуска скриптов принципиально иначе: вы пишете стандартную функцию на Python, TypeScript, Go, Bash или SQL, а Windmill автоматически анализирует её сигнатуру типов и на лету генерирует удобный веб-интерфейс с полями ввода, валидацией и кнопками запуска. Кроме того, платформа предоставляет распределенные воркеры с песочницей nsjail, визуальный конструктор конвейеров (Flows), планировщик расписаний и глубокую интеграцию с LLM и Telegram-ботами. В этом практическом руководстве мы разберем развертывание Windmill в Docker Compose, настройку обратного прокси Nginx с WebSocket и SSL, создание автогенерируемых интерфейсов, связку с языковыми моделями и резервное копирование в S3.
1. Архитектура Windmill: почему Rust-платформа быстрее n8n, Airflow и Temporal
Ключевое отличие Windmill от большинства платформ автоматизации — его технологический фундамент. Ядро сервера и планировщика написано на Rust, что по официальным бенчмаркам обеспечивает задержку старта задач менее 15 миллисекунд и низкое потребление оперативной памяти.
| Критерий | Apache Airflow | n8n (Node.js) | Windmill (Rust) |
|---|---|---|---|
| Потребление памяти | От 4–8 ГБ RAM (тяжелый стек Python/Celery) | От 1–2 ГБ RAM (Node.js рантайм) | 150–300 МБ RAM на сервис ядра (Rust) |
| Подход к разработке | Строго код (DAGs на Python) | Визуальные ноды (Low-code/No-code) | Code-first: код на Python/TS/Bash + авто-UI |
| Интерфейс для операторов | Сложный дашборд для инженеров | Базовые вебхук-формы | Полноценные автогенерируемые веб-формы и дашборды |
| Изоляция исполнения | Отдельные контейнеры или Celery | Единый процесс или sub-process | Изоляция через nsjail (namespaces/cgroups) |
| Задержка старта задачи | Секунды (планирование DAG) | 100–300 мс | < 15 мс (по бенчмаркам вендора) |
Архитектура production-стека Windmill состоит из трех ключевых компонентов:
- Windmill Server (API & Frontend): веб-интерфейс на React и высокопроизводительный HTTP-сервер на Rust, обрабатывающий запросы пользователей, запуск задач и управление секретами.
- Windmill Worker: фоновые исполнители задач, которые извлекают скрипты из очереди в PostgreSQL, запускают их в изолированном пространстве имен Linux (nsjail) и возвращают результат. Воркеры можно горизонтально масштабировать по числу ядер.
- PostgreSQL 16: единая база данных, в которой хранятся код скриптов, история запусков, журналы логов, токены авторизации и очереди задач.
⚠️ Лицензирование и модель Community Edition
Редакция Windmill Community Edition распространяется по свободной лицензии AGPLv3. Она полностью бесплатна для развертывания на собственной инфраструктуре без ограничений по числу скриптов, пользователей и воркеров. Коммерческая редакция Enterprise добавляет SAML/SCIM SSO, аудит-трейлы и мультирегиональную отказоустойчивость.
2. Системные требования и подготовка инфраструктуры на VDS
Благодаря высокой энергоэффективности Rust платформа Windmill нетребовательна к ресурсам. Сервер комфортно работает на минимальном тарифе VDS, оставляя запас мощности под выполнение пользовательских скриптов.
| Ресурс | Минимальные требования | Рекомендуемая конфигурация |
|---|---|---|
| Процессор (vCPU) | 1–2 vCPU (от 2.4 ГГц) |
2–4 vCPU (от 3.3 ГГц) |
| Оперативная память (RAM) | 2 ГБ RAM (+ 2 ГБ Swap) |
4–8 ГБ RAM (для тяжелых Python-модулей) |
| Дисковое пространство | 20 ГБ NVMe |
40–60 ГБ NVMe (кэш pip/npm и дампы БД) |
| Операционная система | Ubuntu 22.04 LTS / Debian 12 | Ubuntu 24.04 LTS x86_64 |
Обновим пакеты системы, установим зависимости и свежую версию Docker Engine с плагином Compose:
# Обновление индекса пакетов и системы
sudo apt update && sudo apt upgrade -y
# Установка системных утилит
sudo apt install -y curl wget git ufw ca-certificates gnupg
# Установка Docker через официальный скрипт
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Добавление пользователя в группу docker
# Внимание: добавление в группу docker дает права, эквивалентные root на сервере
sudo usermod -aG docker $USER
newgrp docker
# Создание рабочего каталога Windmill
sudo mkdir -p /opt/windmill/{db_data,logs,cache,backup}
sudo chown -R $USER:$USER /opt/windmill
cd /opt/windmill
# Ограничение прав доступа к директории бэкапов
chmod 750 /opt/windmill/backup
Направьте A-запись вашего поддомена (например, wm.example.com или flow.example.com) на публичный IP-адрес вашего сервера. Проверить распространение DNS-записей можно через инструмент DNS Lookup на SysKit.
3. Манифест Docker Compose: Server, Worker и PostgreSQL с защитой портов
Для запуска Windmill мы фиксируем стабильную версию ghcr.io/windmill-labs/windmill:v1.865.0 в связке с оптимизированной СУБД postgres:16-alpine. Разделение ролей на Server и Worker позволяет изолировать обслуживание веб-интерфейса от фоновых очередей и ресурсоемких вычислений.
Сгенерируем криптостойкие пароли для базы данных и сессий, вынеся параметры в защищенный файл .env. Для генерации надежных секретов воспользуйтесь утилитой генератора паролей или консольной командой:
# Генерация криптостойких паролей
DB_SECRET=$(openssl rand -hex 20)
COOKIE_SECRET=$(openssl rand -hex 32)
# Создание конфигурационного файла .env
cat <<EOF > /opt/windmill/.env
# Версия образов и окружение
WM_IMAGE=ghcr.io/windmill-labs/windmill:v1.865.0
DATABASE_URL=postgres://postgres:${DB_SECRET}@db:5432/windmill?sslmode=disable
POSTGRES_PASSWORD=${DB_SECRET}
COOKIE_SECRET=${COOKIE_SECRET}
# Публичный адрес для генерации ссылок и вебхуков
BASE_URL=https://wm.example.com
EOF
# Ограничение прав на файл переменных окружения
chmod 600 /opt/windmill/.env
Создадим файл /opt/windmill/docker-compose.yml. Обратите внимание на инженерные нюансы безопасности:
- Веб-порт опубликован строго на петлевой адрес
127.0.0.1:8000:8000, а порт базы данных5432изолирован внутри Docker-сетиwindmill_netбез публикации на хост; - В воркере активирована переменная
ENABLE_NSJAIL=trueдля включения песочницы изоляции скриптов. Флагprivileged: trueтребуется ядру контейнера исключительно для вызова--mount-procвнутри nsjail; - Директива
extra_hosts: host.docker.internal:host-gatewayпробрасывает шлюз хостовой машины внутрь изолированной сети контейнера, позволяя скриптам легко достучаться до локальных служб хоста (например, сервера Ollama на порту 11434).
services:
db:
image: postgres:16-alpine
container_name: windmill-db
restart: unless-stopped
mem_limit: 512m
cpus: 1.0
shm_size: 128m
# Порт 5432 намеренно НЕ опубликован на хост: защита от обхода UFW
environment:
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
POSTGRES_DB: windmill
volumes:
- ./db_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U postgres -d windmill"]
interval: 10s
timeout: 5s
retries: 5
networks:
- windmill_net
windmill_server:
image: ${WM_IMAGE}
container_name: windmill-server
restart: unless-stopped
mem_limit: 512m
cpus: 1.5
ports:
# Публикация строго на 127.0.0.1 для локального проксирования через Nginx
- "127.0.0.1:8000:8000"
environment:
- DATABASE_URL=${DATABASE_URL}
- MODE=server
- BASE_URL=${BASE_URL}
- COOKIE_SECRET=${COOKIE_SECRET}
depends_on:
db:
condition: service_healthy
volumes:
- ./logs:/tmp/windmill/logs
networks:
- windmill_net
windmill_worker:
image: ${WM_IMAGE}
container_name: windmill-worker
restart: unless-stopped
mem_limit: 1024m
cpus: 2.0
# privileged требуется nsjail для безопасного монтирования procfs (--mount-proc)
privileged: true
environment:
- DATABASE_URL=${DATABASE_URL}
- MODE=worker
- WORKER_GROUP=default
- ENABLE_NSJAIL=true
- FAVOR_UNSHARE_PID=true
- BASE_URL=${BASE_URL}
extra_hosts:
# Проброс шлюза хоста для прямого обращения к Ollama (порт 11434)
- "host.docker.internal:host-gateway"
depends_on:
db:
condition: service_healthy
volumes:
- ./cache:/tmp/windmill/cache
- ./logs:/tmp/windmill/logs
networks:
- windmill_net
networks:
windmill_net:
driver: bridge
💡 Совет инженера
Директивы mem_limit (512M для базы, 512M для сервера и 1024M для воркера) суммарно составляют ровно 2048 МБ, что идеально укладывается в тариф VDS с 2 ГБ RAM. Если вы используете сервер с 4 ГБ RAM, лимит воркера можно безопасно увеличить до 2048m или поднять второй параллельный воркер.
Запустим контейнеры стека в фоновом режиме:
# Запуск всех компонентов Windmill
docker compose up -d
# Проверка статуса служб
docker compose ps
# Просмотр логов инициализации сервера
docker compose logs -f windmill_server
При первом запуске Windmill автоматически применит миграции базы данных и создаст начальную учетную запись администратора с логином admin@windmill.dev и паролем changeme (смените его сразу при первом входе!).
4. Настройка обратного прокси Nginx, WebSocket и выпуск SSL Let's Encrypt
Для надежного проксирования веб-интерфейса, потоковой передачи логов выполнения скриптов через WebSocket и автоматического перенаправления на HTTPS настроим хостовый Nginx.
Создадим файл виртуального хоста Nginx (замените wm.example.com на ваш реальный поддомен):
# /etc/nginx/sites-available/wm.example.com.conf
server {
listen 80;
listen [::]:80;
server_name wm.example.com;
# Максимальный размер полезной нагрузки (JSON/файлы вебхуков)
client_max_body_size 50M;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
# Поддержка WebSocket для стриминга логов выполнения в реальном времени
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# Передача клиентских заголовков
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# Увеличенные таймауты для длительных скриптов и потокового вывода
proxy_connect_timeout 60s;
proxy_send_timeout 300s;
proxy_read_timeout 300s;
}
}
Активируем конфигурацию, проверим синтаксис и перезагрузим веб-сервер:
# Создание символической ссылки
sudo ln -sf /etc/nginx/sites-available/wm.example.com.conf /etc/nginx/sites-enabled/
# Проверка синтаксиса Nginx
sudo nginx -t
# Применение конфигурации
sudo systemctl reload nginx
Выпустим доверенный SSL-сертификат Let's Encrypt с автоматическим перенаправлением с HTTP на HTTPS с помощью утилиты Certbot с обязательным флагом --redirect:
# Установка Certbot и плагина Nginx
sudo apt install -y certbot python3-certbot-nginx
# Выпуск сертификата с настройкой автоматического 301-редиректа
sudo certbot --nginx --redirect -d wm.example.com
# Проверка таймера автопродления сертификатов
sudo systemctl status certbot.timer
После выпуска сертификата проверьте надежность цепочки TLS через SSL Checker и удостоверьтесь в доступности портов с помощью Port Checker на SysKit.
5. Выбор надежного VDS под платформу автоматизации и воркеры
Сервер автоматизации выполняет критически важные регулярные сценарии: сбор аналитики, проведение платежей, синхронизацию складов и отправку клиентских уведомлений. Внезапный сбой или зависание сервера приводят к потере заказов или рассогласованию баз данных. При выборе виртуального сервера (VDS) под стек Windmill важно учитывать три главных технических параметра:
- Тактовая частота процессорных ядер (vCPU): Интерпретаторы Python и TypeScript в подавляющем большинстве задач работают в однопоточном режиме (GIL). Чем выше базовая частота ядер (от 3.3 ГГц), тем быстрее парсятся объёмные JSON-ответы API и отрабатывает бизнес-логика скриптов.
- Быстрые NVMe-диски под кэш зависимостей: Первый запуск скрипта с тяжелыми библиотеками (например,
pandas,playwrightилиduckdb) требует компиляции и кэширования модулей на диск. Высокие показатели IOPS накопителя минимизируют время «холодного старта» задач. - Стабильный сетевой канал и низкие задержки: При оркестрации множества внешних API (маркетплейсы Wildberries/Ozon, платежные шлюзы, Telegram API, локальные базы) качество сетевого подключения провайдера определяет общую надежность фоновых пайплайнов.
💡 Совет инженера
Для базовых задач автоматизации и регулярных крон-скриптов достаточно тарифа VDS с 1–2 vCPU и 2 ГБ оперативной памяти. Если вы планируете запускать браузерный парсинг через Headless Chrome (Playwright/Puppeteer) или локальные микро-модели, выбирайте тариф с 2–4 vCPU, 4–8 ГБ RAM и возможностью горячего масштабирования без остановки сервиса.
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS
Высокочастотные процессоры от 3.3 ГГц и быстрые NVMe-диски для мгновенного холодного старта Python-воркеров и кэширования модулей.
Selectel — Корпоративные облачные серверы
Отказоустойчивые серверы с защитой по 152-ФЗ для критически важных процессов автоматизации и безопасной интеграции с корпоративными базами.
Beget — Удобные VDS для бизнеса
Мгновенное развертывание Docker, автоматические ежедневные бэкапы образов и стабильный безлимитный канал связи.
6. Автогенерация веб-интерфейсов из сигнатур функций Python, TypeScript и Bash
Главная киллер-фича Windmill — отсутствие необходимости верстать пользовательские формы для запуска скриптов. Когда разработчик создает скрипт на Python, платформа парсит аннотации типов аргументов функции main() и автоматически генерирует форму ввода:
int,float→ числовые поля с валидацией диапазона;str→ строковое поле ввода (или текстовая областьTextareaдля многострочного текста);bool→ переключатель (Toggle / Checkbox);List[str]→ мультивыбор или динамический список тегов;Enumили литералыLiteral["new", "in_progress", "done"]→ выпадающий список (Select).
Рассмотрим реальный пример скрипта на Python для массового изменения статуса заказа и отправки чека:
# /scripts/update_order.py
from typing import Literal
def main(
order_id: int,
new_status: Literal["paid", "processing", "shipped", "cancelled"],
notify_client: bool = True,
manager_comment: str = ""
) -> dict:
"""
Обновление статуса заказа в интернет-магазине с логированием и оповещением.
"""
# Логика обновления статуса в базе данных или CRM
print(f"Обработка заказа #{order_id}: перевод в статус {new_status}")
if notify_client:
print(f"Отправка клиенту SMS/Email о смене статуса на {new_status}")
return {
"success": True,
"order_id": order_id,
"status": new_status,
"comment": manager_comment
}
Как только вы сохраняете этот скрипт в интерфейсе Windmill, операторы получают готовый веб-интерфейс с валидацией типов, масками ввода и кнопкой запуска. Более того, для любого скрипта можно одним кликом сгенерировать публичный вебхук (Webhook URL) для запуска из сторонних сервисов (1C, МойСклад, платежных шлюзов или ботов Telegram).
7. Подключение языковых моделей (LLM): локальная Ollama и внешние API
Windmill идеально подходит для построения автономных ИИ-пайплайнов и мультиагентных конвейеров. Скрипт может извлечь свежие данные из базы PostgreSQL, отправить их в языковую модель для анализа и суммаризации, а результат сохранить в CRM и уведомить команду.
Благодаря пробросу директивы extra_hosts: host.docker.internal:host-gateway в конфигурации воркера, скрипты Windmill могут напрямую обращаться к хостовым сервисам по доменному имени host.docker.internal, не завися от плавающих IP-адресов моста Docker. Например, для локальной Ollama (порт 11434 на хосте):
# /scripts/ai_ticket_summarizer.py
import os
import requests
def main(customer_message: str, model_name: str = "deepseek-r1:8b") -> dict:
"""
Классификация входящего обращения клиента и генерация краткой выжимки через LLM.
"""
# Обращение к локальному серверу Ollama на хосте через шлюз extra_hosts
ollama_url = os.getenv("OLLAMA_HOST", "http://host.docker.internal:11434/api/generate")
prompt = f"""Проанализируй обращение клиента:
"{customer_message}"
Верни строго JSON с полями:
- category (техническая проблема / оплата / возврат / доставка)
- sentiment (positive / neutral / negative)
- summary (выжимка проблемы в одно предложение)
"""
response = requests.post(ollama_url, json={
"model": model_name,
"prompt": prompt,
"stream": False,
"format": "json"
}, timeout=60)
result = response.json()
return {"raw_analysis": result.get("response", "{}")}
💡 Совет инженера
Все токены авторизации (API-ключи OpenAI, токены Telegram Bot, пароли баз данных) следует сохранять во встроенном защищенном хранилище Windmill (раздел Resources / Variables). Значения шифруются алгоритмом AES-GCM и автоматически подставляются в скрипты без раскрытия секретов в открытом виде.
8. Автоматическое резервное копирование кластера PostgreSQL и скриптов в S3
Вся конфигурация Windmill — код скриптов, определения конвейеров Flows, ресурсы, учетные записи и переменные — хранится в базе данных PostgreSQL. Поэтому для надежной защиты настроим регулярный горячий дамп с автоматической выгрузкой архива в объектное хранилище S3 (Timeweb Cloud S3, Selectel или Yandex Object Storage).
Создадим автоматизированный скрипт /opt/windmill/backup/backup.sh, который загружает переменные окружения и безопасно выгружает копии во внешнее S3-облако:
#!/usr/bin/env bash
set -Eeuo pipefail
# Загрузка переменных окружения из защищенного файла
if [[ -f /opt/windmill/.env ]]; then
set -a
source /opt/windmill/.env
set +a
fi
BACKUP_DIR="/opt/windmill/backup"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
BACKUP_FILE="${BACKUP_DIR}/windmill_pg_${TIMESTAMP}.sql.gz"
# Параметры Telegram (опционально)
TELEGRAM_BOT_TOKEN="${TELEGRAM_BOT_TOKEN:-}"
TELEGRAM_CHAT_ID="${TELEGRAM_CHAT_ID:-}"
# Параметры S3-хранилища
S3_ENDPOINT="${S3_ENDPOINT:-https://s3.timeweb.cloud}"
S3_BUCKET="${S3_BUCKET:-my-company-backups}"
send_telegram() {
local message="$1"
if [[ -n "${TELEGRAM_BOT_TOKEN}" && -n "${TELEGRAM_CHAT_ID}" ]]; then
curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
--data-urlencode "chat_id=${TELEGRAM_CHAT_ID}" \
--data-urlencode "text=${message}" > /dev/null || true
fi
}
echo "=== Запуск резервного копирования Windmill: ${TIMESTAMP} ==="
# 1. Горячий дамп базы данных PostgreSQL в формате SQL со сжатием gzip
docker exec windmill-db pg_dump \
-U postgres \
-d windmill \
--no-owner \
--no-privileges | gzip > "${BACKUP_FILE}"
chmod 600 "${BACKUP_FILE}"
BACKUP_SIZE=$(du -sh "${BACKUP_FILE}" | cut -f1)
# 2. Выгрузка резервной копии в российское объектное S3-хранилище
if command -v aws &> /dev/null && [[ -n "${S3_BUCKET}" ]]; then
echo "Выгрузка дампа в S3-бакет ${S3_BUCKET}..."
aws --endpoint-url="${S3_ENDPOINT}" s3 cp "${BACKUP_FILE}" "s3://${S3_BUCKET}/windmill/$(basename "${BACKUP_FILE}")"
fi
# 3. Ротация локальных копий (хранение за последние 7 дней)
find "${BACKUP_DIR}" -type f -name "windmill_pg_*.sql.gz" -mtime +7 -delete
echo "Резервное копирование успешно завершено: ${BACKUP_FILE} (${BACKUP_SIZE})"
# 4. Отправка отчета в Telegram с естественными переносами строк
MESSAGE="✅ Windmill Backup в S3 Успешно
Сервер: wm.example.com
Файл: $(basename "${BACKUP_FILE}")
Размер: ${BACKUP_SIZE}
Хранилище: S3 (${S3_BUCKET})
Дата: $(date '+%Y-%m-%d %H:%M:%S')"
send_telegram "${MESSAGE}"
Сделаем скрипт исполняемым и настроим его регулярный ночной запуск по расписанию через системный cron:
# Назначение безопасных прав доступа
chmod 750 /opt/windmill/backup/backup.sh
# Добавление задачи в crontab администратора (запуск каждую ночь в 03:00)
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/windmill/backup/backup.sh >> /opt/windmill/logs/backup.log 2>&1") | crontab -
Для генерации индивидуального расписания воспользуйтесь утилитой генератора выражений Crontab на SysKit, а также ознакомьтесь с шаблоном ротации резервных копий.
9. Инженерный чек-лист проверки и ввод платформы в эксплуатацию
Перед запуском боевых процессов автоматизации и интеграции со складскими системами обязательно проверьте все критические компоненты по чек-листу:
📋 Чек-лист готовности к production
- Сетевая безопасность: Убедитесь, что порт базы данных
5432не опубликован на хост, а веб-сервис доступен только локально по адресу127.0.0.1:8000. - Поддержка WebSocket: Проверьте отсутствие обрывов соединения в консоли разработчика браузера (вкладка WS со статусом
101 Switching Protocols). - Песочница воркера: Убедитесь, что переменная
ENABLE_NSJAIL=trueпередана воркеру, а тестовый запуск скрипта выполняется в изолированном пространстве имен. - Связь с Ollama: Проверьте вызов локальной LLM через хостовый адрес
host.docker.internal:11434из тестового скрипта. - Валидность SSL: Проверьте корректность цепочки шифрования сертификата на онлайн-утилите SSL Checker.
- Смена пароля администратора: Смените стандартный пароль
changemeучетной записиadmin@windmill.devсразу после первого входа. - Проверка выгрузки бэкапа: Запустите скрипт
backup.shвручную и удостоверьтесь в создании файла архива, выгрузке в S3 и получении оповещения в Telegram.
Разверните платформу автоматизации на надежном VDS
Запускайте автоматические скрипты, управляйте ИИ-пайплайнами и создавайте внутренние веб-инструменты на проверенных виртуальных серверах с быстрыми накопителями NVMe и сетевым каналом до 1 Гбит/с в российских дата-центрах.