--default-auth=plugin

Подсказка о том, какой плагин аутентификации на стороне клиента использовать. См. Раздел 6.2.13, «Подключаемая аутентификация».

--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.

--pipe, -W

В Windows подключайтесь к серверу через именованный канал. Эта опция применяется только если сервер был запущен с включенной системной переменной named_pipe для поддержки подключений через именованные каналы. Кроме того, пользователь, производящий подключение, должен быть членом группы Windows, указанной в системной переменной named_pipe_full_access_group.

--plugin-dir=dir_name

Каталог, в котором следует искать плагины. Укажите эту опцию, если опция --default-auth используется для указания плагина аутентификации, но клиентская программа не находит его. См. Раздел 6.2.13, «Подключаемая аутентификация».

--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.5, «Протоколы транспортного подключения»

--secure-auth

Не отправлять пароли на сервер в старом (до 4.1) формате. Это предотвращает подключения, кроме серверов, использующих новый формат паролей.

Начиная с MySQL 5.7.5, эта опция устарела; ожидается, что она будет удалена в будущих выпусках MySQL. Она всегда включена, и попытка её отключения (--skip-secure-auth, --secure-auth=0) приводит к ошибке. До MySQL 5.7.5 эта опция включена по умолчанию, но может быть отключена.

--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 для поддержки подключений через именованные трубы. Кроме того, пользователь, осуществляющий подключение, должен быть членом группы Windows, указанной в системной переменной named_pipe_full_access_group.

--user=user_name, -u user_name

Имя пользователя учетной записи MySQL, используемой для подключения к серверу. Значение по умолчанию — ODBC в Windows или имя вашей учётной записи в 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.4, «Caching SHA-2 Pluggable Authentication».

Параметр --get-server-public-key был добавлен в MySQL 5.7.23.

--server-public-key-path=file_name

Имя пути к файлу в формате PEM, содержащему копию открытого ключа на стороне клиента, необходимую серверу для обмена паролями на основе пар ключей RSA. Этот параметр применяется к клиентам, которые аутентифицируются с помощью плагина sha256_password или caching_sha2_password аутентификации. Этот параметр игнорируется для учётных записей, которые не аутентифицируются с помощью одного из этих плагинов. Он также игнорируется, если обмен паролями на основе RSA не используется, как в случае, когда клиент подключается к серверу с помощью защищённого соединения.

Этот параметр доступен только в том случае, если MySQL был скомпилирован с использованием OpenSSL.

Сведения о плагинах sha256_password и caching_sha2_password см. в разделе 6.4.1.5, «SHA-256 Pluggable Authentication» и разделе 6.4.1.4, «Caching SHA-2 Pluggable Authentication».

--ssl, --skip-ssl

По умолчанию программы-клиенты MySQL пытаются установить защищённое соединение, если сервер поддерживает защищённые соединения, с дополнительным управлением, доступным через параметр --ssl: параметр --ssl на стороне клиента работает следующим образом:

Для требования использования защищённых соединений учётной записью MySQL используйте CREATE USER для создания учётной записи с клаузой REQUIRE SSL или ALTER USER для существующей учётной записи, чтобы добавить клаузу REQUIRE SSL. Это приводит к тому, что попытки подключения клиентов, которые используют учётную запись, отклоняются, если MySQL не поддерживает защищённые соединения и защищённое соединение не может быть установлено.

Клауза REQUIRE позволяет использовать другие параметры, связанные с шифрованием, которые могут использоваться для обеспечения требований безопасности, более строгих, чем REQUIRE SSL. Дополнительные сведения о том, какие параметры команд могут быть или должны быть указаны клиентами, которые подключаются с использованием учётных записей, настроенных с использованием различных параметров REQUIRE, см. в разделе «CREATE USER SSL/TLS Options».

Для указания дополнительных параметров для защищённых соединений рассмотрите возможность установки системных переменных ssl_cert и ssl_key на стороне сервера и параметра --ssl-ca на стороне клиента. См. раздел 6.3.1, «Настройка MySQL для использования защищённых соединений», в котором также описаны возможности сервера для автоматического создания и обнаружения файлов сертификата и ключа.

--ssl-ca=file_name

Имя пути к файлу сертификата Удостоверяющего центра (CA) в формате PEM. Файл содержит список надёжных центров сертификации SSL.

Чтобы не аутентифицировать сертификат сервера при установлении защищённого соединения с сервером, не указывайте ни --ssl-ca, ни --ssl-capath. Сервер по-прежнему проверяет клиента в соответствии с любыми применимыми требованиями, установленными для учётной записи клиента, и по-прежнему использует любые значения системных переменных ssl_ca или ssl_capath, указанные на стороне сервера.

Чтобы указать файл CA для сервера, установите системную переменную ssl_ca.

--ssl-capath=dir_name

Имя пути к каталогу, содержащему файлы сертификатов уполномоченных центров сертификации (CA) SSL в формате PEM. Поддержка этой возможности зависит от библиотеки SSL, используемой для компиляции MySQL; см. Раздел 6.3.4, «Возможности, зависящие от библиотеки SSL».

Чтобы не аутентифицировать сертификат сервера при установлении зашифрованного соединения с сервером, не указывайте ни --ssl-ca, ни --ssl-capath. Сервер всё равно проверяет клиента в соответствии с любыми применимыми требованиями, установленными для учётной записи клиента, и по-прежнему использует любые значения системных переменных ssl_ca или ssl_capath, указанные на стороне сервера.

Для указания каталога CA для сервера установите системную переменную ssl_capath.

--ssl-cert=file_name

Имя пути к файлу сертификата открытого ключа клиента SSL в формате PEM.

Чтобы указать файл сертификата открытого ключа сервера SSL, установите системную переменную ssl_cert.

--ssl-cipher=cipher_list

Список допустимых шифров для шифрования соединения. Если ни один из шифров в списке не поддерживается, зашифрованные соединения не работают.

Для наибольшей переносимости cipher_list должен быть списком одного или нескольких имён шифров, разделённых двоеточиями. Этот формат поддерживается как OpenSSL, так и yaSSL. Примеры:

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

OpenSSL поддерживает более гибкий синтаксис для указания шифров, как описано в документации OpenSSL по адресу https://www.openssl.org/docs/manmaster/man1/ciphers.html. yaSSL этого не делает, поэтому попытки использования этого расширенного синтаксиса терпят неудачу для дистрибутива MySQL, скомпилированного с использованием yaSSL.

Сведения о том, какие шифры шифрования поддерживает MySQL, см. в Разделе 6.3.2, «Протоколы и шифры TLS зашифрованного соединения».

Для указания шифров шифрования для сервера установите системную переменную ssl_cipher.

--ssl-crl=file_name

Имя пути к файлу, содержащему списки отзыва сертификатов в формате PEM. Поддержка возможности списка отзыва зависит от библиотеки SSL, используемой для компиляции MySQL. См. Раздел 6.3.4, «Возможности, зависящие от библиотеки SSL».

Если не указаны ни --ssl-crl, ни --ssl-crlpath, проверки CRL не выполняются, даже если путь CA содержит списки отзыва сертификатов.

Чтобы указать файл списка отзыва для сервера, установите системную переменную ssl_crl.

--ssl-crlpath=dir_name

Имя пути к каталогу, содержащему файлы списков отзыва сертификатов в формате PEM. Поддержка возможности списка отзыва зависит от библиотеки SSL, используемой для компиляции MySQL. См. Раздел 6.3.4, «Возможности, зависящие от библиотеки SSL».

Если не указаны ни --ssl-crl, ни --ssl-crlpath, проверки CRL не выполняются, даже если путь CA содержит списки отзыва сертификатов.

Чтобы указать каталог списков отзыва для сервера, установите системную переменную ssl_crlpath.

--ssl-key=file_name

Имя пути к файлу закрытого ключа клиента SSL в формате PEM. Для повышения безопасности используйте сертификат с размером ключа RSA не менее 2048 бит.

Если файл ключа защищён паролем, клиентская программа запрашивает пароль у пользователя. Пароль должен быть введён интерактивно; он не может быть сохранён в файле. Если пароль неверный, программа продолжает работу, как если бы она не могла прочитать ключ.

Чтобы указать файл закрытого ключа сервера SSL, установите системную переменную ssl_key.

--ssl-mode=mode

Этот параметр задаёт желаемое состояние безопасности подключения к серверу. Эти значения режимов допустимы в порядке возрастания строгости:

Параметр --ssl-mode взаимодействует с параметрами сертификатов CA следующим образом:

Параметр --ssl-mode был добавлен в MySQL 5.7.11.

Для требования использования зашифрованных соединений учетной записью MySQL используйте CREATE USER для создания учетной записи с клаузой REQUIRE SSL или используйте ALTER USER для существующей учетной записи, чтобы добавить клаузу REQUIRE SSL. Это приводит к отклонению попыток подключения клиентами, использующими учетную запись, если MySQL не поддерживает зашифрованные соединения и зашифрованное соединение не может быть установлено.

Клауза REQUIRE позволяет использовать другие параметры, связанные с шифрованием, которые могут использоваться для обеспечения требований безопасности, более строгих, чем REQUIRE SSL. Дополнительные сведения о том, какие параметры командной строки могут или должны быть указаны клиентами, подключающимися с использованием учётных записей, настроенных с помощью различных параметров REQUIRE, см. в CREATE USER SSL/TLS Options.

--ssl-verify-server-cert

Этот параметр заставляет клиента выполнять проверку идентификации имени хоста, сравнивая имя хоста, используемое клиентом для подключения к серверу, с идентификатором в сертификате, отправленном сервером клиенту:

Подключение завершается ошибкой в случае несоответствия. Для зашифрованных соединений этот параметр помогает предотвратить атаки «человек посередине». Проверка идентификации имени хоста отключена по умолчанию.

--tls-version=protocol_list

Этот параметр определяет протоколы TLS, разрешенные клиентом для шифрованных соединений. Значение представляет собой список одного или нескольких разделенных запятыми версий протоколов. Например:

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

Протоколы, которые можно указать для этого параметра, зависят от библиотеки SSL, используемой при компиляции MySQL. Разрешённые протоколы следует выбирать таким образом, чтобы в списке не было «дыр». Например, эти значения не содержат дыр:

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

Это значение содержит дыру и не должно использоваться:

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

Для получения подробной информации см. Раздел 6.3.2, «Протоколы и шифры TLS шифрованного соединения».

Этот параметр был добавлен в MySQL 5.7.10.

Чтобы указать, какие протоколы TLS разрешены сервером, задайте системную переменную tls_version.