Docker 部署 Microsoft SQL Server 完全指南
部署方案對比
| 特性 | Docker 命令行方式 | Docker Compose 方式 |
|---|---|---|
| 適用場景 | 快速測試、簡單部署、臨時使用 | 正式部署、復雜應用、多環(huán)境配置、需要版本控制 |
| 配置管理 | 單行命令,難以復用 | 聲明式 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. 創(chuàng)建本地數(shù)據(jù)目錄(用于持久化)
為了避免容器刪除后數(shù)據(jù)丟失,需要在宿主機上創(chuàng)建一個目錄來映射容器內(nèi)的數(shù)據(jù)存儲位置
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 參數(shù)說明表
| 參數(shù) | 說明 | 必要性 |
|---|---|---|
-d | 后臺運行容器(守護模式) | 可選 |
--name sql-server | 指定容器名稱 | 可選 |
-e "ACCEPT_EULA=Y" | 接受最終用戶許可協(xié)議 | 必須 |
-e "MSSQL_SA_PASSWORD=..." | 設置sa用戶密碼(需符合復雜度要求) | 必須 |
-e "MSSQL_PID=Developer" | 指定版本(Developer/Express/Standard/Enterprise) | 可選 |
-p 1433:1433 | 端口映射(主機端口:容器端口) | 必須 |
-v /host/path:/var/opt/mssql | 數(shù)據(jù)持久化掛載(主機路徑:容器路徑) | 推薦 |
--memory="4g" | 限制容器最大內(nèi)存使用 | 推薦 |
--restart unless-stopped | 設置自動重啟策略(除非手動停止) | 推薦 |
3.2 密碼復雜度要求
- 長度至少8個字符
- 包含以下字符類型中的至少三種:
- 大寫字母(A-Z)
- 小寫字母(a-z)
- 數(shù)字(0-9)
- 特殊符號(如!@#$%^&*)
4. 檢查容器狀態(tài)
運行后,使用以下命令查看容器是否成功啟動:
docker ps

- 如果狀態(tài)(STATUS)顯示為
Up ...,則表示運行成功。如果顯示為Exited,說明啟動失敗,需要查看日志
5. 查看日志以排查問題
錯誤示例

docker logs sql-server
- 常見啟動失敗原因:
- 密碼不符合復雜性要求
- 沒有設置
ACCEPT_EULA=Y - 宿主機端口已被占用(更改
-p參數(shù)即可) - 配置的掛載目錄沒有訪問權(quán)限
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 * 進入容器內(nèi)部bash: docker exec -it sql-server bash * 刪除容器 (?? **會丟失未持久化的數(shù)據(jù)**): docker rm -f sql-server
二、Docker Compose 方式
這種方式使用一個 docker-compose.yml 文件來聲明所有配置,更清晰、易于版本控制和復用,特別適合復雜應用和多環(huán)境部署
1. 創(chuàng)建項目目錄和文件
cd /usr/local sudo mkdir -p /docker/sql-server && cd /docker/sql-server mkdir data && sudo chmod -R 777 data
2. 創(chuàng)建 docker-compose.yml 文件
需要提前創(chuàng)建docker網(wǎng)絡:docker network create fc
使用文本編輯器創(chuàng)建該文件,并填入以下內(nèi)容:
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 | 環(huán)境變量配置 | ACCEPT_EULA=Y, MSSQL_SA_PASSWORD=... |
ports | 端口映射配置 | "1433:1433" |
volumes | 數(shù)據(jù)卷映射 | mssql_data:/var/opt/mssql |
mem_limit | 內(nèi)存限制 | 4g |
networks | 網(wǎng)絡配置 | 自定義橋接網(wǎng)絡 |
(可選)創(chuàng)建 .env 文件管理敏感信息
為了避免將密碼硬編碼在 YAML 文件中,可以創(chuàng)建一個 .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 文件的目錄下,執(zhí)行:
docker compose up -d

-d同樣表示在后臺運行- 這個命令會自動拉取鏡像(如果本地沒有)、創(chuàng)建定義的卷、網(wǎng)絡,并啟動所有服務
總結(jié)
| 特性 | Docker 命令行方式 | Docker Compose 方式 |
|---|---|---|
| 適用場景 | 快速測試、單次運行、簡單任務 | 正式部署、復雜應用、多環(huán)境、需要版本控制 |
| 配置管理 | 長長的命令,難以記錄和復用 | 清晰的 YAML 文件,易于閱讀、版本管理和共享 |
| 持久化 | 需手動指定主機絕對路徑 | 可使用相對路徑(如 ./data),管理更方便 |
| 安全性 | 密碼在命令歷史中可見 | 可通過 .env 文件隔離敏感信息,更安全 |
| 管理命令 | docker start/stop/rm <name> | docker-compose up/down/start/stop (基于項目) |
| 資源限制 | 在 run 命令中直接指定 | 在 YAML 文件中聲明 |
| 擴展性 | 差,運行多個相關容器很麻煩 | 極佳,可以輕松定義多服務應用(如 App + DB) |
PS:如果遇到數(shù)據(jù)卷掛載權(quán)限問題,可以選擇使用user:root 或者直接創(chuàng)建數(shù)據(jù)卷由docker自動管理
到此這篇關于Docker 部署 Microsoft SQL Server 指南的文章就介紹到這了,更多相關Docker 部署 Microsoft SQL Server內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
Docker build創(chuàng)建鏡像命令示例實踐
本文講解Dockerfile的核心概念、基礎指令、構(gòu)建流程及優(yōu)化技巧,涵蓋鏡像層結(jié)構(gòu)、構(gòu)建上下文、常用命令參數(shù),強調(diào)多階段構(gòu)建、輕量鏡像等最佳實踐,感興趣的朋友跟隨小編一起看看吧2025-08-08
docker部署Vaultwarden密碼共享管理系統(tǒng)的實現(xiàn)(圖文)
Vaultwarden是一個開源的密碼管理器,它提供了類似于Bitwarden的功能,允許用戶安全地存儲和管理密碼、敏感數(shù)據(jù)和身份信息,本文主要介紹了docker部署Vaultwarden密碼共享管理系統(tǒng)的實現(xiàn),感興趣的可以了解一下2023-10-10
Windows下使用Docker部署Qdrant向量庫鏡像服務詳細教學
在?Windows?系統(tǒng)上直接安裝?Qdrant?服務環(huán)境時,可能會因為依賴或權(quán)限等問題導致安裝失敗,這時可以借助?Docker?容器來部署?Qdrant?服務,下面就跟隨小編一起來看看具體操作步驟吧2025-06-06
Docker下MySQL配置文件不生效的解決方法(超全面!)
在Docker中運行MySQL并遇到需要調(diào)整配置的情況時,比如想要關閉ONLY_FULL_GROUP_BY的嚴格模式,我們可以通過以下步驟來實現(xiàn)sql_mode的修改:以下是解決此類問題的步驟和思路,需要的朋友可以參考下2024-09-09

