一、Yearning介绍

二、Yearning安装

1. Yearning 安装注意事项

2. Yearning 安装包下载

3. Yearning 安装包解压

4. Yearning 配置文件修改

5. Yearning 初始化数据

6. Yearning 服务启动

7. Yearning 管理页面

三、参考资料

一、Yearning介绍

Yearning MYSQL SQL语句审核平台，提供查询审计、SQL审核、SQL回滚、自定义工作流等多种功能。

功能说明：

•  自动化SQL语句审核，可对SQL进行自动检测并执行；
•  DDL/DML语句执行后自动生成回滚语句；
•  历史审核记录、查询审计功能；
•  支持LDAP登录/钉钉自定义webhook及邮件消息推送；
•  支持自定义审核工作流，自定义审核层级；
•  支持细粒度权限分配，包括用户及权限组管理。

语法支持：

Yearning 目前兼容99%的Mysql 标准SQL语法。 但由于审核逻辑等因素的限制,对一些SQL语句并不能保证得到正确的反馈 已知不支持的语句类型有:

•  复杂的查询语句(多表,多函数,非必现。并不是所有复杂语句不支持)
•  外键相关语句
•  不支持跨库DML语句的回滚
•  存储过程/触发器

仅代表当前语法支持进度，并不作为未来完成度。

二、Yearning安装

1. Yearning 安装注意事项

• Yearning 不依赖于任何第三方 SQL 审核工具作为审核引擎，内部已自己实现审核/回滚相关逻辑。
• 仅依赖 Mysql 数据库，mysql 版本必须为5.7及以上版本(8.0及以上请将sql_mode 设置为空)并已事先自行安装完毕且创建 Yearning 库,字符集应为 UTF8mb4 (仅 Yearning 所需 mysql 版本)
• Yearning 基于 1080p 分辨率开发仅支持 1080p 及以上显示器访问，对于设置页面配置重叠的问题请确认自己的分辨率以及是否进行了放大操作，请使用 Chrome 最新版本(不包括 360 等其他魔改版本)

2. Yearning 安装包下载

下载地址 https://github.com/cookieY/Yearning/releases

请选择最新版本 在 Assets 中选择 Yearning-x.x.x.linux-amd64.zip 包进行下载

如需进行代码修改或自己编译请移步至二次开发页面

3. Yearning 安装包解压

• 将下载的 安装包上传到linux服务器上

• 执行如下命令进行解压

unzip Yearning-XXXX-linux-amd64.zip 

• 解压后的目录结构

4. Yearning 配置文件修改

修改conf.toml文件，配置Yearning数据源信息：

vi conf.toml

[Mysql]
# 数据库名
Db = "Yearning"
# 数据库地址
Host = "127.0.0.1"
# 数据库端口号
Port = "3306"
# 数据库密码
Password = "xxxx"
# 数据库账号
User = "root"

[General]
# 数据库加解密key，只可更改一次，且必须是16位，大小字母均可。
SecretKey = "dbcjqheupqjsuwsm"

关于 SecretKey：SecretKey 是 token/数据库密码加密/解密的 salt。
建议所有用户在初次安装 Yearning 之前将 SecretKey 更改(不更改将存在安全风险)

格式: 大小写字母均可, 长度必须为 16 位 如长度不是16位将会导致无法新建数据源

特别注意：此 key 仅可在初次安装时更改！之后不可再次更改!如再次更改会导致之前已存放的数据源密码无法解密，最终导致无法获取相关数据源信息。

5. Yearning 初始化数据

# 请务必在服务启动前先执行数据初始化操作！
# 如要再次初始化，请先把 yearning 库下所有表删除，否则重复执行无效

./Yearning -m

6. Yearning 服务启动

# 默认启动脚本
./Yearning -s

# 带参数启动
./Yearning -s -b "127.0.0.1" -p "20000"

7. Yearning 管理页面

打开浏览器访问 http://127.0.0.1:8000 ，即可打开管理页面，默认账号/密码：admin/Yearning_admin

三、参考资料

官方网站：http://yearning.io/