--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.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 外掛程式的資訊，請參閱 第 8.4.1.3 節，「SHA-256 可插拔身份驗證」 和 第 8.4.1.2 節，「快取 SHA-2 可插拔身份驗證」。

--ssl-ca=file_name

憑證授權單位 (CA) 憑證檔案的路徑名稱，格式為 PEM。該檔案包含信任的 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

用戶端 SSL 公開金鑰憑證檔案的路徑名稱，格式為 PEM。支援鏈結的 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，則不會執行任何 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 選項不同，它不是用於建立加密連線，而是用於影響允許哪些密碼編譯操作。請參閱第 8.8 節，「FIPS 支援」。

這些 --ssl-fips-mode 值是允許的

若要指定伺服器的 FIPS 模式，請設定 ssl_fips_mode 系統變數。

--ssl-key=file_name

用戶端 SSL 私人金鑰檔案的路徑名稱，格式為 PEM。為了獲得更好的安全性，請使用 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

用於工作階段重複使用的用戶端 SSL 工作階段資料檔案路徑名稱，格式為 PEM。

當您使用 --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 Server 的版本。

應選擇允許的協定，以避免在列表中留下「漏洞」。例如，以下這些值沒有漏洞

--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 壓縮的連線沒有影響。