轩辕镜像 官方专业版
轩辕镜像
专业版
轩辕镜像 官方专业版
轩辕镜像
专业版
首页个人中心搜索镜像
交易
充值流量¥8起我的订单
文档
工具
提交工单页面收录
ghcr.io/windmill-labs/windmill-full

ghcr.io/windmill-labs/windmill-full:1.798.0

ghcr.iolinux/amd641.798.0大小: 2.40 GB更新于 2026年9月7日
让 AI 帮你使用轩辕镜像? · 展开查看说明 · 点击收起说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可:

请先完整阅读并严格遵守以下文档中的全部规则与要求:

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。

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

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

立即试用 - 网站 - 文档 - *** - Hub - 贡献指南

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

Windmill是完全开源的(AGPLv3许可),Windmill Labs提供专用实例以及商业支持和许可。

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

主要概念

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

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

  3. 在脚本和工作流的基础上构建复杂UI。

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

查看实际脚本代码示例

//import any dependency from npm
import * as wmill from "windmill-client";
import * as cowsay from "cowsay@1.5.0";

// fill the type, or use the +Resource type to get a type-safe reference to a 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 = "inferred type string from default arg",
e = { nested: "object" }
//f: wmill.Base64
) {
const email = process.env["WM_EMAIL"];
// variables are permissioned and by path
let variable = await wmill.getVariable("f/company-folder/my_secret");
const lastTimeRun = await wmill.getState();
// logs are printed and always inspectable
console.log(cowsay.say({ text: "hello " + email + " " + lastTimeRun }));
await wmill.setState(Date.now());

// return is serialized as JSON
return { foo: d, variable };
}

本地开发

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

工具描述
CLI从本地文件或GitHub同步脚本,通过命令行运行脚本/工作流
VS Code 扩展直接在VS Code / Cursor中编辑和测试脚本及工作流,提供完整IDE支持
Git 同步Windmill与Git仓库之间的双向同步
Claude Code借助Claude进行AI辅助开发,支持脚本、工作流和应用

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

云服务提供商

Windmill 可在 AWS (EKS/ECS)、GCP、Azure、Ubicloud、Fly.io、Render.com、Hetzner、Digital Ocean 等平台上运行。经验法则:每 1vCPU 和 1-2 GB RAM 配置 1 个工作节点。

环境变量名称默认值描述适用组件(Api Server/Worker/All)
DATABASE_URLPostgres 数据库 URL。All
WORKER_GROUPdefault工作节点所属的工作组,其配置将从该组拉取Worker
MODEstandalone二进制文件的运行模式。可能的值:standalone(独立模式)、worker(工作节点模式)、server(服务器模式)、agent(代理模式)All
METRICS_ADDRNone(仅企业版)用于在 /metrics 路径暴露 Prometheus 指标的 socket 地址。设置为 "true" 可在 8001 端口暴露指标All
JSON_FMTfalse以 JSON 格式输出日志,而非 logfmt 格式All
BASE_URLhttp://localhost:8000公开访问实例的基础 URL。如有实例设置,将覆盖此值Server
ZOMBIE_JOB_TIMEOUT30如果工作节点未发送作业处理 ping(服务器每 30 秒检查一次僵尸作业),超过此超时时间后作业将被视为僵尸作业Server
RESTART_ZOMBIE_JOBStrue若为 true,僵尸作业将被重启(使用相同 UUID 原地重启并记录日志);若为 false,僵尸作业将标记为失败Server
NATIVE_MODEfalse启用原生模式:设置 NUM_WORKERS=8,拒绝非原生作业(nativets、postgresql、mysql 等)Worker
SLEEP_QUEUE50数据库中最后一次检查新作业后休眠的毫秒数。该值乘以 NUM_WORKERS,因此对于单个工作节点实例,平均每 SLEEP_QUEUE 毫秒拉取一次作业Worker
KEEP_JOB_DIRfalse作业完成后保留作业目录。调试时有用。Worker
EXIT_AFTER_N_JOBSNone工作节点进程执行指定数量的作业后退出,以便监控程序重启它,确保进程不会运行超过该数量的作业(但会完成已启动的同工作节点流程的步骤)。设置为 1 可实现每个作业一个进程;分配给专用工作节点的作业以及工作节点自身的初始化和周期性脚本不计入此数量。不计入初始化和周期性脚本意味着它们在每次重启时都会重新运行:初始化脚本的运行时间会增加每批该数量作业的延迟,且周期性脚本无论其间隔如何,每次进程启动时都会触发一次。工作节点页面中的工作节点 shell 也会提前启动(而非原本需要的两分钟),因为即将回收的进程无法保证存活那么久:会话的第一个命令最多等待 15 秒,后续命令立即执行。适用于通过进程生命周期而非 nsjail 隔离执行的部署;注意容器重启会重置进程而非容器文件系统,因此缓存和 /tmp 会保留。此时工作节点名称将从主机名派生而非随机生成,因此重启后的工作节点会保留其在...Worker
WORKER_SUFFIXNone固定工作节点名称的最后部分(否则为随机生成),以便重启后的工作节点在工作节点列表中保留其行。仅当同一主机上运行多个同一工作组的工作节点进程时需要:为每个进程分配不同的值,因为绝不能有两个进程共享同一个值。最多 64 个字母、数字和下划线;其他字符在启动时会被拒绝。Worker
LICENSE_KEY (EE only)NoneWindmill 企业版启动时检查的许可证密钥Worker
SLACK_SIGNING_SECRETNoneSlack 应用的签名密钥。参见 Slack 文档Server
COOKIE_DOMAINNoneCookie 的域名。若未设置,浏览器将基于完整源设置 CookieServer
DENO_PATH/usr/bin/denodeno 二进制文件的路径。Worker
PYTHON_PATH若不想由 uv 管理 python 二进制文件,此处指定其路径。Worker
GO_PATH/usr/bin/gogo 二进制文件的路径。Worker
GOPRIVATE用于私有 go 模块的 GOPRIVATE 环境变量Worker
GOPROXY要使用的 GOPROXY 环境变量Worker
NETRC用于私有 go 仓库的 netrc 内容Worker
PY_CONCURRENT_DOWNLOADS20设置 windmill 在任何时候执行的最大并发 python 下载数。Worker
PATHNone路径环境变量,通常继承自系统Worker
HOMENone用于 Go 和 Bash 的主目录,通常继承自系统Worker
DATABASE_CONNECTIONS50(Server)/3(Worker)数据库连接池中的最大连接数All
SUPERADMIN_SECRETNone允许调用者以虚拟超级管理员 *** 身份操作的令牌Server
TIMEOUT_WAIT_RESULT20'run_wait_result' 端点超时前的等待秒数Worker
QUEUE_LIMIT_WAIT_RESULTNone'run_wait_result' 端点队列中的最大作业数,超过此数将立即拒绝请求。优先级高于查询参数。若未指定,则无限制。Worker
DENO_AUTH_TOKENSNone传递给工作节点的自定义 DENO_AUTH_TOKENS,以允许使用私有模块Worker
DISABLE_RESPONSE_LOGSfalse禁用响应日志Server
CREATE_WORKSPACE_REQUIRE_SUPERADMINtrue若为 true,则只有超级管理员可以创建新工作区Server
MIN_FREE_DISK_SPACE_MB***工作节点的最小可用磁盘空间(MB)。若工作节点可用空间不足,将发送严重警报。Worker
RUN_UPDATE_CA_CERTIFICATE_AT_STARTfalse若为 true,在其他初始化之前,启动时运行 CA 证书更新命令All
RUN_UPDATE_CA_CERTIFICATE_PATH/usr/sbin/update-ca-certificates当 RUN_UPDATE_CA_CERTIFICATE_AT_START 为 true 时,要运行的 CA 证书更新命令/脚本的路径All
GOOGLE_APPLICATION_CREDENTIALSNone(仅企业版)GCP Pub/Sub 触发器的凭据文件,用于以实例身份而非通过 gcloud 资源(仅限工作区管理员)进行身份验证。应用默认凭据还会解析 gcloud 知名文件和 GCE 元数据服务器。工作负载身份联合文件支持 file、url 和 aws 凭据源;不支持 executable 源。Server

运行本地开发环境

我们建议使用 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! 宏出现编译时问题。

  1. (可选,仅适用于 Linux)安装 https://github.com/google/nsjail 并确保其在 PATH 中可访问

  2. 安装 bun、deno 和 python3(以及任何您想使用的语言),确保可执行文件位于 /usr/bin/bun、/usr/bin/deno 和 /usr/local/bin/python3,或设置相应的环境变量。

  3. (可选)安装 https://lld.llvm.org/

  4. 进入 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 文件夹
  5. 进入 backend/ 目录:

    1. env DATABASE_URL= RUST_LOG=info cargo run
    2. 您可以指定要启用的任何功能标志,例如 cargo run --features python 以启用 python 执行器。
  6. Windmill 应可通过 http://localhost:3000 访问

贡献

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

贡献者

版权

© 2023-2026 Windmill Labs, Inc.

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

爱快 4.0 · iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

专属域名用法

专属域名 · 开启停用 · 多仓库

新手拉取配置

登录 · 专属域名 · 配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 专业版 · 企业版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest(架构)

docker.sock / daemon

账号

失败是否计费

manifest · blob · 计费

申请开票(企业 / 个人)

开票 · 发票 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈,见证轩辕镜像的优质服务

用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅,大镜像也能快速完成下载。"

轩辕镜像
镜像详情
...
ghcr.io/windmill-labs/windmill-full
定价查看流量套餐与价格
博客Docker 镜像公告与技术博客
专业版 · 高速稳定拉取镜像
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
50GB 仅 ¥8/年
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
用户协议·隐私政策·增值电信业务经营许可证:浙B2-20261007·©2024-2026 源码跳动©2024-2026 杭州源码跳动科技有限公司·商务合作:点击复制邮箱