ghcr.io/windmill-labs/windmill-ee-slim:1.801.0

面向内部代码的开源开发者平台：API、后台任务、工作流和UI。可自托管的Retool、Pipedream、Superblocks替代方案，以及简化版的Temporal，具备自动生成的UI和自定义UI，可将工作流和脚本作为内部应用触发。

脚本会自动转换为可共享的UI，并且可以组合成工作流，或用于通过低代码构建的更丰富应用中。支持的语言：Python、TypeScript、Go、Bash、SQL、GraphQL、PowerShell、Rust等。

立即尝试 - 网站 - 文档 - *** - 中心 - 贡献指南

Windmill - 面向API、后台任务、工作流和UI的开发者平台

Windmill是完全开源的（AGPLv3协议），Windmill Labs提供专用实例以及商业支持和许可。

• Windmill - 面向API、后台任务、工作流和UI的开发者平台
• 核心概念
• 实际脚本代码示例
• 本地开发
• 技术栈
• 最快的可自托管工作流引擎
• 安全性
• 性能
• 架构
• 如何自托管
• Docker Compose
• Kubernetes（Helm图表）
• 云服务提供商
• OAuth、SSO和SMTP
• 许可协议
• 集成
• 环境变量
• 运行本地开发环境
• 仅前端
• 后端+前端
• 贡献指南
• 贡献者
• 版权信息

核心概念

2. 脚本参数会被自动解析并生成前端界面。

3. 将其构建为工作流！您可以将自己的脚本或社区在WindmillHub上共享的脚本链接起来。

4. 在脚本和工作流之上构建复杂UI。

在Windmill之上构建您的整个基础设施！

实际脚本代码示例

//从npm导入任何依赖
import * as wmill from "windmill-client";
import * as cowsay from "cowsay@1.5.0";

// 填充类型，或使用+Resource类型获取资源的类型安全引用
type Postgresql = {
host: string;
port: number;
user: string;
dbname: string;
sslmode: string;
password: string;
};

export async function main(
a: number,
b: "my" | "enum",
c: Postgresql,
d = "从默认参数推断的字符串类型",
e = { nested: "object" }
//f: wmill.Base64
) {
const email = process.env["WM_EMAIL"];
// 变量按路径进行权限控制
let variable = await wmill.getVariable("f/company-folder/my_secret");
const lastTimeRun = await wmill.getState();
// 日志会被打印并始终可查看
console.log(cowsay.say({ text: "hello " + email + " " + lastTimeRun }));
await wmill.setState(Date.now());

// 返回值会序列化为JSON
return { foo: d, variable };
}

本地开发

Windmill支持多种本地开发方式，并可与您的实例同步：

您可以通过传递正确的环境变量，让wmill客户端库从您的实例获取资源和变量，从而在本地运行脚本。请参阅本地开发文档。

技术栈

• 数据库：Postgres（兼容Aurora、Cloud SQL、Neon、Azure PostgreSQL）
• 后端：Rust - 无状态API服务器和从Postgres队列拉取任务的工作节点
• 前端：Svelte 5
• 沙箱隔离：https://github.com/google/nsjail 和PID命名空间隔离
• 运行时：
  • TypeScript/JavaScript：Bun（默认）和Deno
  • Python：python3，使用uv进行依赖管理
  • Go、Bash、PowerShell、PHP、Rust、C#、Java、Ansible

最快的可自托管工作流引擎

我们将Windmill与其他可自托管工作流引擎（Airflow、Prefect和Temporal）进行了比较，结果表明Windmill在两项基准测试中都是性能最佳的解决方案：一个包含40个轻量级任务的工作流，以及一个包含10个长时间运行任务的工作流。所有方法和结果详见我们的基准测试页面。

安全性

• 沙箱隔离：使用https://github.com/google/nsjail进行文件系统/资源隔离，并默认启用PID命名空间隔离，防止任务访问工作节点进程内存
• 密钥管理：每个工作区使用一个加密密钥来加密存储在Windmill K/V存储中的凭证。我们还建议对Postgres数据库进行加密。

详情请参阅安全文档。

性能

作业启动后，与在节点上使用相应运行器（Deno/Go/Python/Bash）运行相同脚本相比，没有额外开销。作业从队列中被拉取、启动并将结果发送回数据库的额外延迟约为50ms。一个典型的轻量级Deno作业总共耗时约100ms。

架构

OAuth、SSO 与 SMTP

直接从超级管理员 UI 配置 OAuth 和 SSO（Google Workspace、Microsoft/Azure、Okta）。参见文档。

本地开发环境设置

我们建议使用 Nix。有关所有选项，请参见 ./frontend/README_DEV.md。

仅前端

使用带有本地前端（热重载）的后端：

cd frontend
npm install
npm run generate-backend-client # 或在 Mac 上使用 generate-backend-client-mac
npm run dev

Windmill 可通过 http://localhost/ 访问

后端 + 前端

有关所有运行选项，请参见 ./frontend/README_DEV.md 文件。

1. 使用例如 start-dev-db.sh 脚本启动本地 Postgres 数据库，该脚本将创建一个可通过 postgres://postgres:changeme@localhost:5432/windmill 访问的数据库。然后使用以下命令运行迁移：

cargo install sqlx-cli
   env DATABASE_URL= sqlx migrate run

这也将避免 sqlx 的 query! 宏在编译时出现问题。 2.（可选，仅适用于 Linux）安装 https://github.com/google/nsjail 并确保其在你的 PATH 中可访问 3. 安装 bun、deno 和 python3（以及任何你想使用的语言），确保可执行文件位于 /usr/bin/bun、/usr/bin/deno 和 /usr/local/bin/python3，或设置相应的环境变量。 4.（可选）安装 https://lld.llvm.org/ 5. 进入 frontend/ 目录：

1. npm install、npm run generate-backend-client，然后 REMOTE=http://localhost:8000 npm run dev
2. 你可能需要为 node 运行时设置额外的堆空间：export NODE_OPTIONS="--max-old-space-size=4096"
3. 使用 mkdir frontend/build 创建空的 frontend/build 文件夹
4. 进入 backend/ 目录：
   1. env DATABASE_URL= RUST_LOG=info cargo run
   2. 你可以指定任何要启用的功能标志，例如 cargo run --features python 以启用 python 执行器。
5. Windmill 应可通过 http://localhost:3000 访问

贡献

目前，我们不寻求外部贡献。错误报告和功能请求仍然非常受欢迎，修复问题的小型、易于验证的 PR 仍会被接受。有关完整政策，请参见 CONTRIBUTING.md。

贡献者

版权

© 2023-2026 Windmill Labs, Inc.