hanchuanchuan/goinception
hanchuanchuan
集MySQL语句审核、批量执行与定时备份功能于一体的运维工具，简化数据库管理流程，提升运维效率与安全性。
4 次收藏下载次数: 0状态：社区镜像维护者：hanchuanchuan仓库类型：镜像最近更新：1 年前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
镜像概述
该镜像提供集成化MySQL运维工具，整合语句审核、批量执行与定时备份功能，旨在简化数据库日常管理流程。通过容器化部署，帮助数据库管理员与开发团队高效处理SQL审核、脚本执行及数据备份任务，降低人工操作风险，提升运维规范性。
核心功能与特性### 1. SQL语句审核
- 自动校验SQL语法正确性，支持MySQL主流版本语***则
- 内置安全风险检测（如无备份DROP TABLE、UPDATE无WHERE条件等）
- 性能优化建议（如全表扫描预警、索引使用分析）
- 支持自定义审核规则（通过配置文件扩展检测逻辑）
2. 批量执行管理
- 支持多数据库实例批量执行SQL脚本，统一管理执行任务
- 提供任务调度功能，基于时间规则触发脚本执行
- 完整记录执行日志（包含执行时长、影响行数、错误信息）
- 支持执行结果邮件/HTTP回调通知
3. 定时备份与恢复
- 基于Cron表达式配置定时全量/增量备份策略
- 备份文件自动压缩（支持gzip格式），可配置保留周期
- 支持备份文件异地存储（需挂载外部存储卷）
- 提供一键恢复功能，支持指定时间点数据恢复
4. 其他特性
- 多环境适配（开发/测试/生产环境配置隔离）
- 细粒度权限控制（基于角色的操作权限管理）
- 轻量化设计（基础镜像体积<200MB，资源占用低）
- 兼容主流MySQL版本（5.6+至8.0+）
使用场景与适用范围### 典型场景
- 日常运维：定时备份核心业务数据，自动执行索引优化脚本
- 版本发布：发布前批量审核业务SQL，规避语法错误与性能风险
- 多环境同步：跨开发/测试/生产环境批量执行标准化SQL脚本
- 应急恢复：通过备份文件快速恢复误操作或故障数据
适用范围
- 中小企业数据库管理员（DBA）日常运维工作
- 开发团队版本发布前的SQL审核流程
- 需要定期备份数据的业务系统（如电商、***类应用）
- 管理多MySQL实例的技术团队（如分布式系统数据库集群）
详细使用方法与配置说明### 基础部署（Docker Run）
bashdocker run -d \ --name mysql-ops-tool \ -e MYSQL_HOST=192.168.1.100 \ -e MYSQL_PORT=3306 \ -e MYSQL_USER=admin \ -e MYSQL_PASSWORD=SecurePass123 \ -e BACKUP_DIR=/backups \ -e BACKUP_CRON="0 1 * * *" \ # 每天凌晨1点执行全量备份 -v /data/mysql/backups:/backups \ # 挂载备份存储卷 -v /data/mysql/scripts:/scripts \ # 挂载SQL脚本目录 -v /data/mysql/config:/app/config \ # 挂载配置目录 --restart=always \ mysql-ops-tool:latest
环境变量配置
| 环境变量名 | 描述 | 默认值 |
|---|---|---|
MYSQL_HOST | 目标MySQL主机地址（支持多实例用逗号分隔） | localhost |
MYSQL_PORT | MySQL服务端口 | 3306 |
MYSQL_USER | 数据库操作账号（需具备EXECUTE/SELECT权限） | root |
MYSQL_PASSWORD | 数据库账号密码（必填项） | 无 |
BACKUP_DIR | 备份文件存储路径（容器内） | /app/backups |
BACKUP_CRON | 定时备份Cron表达式（如"0 1 * * *"） | 无（不启用定时备份） |
BACKUP_RETENTION_DAYS | 备份文件保留天数 | 7 |
AUDIT_RULES_PATH | 审核规则配置文件路径（容器内） | /app/config/rules.yml |
LOG_LEVEL | 日志级别（DEBUG/INFO/WARN/ERROR） | INFO |
卷挂载说明
| 容器路径 | 用途 | 建议挂载宿主机路径 |
|---|---|---|
/backups | 存储备份文件 | /data/mysql/backups |
/scripts | 存放待执行SQL脚本 | /data/mysql/scripts |
/app/config | 自定义配置文件（规则/日志等） | /data/mysql/config |
/app/logs | 工具运行日志 | /data/mysql/ops-logs |
审核规则配置示例（rules.yml）
yamlaudit: enabled: true syntax_check: true performance: enable_full_scan_check: true # 检测全表扫描 max_join_tables: 5 # 限制JOIN表数量上限 security: forbidden_commands: # 禁止执行的命令 - "DROP DATABASE" - "TRUNCATE TABLE" update_without_where: false # 禁止无WHERE条件的UPDATE delete_without_where: false # 禁止无WHERE条件的DELETE
典型操作流程#### 1. SQL审核流程
- 将待审核SQL文件放入
/scripts/audit目录 - 工具自动扫描并执行审核，结果输出至
/app/logs/audit.log - 查看审核报告，修正违规语句后执行
2. 批量执行SQL
- 将脚本文件（如
init_data.sql）放入/scripts/execution目录 - 容器自动按文件名顺序执行（支持通配符匹配
*.sql） - 执行结果记录于
/app/logs/execution.log，包含成功/失败状态
3. 备份与恢复
- 手动触发备份：进入容器执行
/app/bin/backup.sh - 查看备份列表：执行
/app/bin/list_backups.sh - 恢复数据：执行
/app/bin/restore.sh <备份文件名>（需停止应用写入）
注意事项
- 首次使用需通过
MYSQL_USER配置具备足够权限的数据库账号（建议授予SELECT, INSERT, UPDATE, DELETE, EXECUTE权限） - 定时备份任务需确保容器时间与宿主机同步（建议挂载
/etc/localtime:/etc/localtime:ro） - 生产环境建议启用备份文件异地备份，避免单点存储风险
- 自定义审核规则需遵循YAML格式，详细规则语法参见工具内置文档（容器内
/app/docs/rules_guide.md）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 goinception 镜像标签
docker pull docker.xuanyuan.run/hanchuanchuan/goinception:<标签>
DockerHub 原生拉取命令
docker pull hanchuanchuan/goinception:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"