配置MySQL插件
- 下载插件
开发商登录比特授权云平台,在平台左侧“模块下载 > 集团授权模块”中,下载对应操作系统的集团服务MySQL插件(区分Windows和Linux版本,与产品不绑定)。
下载后将获得plugin_mysql.zip压缩包,内含:
- 动态链接库:plugin_mysql.dll(Windows)或plugin_mysql.so(Linux)
- 配置文件:plugin_mysql.ini
- 部署插件
将压缩包中解压出的动态链接库文件(plugin_mysql.dll或plugin_mysql.so)和配置文件(plugin_mysql.ini),复制到集团服务安装目录下的plugin文件夹中。
- 配置数据库连接
根据实际的MySQL服务器配置,修改plugin_mysql.ini文件中的参数。支持以下两种配置方式:
- 命令行自动设置(推荐)
此方式通过命令行动态配置,便捷高效。它支持以密文或明文形式存储数据库密码,安全性更高。使用此功能需满足:集团服务版本 ≥ 14.4.0,且MySQL插件版本 ≥ 1.1.0.0。具体操作请参见 -plugin_mysql 及 -appkey 命令的帮助文档。
-plugin_mysql:通过此命令直接设置MySQL数据库连接信息(如主机、数据库名、用户名、密码等),插件将自动完成配置。
-appkey:此命令用于设置加密主密钥。当您在-plugin_mysql中提供的数据库密码为密文时,必须使用此密钥进行解密。若未设置,插件在首次配置时将自动生成一个安全的密钥,确保密文密码的安全存储与使用。
- 配置文件手动设置
此方式通过编辑传统的INI文件进行配置。请注意,在此方式下,数据库密码仅能以明文形式存储。其版本要求为:集团服务版本 ≥ 14.2.1,且MySQL插件版本 ≥ 1.0.0.0。详细的配置规则请参阅下方的“配置文件说明”部分。
- 生效配置
重启集团服务,使插件配置生效。
说明:集团服务启动阶段会执行MySQL配置校验,开发商可根据校验提示处理异常问题。
配置文件说明:
plugin_mysql.ini为MySQL插件的配置文件,内容及说明如下:
; 此配置文件由bitanswer提供
; 包含连接数据库所需的关键配置信息
; 数据库配置区域,包含连接MySQL数据库所需的各项参数
[Database]
; MySQL服务器的IP地址,本地服务器通常使用127.0.0.1,远程服务器需填写实际IP
ip=127.0.0.1
; MySQL服务器的端口,默认端口为3306,若服务器修改过端口需填写对应值
port=3306
; MySQL数据库的名称,连接时要访问的具体数据库名
database=bitanswer
; 连接数据库的超时时间,单位秒,超过该时间未建立连接则视为连接失败
timeout=30
; 连接数据库的用户名,用于身份验证的数据库账号
username=root
; 连接数据库的密码,对应用户名的访问密码
password=123456
配置校验
14.5.0及以上版本,集团服务在启动阶段新增了关键组件前置检查功能,该功能可快速识别MySQL配置异常问题,并输出明确错误提示。
-
错误信息格式
通用错误提示(固定显示)+具体错误详情,其中通用错误提示固定为“Failed to connect to the MySQL database.”
-
错误示例:(根据实际情况显示)
[ERROR] Failed to connect to the MySQL database. Access denied for user 'user1'@'192.168.1.121' (using password: YES)
// 上述错误表明数据库用户名或密码错误,解决方案:检查并修正plugin_mysql.ini配置文件中的数据库用户名或密码。