--default-auth=plugin

关于使用哪个客户端身份验证插件的提示。请参阅第 6.2.17 节，“可插入身份验证”。

--host=host_name, -h host_name

运行 MySQL 服务器的主机。该值可以是主机名、IPv4 地址或 IPv6 地址。默认值为localhost。

--password[=pass_val], -p[pass_val]

用于连接到服务器的 MySQL 帐户的密码。密码值是可选的。如果没有给出，客户端程序会提示输入一个。如果给定，则 后面 的密码之间 不能有空格。如果未指定密码选项，则默认为不发送密码。 --password=-p

在命令行上指定密码应该被认为是不安全的。为避免在命令行中提供密码，请使用选项文件。请参阅 第 6.1.2.1 节，“密码安全的最终用户指南”。

要明确指定没有密码并且客户端程序不应提示输入密码，请使用该 --skip-password 选项。

--password1[=pass_val]

用于连接服务器的 MySQL 帐户的多因素身份验证因子 1 的密码。密码值是可选的。如果没有给出，客户端程序会提示输入一个。如果给定，则后面的密码和密码之间 不能有空格--password1=。如果未指定密码选项，则默认为不发送密码。

在命令行上指定密码应该被认为是不安全的。为避免在命令行中提供密码，请使用选项文件。请参阅 第 6.1.2.1 节，“密码安全的最终用户指南”。

要明确指定没有密码并且客户端程序不应提示输入密码，请使用该 --skip-password1 选项。

--password1and --password是同义词，就像 --skip-password1 and 一样--skip-password。

--password2[=pass_val]

用于连接到服务器的 MySQL 帐户的多因素身份验证因子 2 的密码。此选项的语义类似于 ; 的语义 --password1。有关详细信息，请参阅该选项的说明。

--password3[=pass_val]

用于连接服务器的 MySQL 帐户的多重身份验证因子 3 的密码。此选项的语义类似于 ; 的语义 --password1。有关详细信息，请参阅该选项的说明。

--pipe,-W

在 Windows 上，使用命名管道连接到服务器。仅当服务器启动时 named_pipe启用了支持命名管道连接的系统变量时，此选项才适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

--plugin-dir=dir_name

在其中查找插件的目录。如果该--default-auth 选项用于指定身份验证插件但客户端程序找不到它，请指定此选项。请参阅 第 6.2.17 节，“可插入身份验证”。

--port=port_num, -P port_num

对于 TCP/IP 连接，要使用的端口号。默认端口号为 3306。

--protocol={TCP|SOCKET|PIPE|MEMORY}

此选项明确指定用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时，它很有用。例如，在 Unix 上localhost默认使用 Unix 套接字文件建立连接：

mysql --host=localhost

要强制改用 TCP/IP 传输，请指定一个 --protocol选项：

mysql --host=localhost --protocol=TCP

下表显示了允许的 --protocol选项值，并指出了每个值的适用平台。这些值不区分大小写。

另见第 4.2.7 节，“连接传输协议”

--shared-memory-base-name=name

在 Windows 上，用于使用共享内存与本地服务器建立连接的共享内存名称。默认值为MYSQL。共享内存名称区分大小写。

仅当服务器启动时 shared_memory启用了支持共享内存连接的系统变量时，此选项才适用。

--socket=path, -S path

在 Unix 上，用于使用命名管道与本地服务器建立连接的 Unix 套接字文件的名称。默认的 Unix 套接字文件名为 /tmp/mysql.sock.

在 Windows 上，用于连接到本地服务器的命名管道的名称。默认的 Windows 管道名称是MySQL. 管道名称不区分大小写。

在 Windows 上，仅当服务器启动时named_pipe 启用了支持命名管道连接的系统变量时，此选项才适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

--user=user_name, -u user_name

用于连接到服务器的 MySQL 帐户的用户名。默认用户名ODBC 在 Windows 上或在 Unix 上是您的 Unix 登录名。

--get-server-public-key

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

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

有关 caching_sha2_password插件的信息，请参阅 第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”。

--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 时，此选项才可用。

有关sha256_password 和caching_sha2_password插件的信息，请参阅 第 6.4.1.3 节，“SHA-256 可插入身份验证”和 第 6.4.1.2 节，“缓存 SHA-2 可插入身份验证”。

--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_cert系统变量。

--ssl-cipher=cipher_list

通过 TLSv1.2 使用 TLS 协议的连接的允许加密密码列表。如果列表中的密码均不受支持，则使用这些 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 文档中描述的用于指定密码的语法 。

有关 MySQL 支持哪些加密密码的信息，请参阅 第 6.3.2 节，“加密连接 TLS 协议和密码”。

要为服务器指定加密密码，请设置 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选项与其他 选项的不同之处在于它不用于建立加密连接，而是用于影响允许哪些加密操作。请参见第 6.8 节 “FIPS 支持”。 --ssl-xxx

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

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

--ssl-key=file_name

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

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

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

--ssl-mode=mode

此选项指定与服务器的连接所需的安全状态。按照严格程度递增的顺序，这些模式值是允许的：

该--ssl-mode选项与 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 会话数据文件的路径名，用于会话重用。

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

mysql命令 ssl_session_data_print生成会话数据文件（请参阅 第4.5.1.2 节，“mysql 客户端命令”）。

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 库。如果未设置此选项，则客户端允许使用默认的密码套件集。如果该选项设置为空字符串，则不会启用任何密码套件，并且无法建立加密连接。有关详细信息，请参阅 第 6.3.2 节，“加密连接 TLS 协议和密码”。

这个选项是在 MySQL 8.0.16 中添加的。

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

--tls-version=protocol_list

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

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

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

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

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

From MySQL 8.0.28, only the last two values are suitable.

这些值确实有漏洞，不应使用：

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

有关详细信息，请参阅 第 6.3.2 节，“加密连接 TLS 协议和密码”。

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

--compress, -C

如果可能，压缩客户端和服务器之间发送的所有信息。

从 MySQL 8.0.18 开始，不推荐使用此选项。预计它会在 MySQL 的未来版本中被删除。请参阅 配置传统连接压缩。

--compression-algorithms=value

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

这个选项是在 MySQL 8.0.18 中添加的。

--zstd-compression-level=level

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

这个选项是在 MySQL 8.0.18 中添加的。