windmill-labs/windmill

项目定位

Windmill 是一个代码优先的编排平台，用来把脚本、工作流和内部应用放在同一套系统里。脚本就是普通的函数，支持 Python、TypeScript、Go、Bash、SQL、Rust 等语言；函数带类型的参数会自动生成表单、HTTP 接口和 CLI 命令，脚本可以串成流程，也可以作为 React/Svelte 应用和 AI 会话里的步骤。后端用 Rust 编写，worker 从 Postgres 队列拉取任务。它的定位是 n8n、Retool、Lovable 的开源替代，范围比 Temporal 更轻。

同一个实例面向两类人：工程师在本地或通过 Git 同步写代码，业务团队在浏览器里用 AI 会话搭建。评审、保护规则集、开发工作区和 worker 分组用来把上线控制权留在工程师手里。

用 Docker Compose 自托管

官方提供由 docker-compose.yml、Caddyfile 和 .env 三个文件组成的部署方式。在一个用于存放这些文件的目录中执行：

curl https://raw.githubusercontent.com/windmill-labs/windmill/main/docker-compose.yml -o docker-compose.yml
curl https://raw.githubusercontent.com/windmill-labs/windmill/main/Caddyfile -o Caddyfile
curl https://raw.githubusercontent.com/windmill-labs/windmill/main/.env -o .env
docker compose up -d

然后访问 http://localhost，用默认账号 admin@windmill.dev / changeme 登录。对外暴露前请先修改默认凭据。如果要使用 RDS、Cloud SQL、Neon 等托管 Postgres，在 .env 中设置 DATABASE_URL，并把数据库副本数设为 0。Kubernetes 部署可通过 windmill-labs/windmill-helm-charts 仓库的 Helm chart 完成。

不想自托管时，项目提供了在线试用实例；具体安装选项见自托管文档和 Docker Compose 一节。

主要概念与工具

基本路径是脚本 → 自动生成的界面/API → 流程 → 应用。脚本可以在网页编辑器中编写，也可以通过 CLI、VS Code 扩展或 MCP server把工作区与 Git 同步；本地运行时为 wmill 客户端库配置环境变量，就能访问实例中的资源。数据表为每个工作区提供托管的 Postgres 表，不需要暴露连接串；DuckDB 和 DuckLake 支持查询文件和 lakehouse 表，已有的 dbt 项目可以作为脚本原样运行。

使用约束

• 默认部署需要 Docker 和 Postgres；README 给出的粗略配置是每 vCPU 配一个 worker、1–2 GB 内存。
• 不同镜像的运行时支持不同：Deno 只在 windmill-full 镜像中提供，PHP 同样仅限该镜像；默认 JavaScript 运行时是 Bun。
• 许可证分两部分：社区版在软件限额内供内部使用是免费的，但转售、包装成托管服务或作为产品功能对外暴露需要商业许可。不带 enterprise 特性的二进制以 AGPLv3 发布，API 客户端和 OpenAPI 规范采用 Apache 2.0。
• 项目明确表示目前不寻求外部贡献，但欢迎 bug 报告和小型、易于验证的修复。
• “最快的自托管工作流引擎”这一说法来自项目自己对 Airflow、Prefect、Temporal 的基准测试，测试方法放在基准页而非 README。

HotRepo 点评

Windmill 目前约有 18.4k stars，最受关注的一次社区讨论是 2023 年 Hacker News 上获得 428 分、109 条评论的帖子。这些讨论提供的是使用背景而非结论：有评论者称赞问题修复速度和 Discord 社区，也有人建议文档多讲代码导向和 IDE/Git 工作流、少讲网页编辑器，还有人质疑把多项职责塞进一个工具与 Unix 的组合哲学相悖。仓库近期在 Rust 日榜有一条记录（2026-11-06 排第 18，新增 31 stars），但没有全语言日榜名次记录。考虑采用时，应重点评估许可证条款及 AGPL/商业版的划分，因为这直接影响平台能否对外提供。