--default-auth=plugin

關於要使用哪個用戶端驗證外掛程式的提示。請參閱第 8.2.17 節，「可插拔驗證」。

--host=host_name, -h host_name

執行 MySQL 伺服器的主機。該值可以是主機名稱、IPv4 位址或 IPv6 位址。預設值為 localhost。

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

用於連接到伺服器的 MySQL 帳戶的密碼。密碼值是選用的。如果未指定，用戶端程式會提示輸入密碼。如果指定，在--password=或-p與其後的密碼之間不能有空格。如果未指定密碼選項，則預設為不傳送密碼。

在命令列上指定密碼應被視為不安全。若要避免在命令列上提供密碼，請使用選項檔案。請參閱第 8.1.2.1 節，「密碼安全性的終端使用者指南」。

若要明確指定沒有密碼，且用戶端程式不應提示輸入密碼，請使用--skip-password選項。

--password1[=pass_val]

用於連接到伺服器的 MySQL 帳戶的多重因素驗證因素 1 的密碼。密碼值是選用的。如果未指定，用戶端程式會提示輸入密碼。如果指定，在--password1=與其後的密碼之間不能有空格。如果未指定密碼選項，則預設為不傳送密碼。

在命令列上指定密碼應被視為不安全。若要避免在命令列上提供密碼，請使用選項檔案。請參閱第 8.1.2.1 節，「密碼安全性的終端使用者指南」。

若要明確指定沒有密碼，且用戶端程式不應提示輸入密碼，請使用--skip-password1選項。

--password1和--password是同義詞，--skip-password1和--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 選項用於指定驗證外掛程式，但用戶端程式找不到它，請指定此選項。請參閱 第 8.2.17 節「可插拔驗證」。

--port=port_num, -P port_num

對於 TCP/IP 連線，要使用的埠號。預設的埠號為 3306。

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

此選項明確指定要用於連線到伺服器的傳輸協定。當其他連線參數通常導致使用您不想要的協定時，此選項很有用。例如，在 Unix 上連線到 localhost 預設會使用 Unix socket 檔案。

mysql --host=localhost

若要強制改為使用 TCP/IP 傳輸，請指定 --protocol 選項

mysql --host=localhost --protocol=TCP

下表顯示允許的 --protocol 選項值，並指出每個值適用的平台。這些值不區分大小寫。

另請參閱 第 6.2.7 節「連線傳輸協定」

--shared-memory-base-name=name

在 Windows 上，使用共用記憶體連線到本機伺服器時要使用的共用記憶體名稱。預設值為 MYSQL。共用記憶體名稱區分大小寫。

只有在伺服器啟動時啟用 shared_memory 系統變數以支援共用記憶體連線時，此選項才適用。

--socket=path, -S path

在 Unix 上，使用具名管道連線到本機伺服器時要使用的 Unix socket 檔案名稱。預設的 Unix socket 檔案名稱為 /tmp/mysql.sock。

在 Windows 上，連線到本機伺服器時要使用的具名管道名稱。預設的 Windows 管道名稱為 MySQL。管道名稱不區分大小寫。

在 Windows 上，只有在伺服器啟動時啟用 named_pipe 系統變數以支援具名管道連線時，此選項才適用。此外，建立連線的使用者必須是 named_pipe_full_access_group 系統變數指定的 Windows 群組的成員。

--user=user_name, -u user_name

用於連線到伺服器的 MySQL 帳戶的使用者名稱。在 Windows 上，預設使用者名稱為 ODBC，在 Unix 上則為您的 Unix 登入名稱。

--get-server-public-key

從伺服器請求 RSA 金鑰配對式密碼交換所需的公開金鑰。此選項適用於使用 caching_sha2_password 驗證外掛程式驗證的用戶端。對於該外掛程式，除非要求，否則伺服器不會傳送公開金鑰。對於未使用該外掛程式驗證的帳戶，將會忽略此選項。如果未使用基於 RSA 的密碼交換，也會忽略此選項，例如當用戶端使用安全連線連線到伺服器時。

如果提供 --server-public-key-path=file_name，並指定有效的公開金鑰檔案，則其優先於 --get-server-public-key。

如需有關 caching_sha2_password 外掛程式的資訊，請參閱 第 8.4.1.1 節「快取 SHA-2 可插拔驗證」。

--server-public-key-path=file_name

包含伺服器基於 RSA 金鑰配對式密碼交換所需的公開金鑰的用戶端副本的 PEM 格式檔案的路徑名稱。此選項適用於使用 sha256_password 或 caching_sha2_password 驗證外掛程式驗證的用戶端。對於未使用這些外掛程式之一驗證的帳戶，將會忽略此選項。如果未使用基於 RSA 的密碼交換，也會忽略此選項，例如當用戶端使用安全連線連線到伺服器時。

如果提供 --server-public-key-path=file_name，並指定有效的公開金鑰檔案，則其優先於 --get-server-public-key。

只有在使用 OpenSSL 建置 MySQL 時，此選項才可用。

如需有關 sha256_password 和 caching_sha2_password 外掛程式的資訊，請參閱 第 8.4.1.2 節「SHA-256 可插拔驗證」和 第 8.4.1.1 節「快取 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 公開金鑰憑證檔案，請設定 ssl_cert 系統變數。

--ssl-cipher=cipher_list

使用 TLS 協定（最高至 TLSv1.2）的連線可允許的加密密碼清單。如果清單中沒有支援的密碼，則使用這些 TLS 協定的加密連線將無法運作。

為了獲得最佳的可攜性，cipher_list 應該是一個或多個以冒號分隔的密碼名稱清單。例如：

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

OpenSSL 支援在 OpenSSL 文件 https://www.openssl.org/docs/manmaster/man1/ciphers.html 中描述的指定密碼語法。

有關 MySQL 支援哪些加密密碼的資訊，請參閱 第 8.3.2 節「加密連線 TLS 協定和密碼」。

若要指定伺服器的加密密碼，請設定 ssl_cipher 系統變數。

--ssl-crl=file_name

包含以 PEM 格式表示的憑證撤銷清單的檔案路徑名稱。

如果沒有提供 --ssl-crl 或 --ssl-crlpath，則即使 CA 路徑包含憑證撤銷清單，也不會執行 CRL 檢查。

若要指定伺服器的撤銷清單檔案，請設定 ssl_crl 系統變數。

--ssl-crlpath=dir_name

包含以 PEM 格式表示的憑證撤銷清單檔案的目錄路徑名稱。

如果沒有提供 --ssl-crl 或 --ssl-crlpath，則即使 CA 路徑包含憑證撤銷清單，也不會執行 CRL 檢查。

若要指定伺服器的撤銷清單目錄，請設定 ssl_crlpath 系統變數。

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

控制是否在用戶端啟用 FIPS 模式。--ssl-fips-mode 選項與其他 --ssl-xxx 選項不同，它不是用於建立加密連線，而是用於影響允許哪些加密操作。請參閱 第 8.8 節「FIPS 支援」。

允許使用這些 --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 工作階段資料檔案路徑名稱，用於工作階段重複使用。

當您使用 --ssl-session-data 選項叫用 MySQL 用戶端程式時，用戶端會嘗試從檔案還原序列化工作階段資料（如果有的話），然後使用它來建立新的連線。如果您提供一個檔案，但工作階段未重複使用，則連線會失敗，除非您在叫用用戶端程式時也在命令列上指定了 --ssl-session-data-continue-on-failed-reuse 選項。

mysql 命令、ssl_session_data_print 會產生工作階段資料檔案（請參閱第 6.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 函式庫。如果未設定此選項，則用戶端允許使用預設的密碼套件集。如果將此選項設定為空字串，則不會啟用任何密碼套件，並且無法建立加密連線。如需更多資訊，請參閱第 8.3.2 節「加密連線 TLS 協定與密碼」。

若要指定伺服器允許哪些密碼套件，請設定 tls_ciphersuites 系統變數。

--tls-version=protocol_list

此選項指定用戶端允許哪些 TLS 協定用於加密連線。該值是一個或多個以逗號分隔的協定版本列表。例如

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

此選項可指定的協定取決於用於編譯 MySQL 的 SSL 函式庫，以及 MySQL 伺服器版本。

應選擇允許的協定，使其列表不留有「漏洞」。例如，以下這些值沒有漏洞

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

詳細資訊，請參閱第 8.3.2 節「加密連線 TLS 協定與密碼」。

若要指定伺服器允許哪些 TLS 協定，請設定 tls_version 系統變數。

--compress, -C

盡可能壓縮用戶端和伺服器之間傳送的所有資訊。

此選項已過時。預計將在未來版本的 MySQL 中移除。請參閱設定舊版連線壓縮。

--compression-algorithms=value

允許用於連線至伺服器的壓縮演算法。可用的演算法與 protocol_compression_algorithms 系統變數相同。預設值為 uncompressed。

--zstd-compression-level=level

使用 zstd 壓縮演算法連線至伺服器時使用的壓縮層級。允許的層級為 1 到 22，較大的值表示較高的壓縮層級。預設的 zstd 壓縮層級為 3。壓縮層級設定對未使用 zstd 壓縮的連線沒有影響。