首页 > 开源 > 极速调度，可靠备份 OpsDump v0.1.0 首次发布

极速调度，可靠备份 OpsDump v0.1.0 首次发布

OSChina资讯 2026-09-11 11:00 1 阅读 查看原文
数据库备份 运维平台 Go语言

极速调度，可靠备份（The Swift Engine for Ops & Dump）

OpsDump 是一个面向数据库备份为主、兼有通用任务调度能力的单进程运维平台。基于 GoFrame v2 构建，单二进制、SQLite 落库、Web 页面管理，开机即用。

状态：已实现并跑通（v0.1）。仓库根 ops-dump/ 为可独立运行/迁移的 Go 模块（模块名 ops-dump）。

仓库地址

仓库地址

特性

  • 数据库备份模板：内置 MySQL / TDengine / MinIO(S3) 备份模板，默认禁用，页面启用后按 cron 自动运行。

  • 通用任务调度：任意本机命令均可作为任务（kind=shell），支持 ${VAR} 引用 .env，支持 ssh 跨机执行。

  • 执行 + 检测双状态：主命令执行后可选跑一条校验命令，独立记录结果，兜住"假成功"。

  • 流水线编排：通过 depends_on 串联 backup → verify → sync → cleanup，杜绝"先删后传丢档"。

  • 磁盘预检 / 体积上报：执行前检查输出盘剩余空间，执行后统计产物体积写入历史。

  • Web 管理页面：gview + Vue3(CDN) 内嵌后台，登录后配置任务、查看执行历史，无需 SSH。

  • 任务导出导入：支持任务配置的批量导出/导入，方便迁移和备份。

  • 认证与会话：账号密码登录，初始 admin 账号由 .env 的 ADMIN_PASSWORD 注入。

  • 结构化日志 + 飞书告警：JSON 行日志，飞书 webhook 通知。

  • 探活接口：GET /ping → pong、GET /healthz。

快速开始

1. 准备环境变量

编辑 .env 并根据实际情况修改：

# 管理员密码（启动前必须修改！）
ADMIN_PASSWORD=your_password!

# 备份存储路径
BACKUP_DIR=/opt/backups

# MySQL 配置
MYSQL_ROOT_PASSWORD=
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_DATABASE=your_database

# TDengine 配置
TDENGINE_ROOT_PASSWORD=
TDENGINE_HOST=127.0.0.1
TDENGINE_PORT=6030
TDENGINE_DATABASE=your_database

# MinIO 配置
MINIO_ROOT_USER=
MINIO_ROOT_PASSWORD=
MINIO_ENDPOINT=127.0.0.1:9000
MINIO_BUCKET=your_bucket

注意：敏感信息（密码/密钥）仅在此文件中配置，不会进入代码或日志。

2. 配置

编辑 manifest/config/config.yaml（或自建 config.yaml 通过 --config 指定）：

ops-dump:
  timezone: "Asia/Shanghai"
  dbPath: "./ops-dump.db"
  credentials:
    envFile: ".env"
  admin:
    username: admin
logger:
  path: ./logs
  file: opsdump.log
  level: info
  stdout: true

3. 运行

# 开发运行
go run main.go

# 或交叉编译后运行（sqlite 为纯 Go，无 CGO，可静态编译）
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o ops-dump .
./ops-dump

启动后访问 http://<host>:28090，用 admin 登录，进入任务管理启用/新建任务。

注意：首次启动请确保 ops-dump.db 不存在，让程序自动创建（Windows 开发机下 gf sqlite 对相对路径解析有特殊处理，生产 Linux 无此问题）。

目录结构

ops-dump/
├── main.go                     # 入口：调用 internal/cmd 启动并阻塞
├── api/                        # 对外接口 Req/Res 数据结构
├── hack/                       # gfcli 配置与代码生成辅助（gen-db）
├── internal/
│   ├── cmd/                    # 启动引导：配置/日志/DB/调度初始化、注册路由
│   ├── consts/                 # 常量（表名、任务类型、状态等）
│   ├── controller/             # 接口与页面路由实现
│   ├── dao/                    # 数据访问层（gf gen dao 生成）
│   ├── model/                  # entity / do / 公共结构
│   └── service/                # 业务层：env/execute/db/auth/job/tpl/runner/scheduler/notify
├── manifest/
│   ├── config/config.yaml      # 进程配置
│   └── sql/ops-dump.sql        # 建表 DDL（gf gen dao 的 schema 源）
├── resource/                   # 模板(template/) 与静态资源(public/)，随二进制内嵌
└── go.mod / go.sum

数据模型

全部表以 od_ 前缀开头，运行时自动建表迁移：

表

说明

od_users

账号（密码 sha256(salt+pwd) 哈希）

od_sessions

会话（预留，当前使用 gf 内存会话）

od_jobs

任务定义（kind/cron/command/verify_command/run_after/retention 等）

od_job_runs

执行历史（执行+检测双状态、输出、体积、耗时、错误）

od_notify_config

通知配置（飞书 webhook）

主要接口

接口

说明

GET /ping

探活，返回 pong

GET /healthz

健康检查，返回 JSON

GET /login

登录页（公开）

/、/dashboard、/jobs、/runs

管理页面（需登录）

POST /api/login / POST /api/logout / GET /api/current-user

认证

GET/POST /api/jobs、GET/PUT/DELETE /api/jobs/:id

任务 CRUD

POST /api/jobs/:id/enable、disable、run、GET /api/jobs/:id/runs

任务操作

部署

nohup ./ops-dump > /dev/null 2>&1 &

注意事项

  • 敏感信息一律 ${VAR} 引用 .env，明文不出库不落地；.env 权限 600。

  • httpAddr 建议绑定内网；通用 shell 任务拥有执行权限，需审计。

  • 备份产物应与源数据不在同一磁盘；清理任务须排在同步任务之后。

截图

概览

任务管理

执行历史

相关推荐