Docker 部署 Microsoft SQL Server 完全指南

 更新时间:2025年08月23日 15:09:46   作者:FC_nian  
本文详细介绍如何使用Docker快速部署Microsoft SQL Server,提供两种主流方式,两种方式都包含了数据持久化、资源限制等生产环境所需的配置,并提供了详细的参数说明和常见问题解决方法,感兴趣的朋友跟随小编一起看看吧

部署方案对比

特性Docker 命令行方式Docker Compose 方式
适用场景快速测试、简单部署、临时使用正式部署、复杂应用、多环境配置、需要版本控制
配置管理单行命令,难以复用声明式 YAML 文件,易于管理和版本控制
持久化需手动指定主机绝对路径支持命名卷和相对路径,管理更方便
安全性密码在命令历史中可见可通过 .env 文件隔离敏感信息
管理复杂度简单需要编写 YAML 文件
扩展性较差极佳,可轻松定义多服务应用

一、Docker 命令行方式

这种方式直接使用 docker run 命令,适合快速测试和简单部署

1. 拉取官方镜像

从 Microsoft Container Registry 拉取 SQL Server 2022 的最新 Linux 镜像

docker pull mcr.microsoft.com/mssql/server:2022-latest

  • 注意:如需其他版本(如 2019),将标签改为 :2019-latest

2. 创建本地数据目录(用于持久化)

为了避免容器删除后数据丢失,需要在宿主机上创建一个目录来映射容器内的数据存储位置

mkdir -p /usr/local/docker/sqlserver/data

3. 运行容器命令(最关键的步骤)

docker run -d \
    --name sql-server \
    -e "ACCEPT_EULA=Y" \
    -e "MSSQL_SA_PASSWORD=sqlserver@7740" \
    -e "MSSQL_PID=Developer" \
    -p 1433:1433 \
    -v /usr/local/docker/sqlserver/data:/var/opt/mssql \
    --memory="4g" \
    --restart unless-stopped \
    --user root \
    mcr.microsoft.com/mssql/server:2019-latest

3.1 参数说明表

参数说明必要性
-d后台运行容器(守护模式)可选
--name sql-server指定容器名称可选
-e "ACCEPT_EULA=Y"接受最终用户许可协议必须
-e "MSSQL_SA_PASSWORD=..."设置sa用户密码(需符合复杂度要求)必须
-e "MSSQL_PID=Developer"指定版本(Developer/Express/Standard/Enterprise)可选
-p 1433:1433端口映射(主机端口:容器端口)必须
-v /host/path:/var/opt/mssql数据持久化挂载(主机路径:容器路径)推荐
--memory="4g"限制容器最大内存使用推荐
--restart unless-stopped设置自动重启策略(除非手动停止)推荐

3.2 密码复杂度要求

  • 长度至少8个字符
  • 包含以下字符类型中的至少三种:
    • 大写字母(A-Z)
    • 小写字母(a-z)
    • 数字(0-9)
    • 特殊符号(如!@#$%^&*)

4. 检查容器状态

运行后,使用以下命令查看容器是否成功启动:

docker ps

  • 如果状态(STATUS)显示为 Up ...,则表示运行成功。如果显示为 Exited,说明启动失败,需要查看日志

5. 查看日志以排查问题

错误示例

docker logs sql-server
  • 常见启动失败原因:
    1. 密码不符合复杂性要求
    2. 没有设置 ACCEPT_EULA=Y
    3. 宿主机端口已被占用(更改 -p 参数即可)
    4. 配置的挂载目录没有访问权限
      sudo chmod -R 777 /usr/local/docker/sqlserver/data

6. 连接测试

容器运行后,你可以使用任何客户端工具连接

  • 服务器: ip
  • 身份验证: SQL Server 身份验证
  • 登录名: sa
  • 密码: 你在 MSSQL_SA_PASSWORD 中设置的密码
  • 端口: 如果你映射的是 1433,直接使用即可

常用管理命令:

*  停止容器: docker stop sql-server
*  启动容器: docker start sql-server
*  重启容器: docker restart sql-server
*  进入容器内部bash: docker exec -it sql-server bash
*  删除容器 (⚠️ **会丢失未持久化的数据**): docker rm -f sql-server

二、Docker Compose 方式

这种方式使用一个 docker-compose.yml 文件来声明所有配置,更清晰、易于版本控制和复用,特别适合复杂应用和多环境部署

1. 创建项目目录和文件

cd /usr/local
sudo mkdir -p /docker/sql-server && cd /docker/sql-server
mkdir data && sudo chmod -R 777 data

2. 创建 docker-compose.yml 文件

需要提前创建docker网络:docker network create fc
使用文本编辑器创建该文件,并填入以下内容:

services:
  mssql:
    image: mcr.microsoft.com/mssql/server:2019-latest
    container_name: sqlserver
    environment:
      - ACCEPT_EULA=Y
      - MSSQL_PID=Developer
      - MSSQL_SA_PASSWORD=sqlserver@7740
    ports:
      - "1433:1433"
    volumes:
      - mssql_data:/var/opt/mssql  # 使用命名卷
    restart: unless-stopped
    mem_limit: 4g
    mem_reservation: 2g
    cpus: 2.0
    networks:
      - fc
volumes:
  mssql_data:  # 定义命名卷
networks:
  fc:
    external: true

配置项说明表

配置项说明示例值
image使用的Docker镜像mcr.microsoft.com/mssql/server:2022-latest
environment环境变量配置ACCEPT_EULA=Y, MSSQL_SA_PASSWORD=...
ports端口映射配置"1433:1433"
volumes数据卷映射mssql_data:/var/opt/mssql
mem_limit内存限制4g
networks网络配置自定义桥接网络

(可选)创建 .env 文件管理敏感信息
为了避免将密码硬编码在 YAML 文件中,可以创建一个 .env 文件(与 docker-compose.yml 同目录):

# .env file
MSSQL_SA_PASSWORD=sqlserver@7740

然后修改 docker-compose.yml 中的 MSSQL_SA_PASSWORD 一行:

- MSSQL_SA_PASSWORD=${MSSQL_SA_PASSWORD}

或者

env_file:
  - .env  # 将密码移出docker-compose文件

Docker Compose 会自动读取同目录下的 .env 文件并注入变量

3. 启动容器

启动容器前,注意开放防火墙端口:

# 如果使用 firewalld
sudo firewall-cmd --add-port=1433/tcp --permanent
sudo firewall-cmd --reload

然后在包含 docker-compose.yml 文件的目录下,执行:

docker compose up -d

  • -d 同样表示在后台运行
  • 这个命令会自动拉取镜像(如果本地没有)、创建定义的卷、网络,并启动所有服务

总结

特性Docker 命令行方式Docker Compose 方式
适用场景快速测试、单次运行、简单任务正式部署、复杂应用、多环境、需要版本控制
配置管理长长的命令,难以记录和复用清晰的 YAML 文件,易于阅读、版本管理和共享
持久化需手动指定主机绝对路径可使用相对路径(如 ./data),管理更方便
安全性密码在命令历史中可见可通过 .env 文件隔离敏感信息,更安全
管理命令docker start/stop/rm <name>docker-compose up/down/start/stop (基于项目)
资源限制run 命令中直接指定在 YAML 文件中声明
扩展性差,运行多个相关容器很麻烦极佳,可以轻松定义多服务应用(如 App + DB)

PS:如果遇到数据卷挂载权限问题,可以选择使用user:root 或者直接创建数据卷由docker自动管理

到此这篇关于Docker 部署 Microsoft SQL Server 指南的文章就介绍到这了,更多相关Docker 部署 Microsoft SQL Server内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Docker中容器的备份方法和步骤操作

    Docker中容器的备份方法和步骤操作

    Docker容器备份分为完整(含文件系统和元数据,用commit+save)与轻量(仅文件系统,用export)两种,恢复需导入镜像或直接运行,备份前应停止容器,数据卷需单独处理,定期清理并加密存储以确保数据安全
    2025-09-09
  • Docker Compose网络配置指南分享

    Docker Compose网络配置指南分享

    本文详细介绍了Docker网络配置的各个方面,包括基础网络架构、自定义网络配置、典型场景配置、高级网络技巧、调试与诊断以及最佳实践,通过多个实战案例和常见问题解决方案,帮助读者更好地理解和应用Docker网络技术
    2025-11-11
  • Docker简单入门使用教程

    Docker简单入门使用教程

    这篇文章主要介绍了Docker简单入门教程,帮助大家开始学习docker容器,感兴趣的朋友可以了解下
    2020-08-08
  • Linux Docker运行springboot项目的步骤详解

    Linux Docker运行springboot项目的步骤详解

    这篇文章主要介绍了Linux Docker运行springboot项目的步骤详解,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-01-01
  • docker终端中如何修改时区

    docker终端中如何修改时区

    解决Docker时区问题需检查容器是否包含Shanghai时区文件,若无则从主机复制,通过命令验证时区设置,确保正确,总结为个人经验,供他人参考
    2025-07-07
  • 创建的docker容器时间显示错误/date错误/时区错误

    创建的docker容器时间显示错误/date错误/时区错误

    这篇文章主要介绍了创建的docker容器时间显示错误/date错误/时区错误的处理方法,一起看看吧
    2017-06-06
  • Docker配置代理的详细步骤记录

    Docker配置代理的详细步骤记录

    docker是一个流行的容器化平台,它让应用程序可以在操作系统层面上隔离运行,从而提供了更高的可移植性和可靠性,这篇文章主要给大家介绍了关于Docker配置代理的详细步骤,需要的朋友可以参考下
    2024-08-08
  • docker如何安装带postgis插件的postgresql数据库

    docker如何安装带postgis插件的postgresql数据库

    这篇文章主要介绍了docker如何安装带postgis插件的postgresql数据库问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-12-12
  • Ubuntu18.04安装docker全过程

    Ubuntu18.04安装docker全过程

    这篇文章主要介绍了Ubuntu18.04安装docker全过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-06-06
  • Docker中部署Redis集群与部署微服务项目的详细过程

    Docker中部署Redis集群与部署微服务项目的详细过程

    这篇文章主要介绍了Docker中部署Redis集群与部署微服务项目,主要包括使用docker部署的好处以及Docker与Kubernetes对比分析,需要的朋友可以参考下
    2022-06-06

最新评论