在 Windows Server 上安装 MySQL
在 Windows Server 上安装 MySQL 9.7 LTS,配置服务和账户,允许经过过滤和加密的远程访问,并使用 mysqldump 设置计划备份。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南使用官方 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
- 安装 Microsoft 的 Visual C++ Redistributable x64。MySQL 9.7 需要 Visual C++ 2019 运行库,而这个较新版本可以取代它。
- 在 MySQL Community Server 下载页面上,选择 9.7 LTS,然后选择 Microsoft Windows,并下载 MSI Installer。
- 运行
.msi文件并选择 Typical 安装。MySQL 将安装到C:\Program Files\MySQL\MySQL Server 9.7。 - 安装结束时,保持勾选启动 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,以便在所有会话中都能使用:
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:创建数据库和账户
打开客户端:
mysql --user=root --password创建一个数据库和一个专供本地应用程序使用的账户:
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:
Get-Service -Name 'MySQL*' | Restart-Service从远程电脑访问
创建一个仅限您的地址的账户并强制加密:
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:
SET PERSIST require_secure_transport = ON;然后在防火墙中仅允许您的地址:
New-NetFirewallRule -DisplayName 'MySQL-3306-In' -Direction Inbound -Protocol TCP -LocalPort 3306 -RemoteAddress '您的IP' -Action Allow此规则不会影响您的 RDP 访问。防火墙配置 指南详细介绍了图形界面方法。如无明确需要,请勿开放 X Protocol 端口 33060。
如果您在 MySQL Configurator 中保留了防火墙选项的勾选,请查找所创建的规则,并在确认其名称后将其删除:
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 文件。然后测试端口和连接:
Test-NetConnection 您的服务器IP -Port 3306
mysql --host=您的服务器IP --user=remote_user --password --ssl-mode=VERIFY_CA --ssl-ca=C:\path\to\ca.pem app_dbVERIFY_CA 会检查服务器出示的证书是否由该颁发机构签名。VERIFY_IDENTITY 模式不适用于自动生成的证书,因为这些证书不包含服务器名称。
连接后,确认加密状态:
SHOW SESSION STATUS LIKE 'Ssl_cipher';非空值表示连接已加密。
步骤 6:自动备份
创建一个专用账户,权限仅限 mysqldump 所需的读取操作:
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 凭据。系统会提示您输入密码,且不会显示密码:
mysql_config_editor set --login-path=backup --host=localhost --user=backup_user --password
mysql_config_editor print --all此文件存储在 %APPDATA%\MySQL 中,属于当前 Windows 用户。其内容只是经过混淆,并未真正加密:请妥善保护该账户。
准备文件夹:
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:
$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.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请定期将文件复制到服务器之外:保存在同一磁盘上的备份无法防范该磁盘故障。
测试还原
请还原到测试数据库,以免覆盖生产数据。路径中请使用正斜杠:
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;"检查完成后,删除副本:
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文件。
故障排除
服务无法启动
从控制台启动服务以查看消息,请替换服务名称:
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
没有与您的地址匹配的账户。请与现有账户进行比较:
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,并检查账户权限:
SHOW GRANTS FOR 'backup_user'@'localhost';脚本正常但计划任务失败
该任务必须以运行 mysql_config_editor 的同一 Windows 账户运行,因为凭据文件是每个用户独有的。如果 Windows 密码已更改,请更新任务:
schtasks /Change /TN 'Backup-MySQL' /RU '您的用户名' /RP '*'root 密码丢失
- 停止 MySQL 服务。
- 创建
C:\mysql-init.txt,其中仅包含以下一行,并填入您的新密码:
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NEW_PASSWORD';- 在管理员命令提示符中,使用此文件启动服务器:
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- 服务器启动后,立即删除
C:\mysql-init.txt,如有必要使用Ctrl+C停止此进程,然后正常重新启动服务。