MySQL 完全指南 / 第 2 章：安装与部署

第 2 章：安装与部署

工欲善其事，必先利其器。本章覆盖所有主流平台的 MySQL 安装方式，以及 Docker 快速部署。

2.1 安装方式总览

方式	适用场景	优点	缺点
包管理器安装	开发/测试环境	简单快速	版本可能较旧
官方 APT/YUM 仓库	生产 Linux 环境	可控版本，自动依赖	配置稍复杂
二进制包	生产环境（精细控制）	不依赖系统包管理	手动操作多
Docker	开发/测试/容器化生产	隔离、可重复、快速	数据持久化需规划
源码编译	特殊定制需求	完全可控	耗时、复杂
Homebrew	macOS 开发环境	简单	不适合生产

2.2 Linux 安装

2.2.1 Ubuntu / Debian（APT）

# === 第 1 步：添加 MySQL 官方 APT 仓库 ===
# 下载仓库配置包（以 MySQL 8.4 为例）
wget https://dev.mysql.com/get/mysql-apt-config_0.8.32-1_all.deb
sudo dpkg -i mysql-apt-config_0.8.32-1_all.deb
# 弹出界面选择 MySQL 8.4 LTS

# 更新包索引
sudo apt update

# === 第 2 步：安装 MySQL Server ===
sudo apt install -y mysql-server
# 安装过程中会提示设置 root 密码

# === 第 3 步：启动并设置开机自启 ===
sudo systemctl start mysql
sudo systemctl enable mysql

# === 第 4 步：安全初始化 ===
sudo mysql_secure_installation

2.2.2 CentOS / RHEL（YUM / DNF）

# === 第 1 步：添加 MySQL 官方 YUM 仓库 ===
sudo rpm -Uvh https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm

# === 第 2 步：安装 MySQL Server ===
# CentOS 8+ / RHEL 8+ 使用 dnf
sudo dnf install -y mysql-community-server

# === 第 3 步：启动并设置开机自启 ===
sudo systemctl start mysqld
sudo systemctl enable mysqld

# === 第 4 步：获取临时密码并修改 ===
sudo grep 'temporary password' /var/log/mysqld.log
# 输出类似：A temporary password is generated for root@localhost: xK3#mR9p!

# 使用临时密码登录并修改
mysql -uroot -p'xK3#mR9p!'

-- 登录后立即修改密码
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewP@ssw0rd!2026';
FLUSH PRIVILEGES;

2.2.3 二进制包安装（通用 Linux）

# === 第 1 步：下载二进制包 ===
cd /tmp
wget https://dev.mysql.com/get/Downloads/MySQL-8.4/mysql-8.4.4-linux-glibc2.28-x86_64.tar.xz

# === 第 2 步：解压到 /usr/local ===
sudo tar -xf mysql-8.4.4-linux-glibc2.28-x86_64.tar.xz -C /usr/local/
sudo ln -s /usr/local/mysql-8.4.4-linux-glibc2.28-x86_64 /usr/local/mysql

# === 第 3 步：创建用户和目录 ===
sudo groupadd mysql
sudo useradd -r -g mysql -s /bin/false mysql
sudo mkdir -p /var/lib/mysql /var/run/mysqld /var/log/mysql
sudo chown -R mysql:mysql /var/lib/mysql /var/run/mysqld /var/log/mysql

# === 第 4 步：初始化数据库 ===
cd /usr/local/mysql
sudo bin/mysqld --initialize --user=mysql
# 记录输出的临时密码

# === 第 5 步：配置 my.cnf ===
sudo tee /etc/my.cnf << 'EOF'
[mysqld]
basedir = /usr/local/mysql
datadir = /var/lib/mysql
socket  = /var/run/mysqld/mysqld.sock
port    = 3306
pid-file = /var/run/mysqld/mysqld.pid
log-error = /var/log/mysql/error.log

# 基础调优
innodb_buffer_pool_size = 1G
max_connections = 200
character-set-server = utf8mb4
collation-server = utf8mb4_0900_ai_ci

[client]
socket = /var/run/mysqld/mysqld.sock
EOF

# === 第 6 步：启动 MySQL ===
sudo bin/mysqld_safe --user=mysql &
# 或使用 systemd（创建 service 文件）

2.3 macOS 安装（Homebrew）

# 安装 MySQL 8.4
brew install [email protected]

# 启动 MySQL 服务
brew services start [email protected]

# 验证版本
mysql --version

# 安全初始化
mysql_secure_installation

💡 提示：如果之前安装过其他版本，先卸载再安装：

brew uninstall mysql
brew cleanup
brew install [email protected]

2.4 Windows 安装

方式 1：官方安装包（MSI）

下载：https://dev.mysql.com/downloads/installer/
选择 mysql-installer-community-8.4.x.msi
安装类型选择 Server only 或 Custom
配置 root 密码
端口默认 3306
服务名默认 MySQL84

方式 2：ZIP 免安装包

# 解压到 C:\mysql-8.4
# 创建 my.ini 配置文件

[mysqld]
basedir = C:/mysql-8.4
datadir = C:/mysql-8.4/data
port = 3306

# 初始化数据库
cd C:\mysql-8.4\bin
mysqld --initialize --console
# 记录临时密码

# 安装为 Windows 服务
mysqld --install MySQL84

# 启动服务
net start MySQL84

2.5 Docker 快速部署

2.5.1 基础 Docker 启动

# 最简单的启动方式
docker run -d \
  --name mysql8 \
  -e MYSQL_ROOT_PASSWORD=MyStr0ng!Pass \
  -p 3306:3306 \
  mysql:8.4

# 查看日志
docker logs -f mysql8

# 进入容器执行 SQL
docker exec -it mysql8 mysql -uroot -p'MyStr0ng!Pass'

2.5.2 带数据持久化的完整启动

docker run -d \
  --name mysql8 \
  -e MYSQL_ROOT_PASSWORD=MyStr0ng!Pass \
  -e MYSQL_DATABASE=myapp \
  -e MYSQL_USER=appuser \
  -e MYSQL_PASSWORD=AppUser!Pass \
  -p 3306:3306 \
  -v /data/mysql/data:/var/lib/mysql \
  -v /data/mysql/conf:/etc/mysql/conf.d \
  -v /data/mysql/log:/var/log/mysql \
  --restart=unless-stopped \
  --character-set-server=utf8mb4 \
  --collation-server=utf8mb4_0900_ai_ci \
  mysql:8.4

2.5.3 Docker Compose 部署

创建 docker-compose.yml：

version: '3.8'

services:
  mysql:
    image: mysql:8.4
    container_name: mysql8
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-MyStr0ng!Pass}
      MYSQL_DATABASE: myapp
      MYSQL_USER: appuser
      MYSQL_PASSWORD: ${MYSQL_PASSWORD:-AppUser!Pass}
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql
      - ./conf/my.cnf:/etc/mysql/conf.d/my.cnf:ro
      - ./init:/docker-entrypoint-initdb.d:ro  # 初始化脚本目录
      - mysql_log:/var/log/mysql
    command: >
      --default-authentication-plugin=mysql_native_password
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_0900_ai_ci
      --innodb-buffer-pool-size=512M
      --max-connections=200
      --slow-query-log=ON
      --long-query-time=1
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD:-MyStr0ng!Pass}"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  mysql_data:
  mysql_log:

启动：

# 创建配置目录
mkdir -p conf init

# 启动
docker compose up -d

# 查看状态
docker compose ps

# 查看日志
docker compose logs -f mysql

2.5.4 用自定义配置文件

创建 conf/my.cnf：

[mysqld]
# 基础设置
default-time-zone = '+08:00'
character-set-server = utf8mb4
collation-server = utf8mb4_0900_ai_ci

# InnoDB 调优
innodb_buffer_pool_size = 512M
innodb_log_file_size = 256M
innodb_flush_log_at_trx_commit = 1

# 连接设置
max_connections = 200
wait_timeout = 600
interactive_timeout = 600

# 日志
slow_query_log = ON
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 1
log-bin = mysql-bin
binlog-format = ROW
server-id = 1

2.5.5 Docker 初始化脚本

将 .sql 或 .sh 文件放入 init/ 目录，首次启动自动执行：

init/01-create-tables.sql:

USE myapp;

CREATE TABLE IF NOT EXISTS users (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE,
    password_hash VARCHAR(255) NOT NULL,
    status TINYINT DEFAULT 1 COMMENT '1=active, 0=disabled',
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX idx_email (email),
    INDEX idx_status (status)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2.6 初始化安全配置

安装完成后，无论哪种方式，都应执行安全初始化：

mysql_secure_installation

该命令会引导你完成以下操作：

步骤	操作	建议
1	设置 root 密码	使用强密码（12位+，含大小写、数字、特殊字符）
2	删除匿名用户	✅ 是
3	禁止 root 远程登录	✅ 是
4	删除 test 数据库	✅ 是
5	刷新权限表	✅ 是

2.7 核心配置参数（my.cnf）

安装后最重要的配置文件：

参数	默认值	生产建议	说明
`innodb_buffer_pool_size`	128M	物理内存的 60-70%	InnoDB 最关键的参数
`max_connections`	151	200-500	根据并发量调整
`character-set-server`	utf8mb4	utf8mb4	支持 emoji 和所有 Unicode
`collation-server`	utf8mb4_0900_ai_ci	utf8mb4_0900_ai_ci	8.0 默认排序规则
`innodb_flush_log_at_trx_commit`	1	1（安全优先）	0/2 可提升性能但有丢失风险
`sync_binlog`	1	1（安全优先）	0 可提升性能但有丢失风险
`slow_query_log`	OFF	ON	记录慢查询
`long_query_time`	10	1	慢查询阈值（秒）
`innodb_file_per_table`	ON	ON	每个表独立表空间
`default-time-zone`	SYSTEM	+08:00	时区设置

⚠️ 关键参数配置示例（4核8G 服务器）：

[mysqld]
# 内存：Buffer Pool 占 60%
innodb_buffer_pool_size = 5G
innodb_buffer_pool_instances = 4

# 连接
max_connections = 300
wait_timeout = 600

# 日志
slow_query_log = ON
long_query_time = 1
log-bin = mysql-bin
binlog-format = ROW

# 字符集
character-set-server = utf8mb4
collation-server = utf8mb4_0900_ai_ci

# 安全
default-authentication-plugin = caching_sha2_password
local_infile = OFF

2.8 安装后验证

# 检查 MySQL 服务状态
sudo systemctl status mysql

# 检查版本
mysql --version

# 登录并验证
mysql -uroot -p -e "SELECT VERSION(); SHOW VARIABLES LIKE 'innodb_buffer_pool_size';"

-- 验证基本功能
SELECT VERSION();                              -- 查看版本
SHOW VARIABLES LIKE '%character_set%';         -- 查看字符集
SHOW VARIABLES LIKE 'innodb_buffer_pool_size'; -- 查看 Buffer Pool
SHOW DATABASES;                                -- 查看数据库列表
SELECT * FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Threads_connected';

业务场景

场景 1：开发团队快速搭建环境

10 人开发团队需要统一的 MySQL 开发环境。

方案：使用 Docker Compose 部署，将 docker-compose.yml 和 conf/my.cnf 纳入 Git 仓库，每人一条命令启动：

git clone <repo>
cd <repo>
docker compose up -d

场景 2：生产环境服务器选型

某 SaaS 系统日活 10 万，数据量约 50GB。

方案：

服务器：4 核 16G 或 8 核 32G
存储：SSD，至少 200GB
安装方式：官方 YUM/APT 仓库
Buffer Pool：10-20G
主从架构（一主两从）