Windows下Chocolatey安装报错解决方案与离线安装指南

1. Chocolatey安装报错问题全解析

最近在Windows系统上安装GitLeaks时遇到了一个棘手的问题——必须先安装Chocolatey包管理器，但安装过程中却反复出现"基础连接关闭"的错误。作为一名长期在Windows环境下工作的开发者，我深知Chocolatey的重要性，它就像是Windows平台的Homebrew，能极大简化软件安装流程。下面我将详细记录这个问题的完整解决过程，希望能帮助遇到同样困境的朋友。

1.1 问题现象与初步排查

最初按照官方推荐的方法，在PowerShell中执行以下命令进行安装：

powershell复制Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

但执行后却收到了"基础连接关闭"的错误提示。这种错误通常与网络连接或安全协议配置有关，于是我首先检查了以下几个方面：

1. TLS设置：确保系统启用了TLS 1.2（Chocolatey要求的最低版本）

   powershell复制[System.Net.ServicePointManager]::SecurityProtocol
   

   确认输出包含Tls12（3072）

2. 网络连接：测试是否能正常访问Chocolatey官网

   powershell复制Test-NetConnection chocolatey.org -Port 443
   

3. 代理设置：检查系统是否配置了可能干扰连接的代理

   powershell复制netsh winhttp show proxy
   

提示：如果企业网络有严格限制，可能需要联系IT部门开放chocolatey.org的访问权限。

1.2 深入问题根源

当上述检查都通过后问题依然存在，我开始怀疑是安装脚本的下载环节出了问题。通过分析安装脚本的行为，发现它需要从以下地址下载资源：

• https://chocolatey.org/api/v2/package/chocolatey/
• https://chocolatey.org/install.ps1

使用Fiddler抓包工具分析网络请求后，发现连接在SSL握手阶段就被中断。这可能是由于：

1. 系统根证书不完整或过期
2. 本地安全软件拦截了连接
3. Chocolatey服务器端临时问题

2. 离线安装解决方案

当在线安装不可行时，离线安装是最可靠的替代方案。以下是经过验证的完整步骤：

2