# SSMS22离线安装指南

**Repository Path**: ciguoguo/ssms22_install_tutorial

## Basic Information

- **Project Name**: SSMS22离线安装指南
- **Description**: SSMS22离线安装指南，官方文档给的方式安装时缺少cert，导致安装失败。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SSMS 22 离线安装部署指南

本文档详细记录 SQL Server Management Studio (SSMS) 22 在**纯离线环境**下的安装流程，重点解决因缺失 `Microsoft Windows Code Signing PCA 2024` 证书导致的安装闪退问题。

## 官方文档参考
- **SSMS 22 安装概述**：https://learn.microsoft.com/zh-cn/ssms/install/install
- **离线安装官方指南**：https://learn.microsoft.com/zh-cn/ssms/install/create-offline

## 一、在有网络的环境下制作离线包

SSMS 22 采用 Visual Studio Installer 机制，需先在有网机器上拉取完整组件。

### 1. 下载引导程序
在有网电脑上下载 SSMS 22 引导程序 `vs_SSMS.exe`（约 2 MB）。
- **下载地址**：https://aka.ms/ssms/22/release/vs_SSMS.exe

### 2. 生成离线布局 (Layout)
1. 以**管理员身份**打开命令提示符 (CMD)。
2. 执行以下命令，将离线包下载到 `C:\SSMS22_Offline` 目录（约 3.5 GB）：

```cmd
vs_SSMS.exe --layout C:\SSMS22_Offline --all
```

3. 等待命令行显示“完成”并提示“按任意键退出”。此时 `C:\SSMS22_Offline` 即为完整的离线安装包。
4. 将该文件夹完整拷贝至内网服务器（如 `I:\SSMS22_Offline`）。

## 二、离线服务器环境安装

### 1. 前置依赖检查
- **VC++ Redistributable**：确保服务器已安装 Microsoft Visual C++ 2015-2022 Redistributable（x86 和 x64）。若缺失，需先离线安装。
- **管理员权限**：所有操作需在**管理员权限**的 CMD 或 PowerShell 中进行。

### 2. 安装命令（断网环境）
在离线服务器上，进入离线包目录，执行以下命令强制使用本地文件安装：

```cmd
I:\SSMS22_Offline\vs_SSMS.exe --noweb --passive --wait
```

**参数说明**：
- `--noweb`：**关键参数**，强制仅使用本地布局文件，禁止尝试联网。
- `--passive`：显示进度条，避免“一闪而过”的无响应状态。
- `--wait`：等待安装完成。

## 三、核心故障排查：证书缺失 (0x80131509)

在严格离线的 Windows Server 上，安装极大概率会**闪退**或**无提示失败**，原因是系统缺少验证文件签名所需的中间证书。

### 1. 错误现象与日志确认
- **现象**：运行安装命令后窗口立即关闭，无任何界面提示。
- **日志定位**：查看 `"%ProgramFiles%\Microsoft SQL Server\170\Setup Bootstrap\Log\20260525_205834\Detail.txt"` 文件。
- **错误代码**：若发现以下日志，即为证书问题：
    ```
    Error 0x80131509: Signature verification failed. Error: Unable to verify the integrity of the installation files: the certificate could not be verified.
    ```

### 2. 解决方案：手动导入证书
**方法A：图形化导入（推荐）**
1.  **获取证书**：从有网电脑下载 `Microsoft Windows Code Signing PCA 2024.crt` 文件，复制到服务器。
2.  **导入证书**：
    - 右键 `.crt` 文件 → **安装证书**。
    - 存储位置选择 **“本地计算机”**。
    - 选择 **“将所有证书放入下列存储”** → 浏览选择 **“受信任的根证书颁发机构”** → 完成导入。

### 3. 验证解决
导入证书后，重新执行 [二、2] 的安装命令。此时应能正常弹出 Visual Studio Installer 进度界面，安装完成后即可使用 SSMS 22。

## 四、目录结构说明
完整的离线包 (`SSMS22_Offline`) 结构如下，**无需寻找子目录**，直接使用根目录下的 `vs_SSMS.exe` 即可：
```
SSMS22_Offline/
├── vs_SSMS.exe                 # 引导程序
├── certificates/               # 证书文件夹（含其他根证书）
├── packs/                      # 核心组件包 (.msi, .cab)
├── Archive.json
└── ...（其他配置文件）
```

## 五、注意事项
1.  **路径长度**：离线包存放路径建议少于 80 字符（如 `C:\SSMS22`），避免因路径过长导致解压失败。
2.  **版本兼容**：SSMS 22 专用于管理 SQL Server 2014 及更高版本。若需管理 SQL Server 2025 的设计图功能，必须使用 SSMS 22，旧版 SSMS 18/19 不支持。
3.  **静默安装**：若需脚本部署，可使用 `--quiet` 参数进行静默安装。

---

**文档维护**：本文档基于 Microsoft Learn 官方文档及离线环境实战经验整理。若安装仍有问题，请优先检查 `%TEMP%` 日志中的错误代码。