Files
appstore/apps/dagu/README.md
T
2026-07-31 02:02:39 +08:00

54 lines
2.6 KiB
Markdown

# Dagu
## 产品介绍
Dagu 是一个本地优先的工作流编排引擎。它以单个进程提供 Web UI、调度器和执行器,使用本地文件保存 DAG 定义、运行记录和配置,不依赖外部数据库或消息队列。
## 主要功能
- 通过 YAML 和 Web UI 创建、调度与运行 DAG
- 查看步骤日志、运行历史、重试和审批状态
- 支持 Shell、HTTP、SSH 等多种工作流步骤
- 内置用户管理、API 和 MCP 服务
## Introduction
Dagu is a local-first workflow orchestration engine. A single process provides the Web UI, scheduler, and executor, while DAG definitions, run history, and configuration are stored as local files without an external database or message broker.
## Features
- Create, schedule, and run YAML-based DAGs from the Web UI
- Inspect step logs and run history, then retry or approve work
- Build workflows with shell, HTTP, SSH, and other supported executors
- Use built-in user management, REST APIs, and the MCP endpoint
## 访问说明
安装后通过 `http://<服务器 IP>:8080` 访问,实际端口以安装表单中的 `PANEL_APP_PORT_HTTP` 为准。首次访问时,按照初始化页面创建管理员账户。
## 部署说明
- 本应用使用 Dagu 官方镜像 `ghcr.io/dagucloud/dagu` 的单机 `dagu start-all` 模式。
- 数据目录映射到容器内 `/var/lib/dagu`,保存 DAG 定义、用户、配置和运行历史。
- 默认使用内置认证模式,不包含预设账户或固定密钥。
- 默认不挂载 Docker Socket。Shell、HTTP 等常规步骤可直接使用;需要运行 Docker 容器的 DAG 必须由管理员在了解主机控制风险后另行配置。
## 参数说明
| 变量 | 说明 | 默认值 | 必填 |
| --- | --- | --- | --- |
| `PANEL_APP_PORT_HTTP` | Web UI 和 API 的 HTTP 端口 | `8080` | 是 |
| `APP_DATA_DIR` | Dagu 数据目录 | `./data` | 是 |
| `DAGU_TZ` | 调度器时区 | `Asia/Shanghai` | 是 |
## 数据与升级
升级、迁移或卸载前,请备份 `APP_DATA_DIR` 指向的完整目录。默认的 `./data` 位于 1Panel 应用安装目录内,卸载时会被移除。需要跨卸载保留数据时,可选择已规划的独立绝对路径;若该目录已经存在,须提前将其所有权设为 UID/GID `1000:1000`,应用脚本不会修改既有绝对目录的所有权。
## 参考资料
- 项目网站: <https://dagu.sh>
- 项目仓库: <https://github.com/dagucloud/dagu>
- Docker 用法: <https://github.com/dagucloud/dagu#docker>
- Docker Compose 示例: <https://github.com/dagucloud/dagu/blob/main/deploy/docker/compose.minimal.yaml>