MySQL程序之：连接到服务器的命令选项

注：这些选项仅对使用受加密的传输协议的连接有效；即TCP/IP和Unix套接字文件连接。

表6.5加密连接选项摘要

--get-server-public-key

 向服务器请求基于RSA密钥对的密码交换所需的公钥。此选项适用于使用caching_sha2_password鉴权插件进行身份验证的客户端。对于该插件，除非请求，否则服务器不会发送公钥。对于未使用该插件进行身份验证的帐户，此选项将被忽略。如果不使用基于RSA的密码交换，也会忽略此选项，就像客户端使用安全连接连接到服务器时一样。

如果给出--server-public-key-path=file_name并指定有效的公钥文件，则它优先于--get-server-public-key。

--server-public-key-path=file_name

PEM格式文件的路径名，其中包含服务器进行基于RSA密钥对的密码交换所需的公钥的客户端副本。此选项适用于使用sha256_password（已弃用）或caching_sha2_password鉴权插件进行身份验证的客户端。对于未使用这些插件之一进行身份验证的帐户，此选项将被忽略。如果不使用基于RSA的密码交换，也会忽略此选项，就像客户端使用安全连接连接到服务器时一样。

如果给出--server-public-key-path=file_name并指定有效的公钥文件，则它优先于--get-server-public-key。

此选项仅在使用OpenSSL构建MySQL时可用。

--ssl-ca=file_name

 PEM格式的证书授权中心（CA）证书文件的路径名。该文件包含受信任的SSL证书颁发机构列表。

要告诉客户端在与服务器建立加密连接时不要验证服务器证书，请既不指定--ssl-ca也不指定--ssl-capath。服务器仍然根据为客户端帐户建立的任何适用要求验证客户端，并且仍然使用服务器端指定的任何ssl_ca或ssl_capath系统变量值。

要为服务器指定CA文件，请设置ssl_ca系统变量。

--ssl-capath=dir_name

包含PEM格式的可信SSL证书颁发机构（CA）证书文件的目录的路径名。

要告诉客户端在与服务器建立加密连接时不要验证服务器证书，请既不指定--ssl-ca也不指定--ssl-capath。服务器仍然根据为客户端帐户建立的任何适用要求验证客户端，并且仍然使用服务器端指定的任何ssl_ca或ssl_capath系统变量值。

要为服务器指定CA目录，请设置ssl_capath系统变量。

 --ssl-cert=file_name

PEM格式的客户端SSL公钥证书文件的路径名。支持链式SSL证书。

要指定服务器SSL公钥证书文件，请设置ssl_cert系统变量。

--ssl-cipher=cipher_list

使用TLSv1.2的连接的允许加密密码列表。如果列表中不支持密码，则使用这些TLS协议的加密连接将不起作用。

为了最大的可移植性，cipher_list应该是一个或多个密码名称的列表，由冒号分隔。例子：

--ssl-cipher=AES128-SHA
--ssl-cipher=DHE-RSA-AES128-GCM-SHA256:AES128-SHA

 OpenSSL支持https://www.openssl.org/docs/manmaster/man1/ciphers.html的OpenSSL留档中描述的指定密码的语法。

要为服务器指定加密密码，请设置ssl_cipher系统变量。

--ssl-crl=file_name

包含PEM格式证书吊销列表的文件的路径名。

如果既没有给出--ssl-crl也没有给出--ssl-crlpath，则不会执行CRL检查，即使CA路径包含证书吊销列表。

要为服务器指定撤销列表文件，请设置ssl_crl系统变量。

--ssl-crlpath=dir_name

 包含PEM格式的证书吊销列表文件的目录的路径名。

如果既没有给出--ssl-crl也没有给出--ssl-crlpath，则不会执行CRL检查，即使CA路径包含证书吊销列表。

要指定服务器的吊销列表目录，请设置ssl_crlpath系统变量。

--ssl-fips-mode={OFF|ON|STRICT}

控制是否在客户端启用FIPS模式。--ssl-fips-mode选项与其他--ssl-xxx选项的不同之处在于它不用于建立加密连接，而是影响允许哪些加密操作。

这些--ssl-fips-mode值是允许的：

• OFF：禁用FIPS模式。

• ON：启用FIPS模式。

• STRICT：启用“严格”FIPS模式。

注：如果OpenSSL FIPS对象模块不可用，则--ssl-fips-mode的唯一允许值为OFF。在这种情况下，将--ssl-fips-mode设置为ON或STRICT会导致客户端在启动时产生警告并在非FIPS模式下运行。

要为服务器指定FIPS模式，请设置ssl_fips_mode系统变量。

--ssl-key=file_name

PEM格式的客户端SSL私钥文件的路径名。为提高安全性，请使用RSA密钥大小至少为2048位的证书。

如果密钥文件受密码保护，客户端程序会提示用户输入密码。密码必须以交互方式给出；它不能存储在文件中。如果密码不正确，程序会继续运行，就好像它无法读取密钥一样。

要指定服务器SSL私钥文件，请设置ssl_key系统变量。

--ssl-mode=mode

此选项指定与服务器的连接所需的安全状态。这些模式值是允许的，按越来越严格的顺序排列：

• DISABLED：建立未加密的连接。

• PREFERRED：如果服务器支持加密连接，则建立加密连接，如果无法建立加密连接，则回退到未加密连接。如果未指定--ssl-mode，则默认设置。Unix套接字文件上的连接不会使用PREFERRED模式进行加密。要对Unix套接字文件连接强制加密，请使用REQUIRED或更严格的模式。（但是，套接字文件传输默认是安全的，因此加密套接字文件连接会使其不再安全并增加CPU负载。）

• REQUIRED：如果服务器支持加密连接，则建立加密连接。如果无法建立加密连接，则连接尝试失败。

• VERIFY_CA：与REQUIRED类似，但要根据配置的CA证书验证服务器证书授权中心（CA）证书。如果未找到有效匹配的CA证书，连接尝试将失败。

• VERIFY_IDENTITY：类似于VERIFY_CA，但通过检查客户端用于连接到服务器的主机名与服务器发送给客户端的证书中的身份来执行主机名身份校验：如果客户端使用OpenSSL1.0.2或更高版本，客户端将检查用于连接的主机名是否与服务器证书中的主题备用名称值或通用名称值匹配。主机名身份校验也适用于使用通配符指定通用名称的证书。否则，客户端会检查它用于连接的主机名是否与服务器证书中的Common Name值匹配。

如果存在不匹配，连接将失败。对于加密连接，此选项有助于防止中间人攻击。

VERIFY_IDENTITY的主机名身份校验不适用于服务器自动创建的自签名证书。此类自签名证书不包含服务器名称作为Common Name值。

重要：默认设置--ssl-mode=PREFERRED在其他默认设置不变的情况下生成加密连接。但是，为了帮助防止复杂的中间人攻击，客户端验证服务器的身份非常重要。设置--ssl-mode=VERIFY_CA和--ssl-mode=VERIFY_IDENTITY是比默认设置更好的选择，有助于防止此类攻击。要实现其中一个设置，您必须首先确保服务器的CA证书可靠地全员可用，否则将导致可用性问题。因此，它们不是默认设置。

--ssl-mode选项与CA证书选项交互如下：

1、如果没有显式设置--ssl-mode，则使用--ssl-ca或--ssl-capath意味着--ssl-mode=VERIFY_CA。

2、对于VERIFY_CA或VERIFY_IDENTITY的--ssl-mode值，还需要--ssl-ca或--ssl-capath，以提供与服务器使用的CA证书匹配的CA证书。

3、具有VERIFY_CA或VERIFY_IDENTITY以外的值的显式--ssl-mode选项以及显式--ssl-ca或--ssl-capath选项会产生警告，指出尽管指定了CA证书选项，但不会执行服务器证书验证。

要要求MySQL帐户使用加密连接，请使用CREATE USER创建带有REQUIRE SSL子句的帐户，或使用ALTER USER为现有帐户添加REQUIRE SSL子句。这会导致使用该帐户的客户端的连接尝试被拒绝，除非MySQL支持加密连接并且可以建立加密连接。

REQUIRE子句允许其他与加密相关的选项，这些选项可用于强制执行比REQUIRE SSL更严格的安全要求。有关使用使用各种REQUIRE选项配置的帐户进行连接的客户端可以或必须指定哪些命令选项的更多详细信息，请参阅CREATE USER SSL/TLS选项。

--ssl-session-data=file_name

 用于会话重用的PEM格式的客户端SSL会话数据文件的路径名。

当您使用--ssl-session sion-data选项调起MySQL客户端程序时，客户端会尝试从文件中反序列化会话数据（如果提供），然后使用它来建立新连接。如果您提供了文件，但会话没有被重用，则连接会失败，除非您在调用客户端程序时还在命令行中指定了--ssl-session-data-continue-on-failed-reuse选项。

mysql命令ssl_session_data_print生成会话数据文件。

ssl-session-data-continue-on-failed-reuse

控制是否启动新连接以替换使用--ssl-session-data命令行选项指定的尝试但未能重用会话数据的尝试连接。默认情况下，--ssl-session-data-continue-on-failed-reuse命令行选项关闭，这会导致客户端程序在提供会话数据但未重用时返回连接失败。

为了确保在会话重用静默失败后打开一个新的不相关的连接，请使用--ssl-session-data和--ssl-session-data-continue-on-failed-reuse命令行选项调用MySQL客户端程序。

--tls-ciphersuites=ciphersuite_list

 此选项指定客户端允许使用TLSv1.3的加密连接使用哪些密码套件。该值是零个或多个冒号分隔的密码套件名称的列表。例如：

mysql --tls-ciphersuites="suite1:suite2:suite3"

可以为此选项命名的密码套件取决于用于编译MySQL的SSL库。如果未设置此选项，则客户端允许默认密码套件集。如果该选项设置为空字符串，则不启用密码套件，并且无法建立加密连接。

要指定服务器允许的密码套件，请设置tls_ciphersuites系统变量。

--tls-version=protocol_list

此选项指定客户端允许加密连接的TLS协议。该值是一个或多个逗号分隔协议版本的列表。例如：

mysql --tls-version="TLSv1.2,TLSv1.3"

 可以为此选项命名的协议取决于用于编译MySQL的SSL库和MySQL服务器版本。

重要：支持--tls-version选项的客户端（包括MySQL Shell）无法使用设置为TLSv1或TLSv1.1的协议建立TLS/SSL连接。如果客户端尝试使用这些协议进行连接，则对于TCP连接，连接失败，并向客户端返回错误。对于套接字连接，如果--ssl-mode设置为REQUIRED，则连接失败，否则建立连接但禁用TLS/SSL。

MySQL Server中支持TLSv1.3协议，前提是MySQL Server是使用OpenSSL1.1.1或更高版本编译的。服务器在启动时检查OpenSSL的版本，如果低于1.1.1，TLSv1.3将从与TLS版本相关的服务器系统变量（如tls_version系统变量）的默认值中删除。

应选择允许的协议，例如不要在列表中留下“漏洞”。例如，这些值没有漏洞：

--tls-version="TLSv1.2,TLSv1.3"
--tls-version="TLSv1.3"

要指定服务器允许的TLS协议，请设置tls_version系统变量。

连接压缩的命令选项

本节介绍了使客户端程序能够控制对与服务器的连接使用压缩的选项。

表6.6连接压缩选项摘要

--compress, -C 

如果可能，压缩客户端和服务器之间发送的所有信息。此选项已弃用。预计它将在MySQL的未来版本中被删除。

--compression-algorithms=value

 与服务器连接的允许压缩算法。可用算法与protocol_compression_algorithms系统变量相同。默认值未压缩。

--zstd-compression-level=level

用于连接到使用zstd压缩算法的服务器的压缩级别。允许的级别从1到22，较大的值表示压缩级别增加。默认zstd压缩级别为3。压缩级别设置对不使用zstd压缩的连接没有影响。