中文

Windows Server

在 Windows Server 上安装 MySQL

在 Windows Server 上安装 MySQL 9.7 LTS,配置服务和账户,允许经过过滤和加密的远程访问,并使用 mysqldump 设置计划备份。

阅读约 7 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南使用官方 MSI 安装包安装 MySQL Community Server 9.7 LTS,然后配置 Windows 服务、应用程序账户、受限的远程访问和自动备份。

前提条件

  • 64 位 Windows Server 2019、2022 或 2025,并拥有管理员账户。请在 MySQL 支持的平台列表中确认您的版本
  • MySQL 所需的 Visual C++ Redistributable(步骤 1)
  • 如需远程访问,需要获准连接的电脑的公网 IP 地址

请在以管理员身份运行的 Windows PowerShell 中执行命令。

步骤 1:安装 MySQL

  1. 安装 Microsoft 的 Visual C++ Redistributable x64。MySQL 9.7 需要 Visual C++ 2019 运行库,而这个较新版本可以取代它。
  2. 在 MySQL Community Server 下载页面上,选择 9.7 LTS,然后选择 Microsoft Windows,并下载 MSI Installer。
  3. 运行 .msi 文件并选择 Typical 安装。MySQL 将安装到 C:\Program Files\MySQL\MySQL Server 9.7。
  4. 安装结束时,保持勾选启动 MySQL Configurator 的选项。服务器在完成配置之前不会启动。

步骤 2:配置服务器

在 MySQL Configurator 中,依次填写每个界面:

界面 建议设置
Type and Networking 如果机器上还运行其他应用程序,选择 Server;如果机器专用于 MySQL,选择 Dedicated
Connectivity TCP/IP,端口 3306
Open Windows Firewall port 不勾选:您将创建一条仅限您的地址的规则
Accounts and Roles 为 root 设置强密码
Windows Service 启用服务,勾选 Start the MySQL Server at System Startup
Run Windows Service as Standard System Account
Server File Permissions 默认选项,即数据仅限服务和管理员访问
Sample Databases 生产环境中不安装

最后单击 Execute,然后检查服务,并将工具添加到计算机级别的 Path,以便在所有会话中都能使用:

PowerShell
Get-Service -Name 'MySQL*'
$bin = 'C:\Program Files\MySQL\MySQL Server 9.7\bin'
[Environment]::SetEnvironmentVariable('Path', [Environment]::GetEnvironmentVariable('Path', 'Machine') + ";$bin", 'Machine')
$env:Path += ";$bin"
mysql --user=root --password --execute="SELECT VERSION();"

服务名称取决于版本。在后续命令中,请使用 Get-Service 显示的名称。

重要文件位于 C:\ProgramData\MySQL\MySQL Server 9.7:my.ini 用于配置,Data 文件夹存放数据库和错误日志。ProgramData 是隐藏文件夹。

步骤 3:创建数据库和账户

打开客户端:

PowerShell
mysql --user=root --password

创建一个数据库和一个专供本地应用程序使用的账户:

SQL
CREATE DATABASE app_db CHARACTER SET utf8mb4;
CREATE USER 'app_user'@'localhost' IDENTIFIED BY 'CHANGE_THIS_PASSWORD';
GRANT SELECT, INSERT, UPDATE, DELETE ON app_db.* TO 'app_user'@'localhost';

仅当应用程序自行管理其架构时,才添加 CREATE, ALTER, INDEX, DROP。请勿在应用程序中使用 root。

步骤 4:选择访问方式

应用程序位于同一服务器

如果只有本地应用程序使用 MySQL,请将监听限制在本地回环地址。以管理员身份运行记事本,打开 my.ini,并在 [mysqld] 部分添加以下行:

配置
bind_address=127.0.0.1
mysqlx_bind_address=127.0.0.1

重新启动服务,然后转到步骤 6:

PowerShell
Get-Service -Name 'MySQL*' | Restart-Service

从远程电脑访问

创建一个仅限您的地址的账户并强制加密:

SQL
CREATE USER 'remote_user'@'您的IP' IDENTIFIED BY 'CHANGE_THIS_PASSWORD_2' REQUIRE SSL;
GRANT SELECT, INSERT, UPDATE, DELETE ON app_db.* TO 'remote_user'@'您的IP';

您也可以在服务器上拒绝所有未加密的 TCP 连接。请先确认您的本地应用程序支持 TLS:

SQL
SET PERSIST require_secure_transport = ON;

然后在防火墙中仅允许您的地址:

PowerShell
New-NetFirewallRule -DisplayName 'MySQL-3306-In' -Direction Inbound -Protocol TCP -LocalPort 3306 -RemoteAddress '您的IP' -Action Allow

此规则不会影响您的 RDP 访问。防火墙配置 指南详细介绍了图形界面方法。如无明确需要,请勿开放 X Protocol 端口 33060。

如果您在 MySQL Configurator 中保留了防火墙选项的勾选,请查找所创建的规则,并在确认其名称后将其删除:

PowerShell
Get-NetFirewallPortFilter |
  Where-Object { $_.LocalPort -contains '3306' -or $_.LocalPort -contains '33060' } |
  Get-NetFirewallRule |
  Select-Object Name, DisplayName, Enabled, Direction, Action

然后使用 Remove-NetFirewallRule -Name RULE_NAME 删除相应规则,名称取自 Name 列的值。

步骤 5:远程连接

您的电脑需要安装 mysql 客户端,例如可使用同一 MSI 安装包进行安装。MySQL 在首次启动时会在其 Data 文件夹中生成自签名证书。请仅将 ca.pem 复制到您的电脑,切勿复制 *-key.pem 文件。然后测试端口和连接:

PowerShell
Test-NetConnection 您的服务器IP -Port 3306
mysql --host=您的服务器IP --user=remote_user --password --ssl-mode=VERIFY_CA --ssl-ca=C:\path\to\ca.pem app_db

VERIFY_CA 会检查服务器出示的证书是否由该颁发机构签名。VERIFY_IDENTITY 模式不适用于自动生成的证书,因为这些证书不包含服务器名称。

连接后,确认加密状态:

SQL
SHOW SESSION STATUS LIKE 'Ssl_cipher';

非空值表示连接已加密。

步骤 6:自动备份

创建一个专用账户,权限仅限 mysqldump 所需的读取操作:

SQL
CREATE USER 'backup_user'@'localhost' IDENTIFIED BY 'CHANGE_THIS_PASSWORD_3';
GRANT SELECT, SHOW VIEW, TRIGGER, EVENT ON *.* TO 'backup_user'@'localhost';

--routines 选项需要全局 SELECT 权限。

使用将运行该任务的账户登录 Windows,然后保存备份账户的 MySQL 凭据。系统会提示您输入密码,且不会显示密码:

PowerShell
mysql_config_editor set --login-path=backup --host=localhost --user=backup_user --password
mysql_config_editor print --all

此文件存储在 %APPDATA%\MySQL 中,属于当前 Windows 用户。其内容只是经过混淆,并未真正加密:请妥善保护该账户。

准备文件夹:

PowerShell
New-Item -ItemType Directory -Force -Path 'C:\Backups\MySQL', 'C:\Scripts' | Out-Null
icacls 'C:\Scripts' /inheritance:r /grant:r '*S-1-5-32-544:(OI)(CI)F' '*S-1-5-18:(OI)(CI)F'
icacls 'C:\Backups\MySQL' /inheritance:r /grant:r '*S-1-5-32-544:(OI)(CI)F' '*S-1-5-18:(OI)(CI)F'

创建 C:\Scripts\backup-mysql.ps1:

PowerShell
$bin = 'C:\Program Files\MySQL\MySQL Server 9.7\bin'
$backupDir = 'C:\Backups\MySQL'
$databases = @('app_db')
$retentionDays = 14
$stamp = Get-Date -Format 'yyyyMMdd-HHmm'

foreach ($db in $databases) {
    $file = Join-Path $backupDir "$db-$stamp.sql"
    & "$bin\mysqldump.exe" --login-path=backup --single-transaction --routines --events --no-tablespaces "--result-file=$file" $db
    if ($LASTEXITCODE -ne 0) {
        Remove-Item -Path $file -ErrorAction SilentlyContinue
        exit 1
    }
}

Get-ChildItem -Path $backupDir -Filter '*.sql' |
    Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-$retentionDays) } |
    Remove-Item

--single-transaction 可为 InnoDB 表生成一致的副本而不锁定它们。MyISAM 或 MEMORY 表在导出期间可能发生变化。

测试脚本,然后设置计划任务。请指定运行 mysql_config_editor 时使用的 Windows 账户,该账户必须是 Administrators(管理员)组的成员才能读取脚本:Windows 会要求您输入其密码。

PowerShell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File 'C:\Scripts\backup-mysql.ps1'
schtasks /Create /TN 'Backup-MySQL' /TR "powershell.exe -NoProfile -ExecutionPolicy Bypass -File C:\Scripts\backup-mysql.ps1" /SC DAILY /ST 02:45 /RU '您的用户名' /RP '*' /RL HIGHEST

请定期将文件复制到服务器之外:保存在同一磁盘上的备份无法防范该磁盘故障。

测试还原

请还原到测试数据库,以免覆盖生产数据。路径中请使用正斜杠:

PowerShell
mysql --user=root --password --execute="CREATE DATABASE app_db_test CHARACTER SET utf8mb4;"
mysql --user=root --password app_db_test --execute="source C:/Backups/MySQL/app_db-20260101-0245.sql"
mysql --user=root --password --execute="SHOW TABLES FROM app_db_test;"

检查完成后,删除副本:

SQL
DROP DATABASE app_db_test;

验证结果

  • Get-Service -Name 'MySQL*' | Select-Object Name, Status, StartType 显示 Running 和 Automatic。
  • 应用程序账户可以连接,并且 SHOW DATABASES; 只显示其数据库和 information_schema。
  • 远程访问时,Ssl_cipher 不为空,且其他地址无法访问 3306 端口。
  • 仅本地访问时,Get-NetTCPConnection -LocalPort 3306 -State Listen 显示 127.0.0.1。
  • Get-ScheduledTaskInfo -TaskName 'Backup-MySQL' 在运行后显示 LastTaskResult 为 0,并且存在最近的 .sql 文件。

故障排除

服务无法启动

从控制台启动服务以查看消息,请替换服务名称:

PowerShell
Get-Service -Name 'MySQL*'
net start SERVICE_NAME

然后查看 C:\ProgramData\MySQL\MySQL Server 9.7\Data 文件夹中的 .err 文件。系统错误 1067 伴随 Can't open and lock privilege tables 出现时,通常表示 my.ini 中的 basedir 或 datadir 路径有误。添加在 [mysqld] 部分之外的行也可能导致无法启动。

ERROR 2003 (HY000): Can't connect to MySQL server(10061 或 10060)

  • 10061:连接被拒绝。请确认服务正在运行、端口正确,并且 bind_address 未限制为 127.0.0.1。
  • 10060:连接超时,这通常与防火墙有关。请检查 MySQL-3306-In 规则和您当前的公网地址。

ERROR 1130 (HY000): Host is not allowed to connect

没有与您的地址匹配的账户。请与现有账户进行比较:

SQL
SELECT user, host FROM mysql.user ORDER BY user, host;

如果您的公网地址已更改,请为新地址创建账户,授予其权限,并删除旧账户。

ERROR 1045 (28000): Access denied for user

密码不正确,或者实际使用的 用户@主机 账户并非您所以为的那个。localhost 和您的公网地址在 MySQL 中是两个不同的账户。

ERROR 3159:Connections using insecure transport are prohibited

require_secure_transport 已启用,而客户端正在尝试未加密的连接。请在客户端使用 --ssl-mode=REQUIRED 启用 TLS,或者更好的是使用 VERIFY_CA。

ERROR 2061:Authentication requires secure connection

该账户使用默认插件 caching_sha2_password,而连接未加密。请在客户端启用 TLS。如果您的应用程序过旧,不支持此插件,请更新其连接器。

Access denied; you need the PROCESS privilege 或例程相关错误

请在脚本中保留 --no-tablespaces,并检查账户权限:

SQL
SHOW GRANTS FOR 'backup_user'@'localhost';

脚本正常但计划任务失败

该任务必须以运行 mysql_config_editor 的同一 Windows 账户运行,因为凭据文件是每个用户独有的。如果 Windows 密码已更改,请更新任务:

PowerShell
schtasks /Change /TN 'Backup-MySQL' /RU '您的用户名' /RP '*'

root 密码丢失

  1. 停止 MySQL 服务。
  2. 创建 C:\mysql-init.txt,其中仅包含以下一行,并填入您的新密码:
SQL
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NEW_PASSWORD';
  1. 在管理员命令提示符中,使用此文件启动服务器:
batch
cd "C:\Program Files\MySQL\MySQL Server 9.7\bin"
mysqld --defaults-file="C:\\ProgramData\\MySQL\\MySQL Server 9.7\\my.ini" --init-file=C:\\mysql-init.txt --console
  1. 服务器启动后,立即删除 C:\mysql-init.txt,如有必要使用 Ctrl+C 停止此进程,然后正常重新启动服务。