解决code-server安装Python扩展失败问题

在Ubuntu系统上使用code-server时，安装Python扩展可能会遇到两种常见错误："read ECONNRESET"和"End of central directory record signature not found"。本文将详细介绍这些问题的成因及解决方案。

问题现象

用户在Ubuntu 22.04.5 LTS系统上运行code-server 4.98.2版本时，尝试安装ms-python.python扩展时遇到以下两种错误：

1. 直接安装时出现网络连接错误：

Installing extensions...
read ECONNRESET
Failed Installing Extensions: ms-python.python

2. 下载vsix文件后安装时出现压缩包错误：

Error: End of central directory record signature not found. Either not a zip file, or file is truncated.

问题分析

这些错误通常与网络连接限制或安全配置有关。code-server在安装扩展时需要访问特定的在线资源，当这些连接被阻止时就会出现问题。

解决方案

1. 检查并配置网络设置

确保网络允许访问以下关键域名和端口：

• openvsxorg.blob.core.windows.net:443
• marketplace.visualstudio.com:443
• az764295.vo.msecnd.net:443
• code.visualstudio.com:443
• update.code.visualstudio.com:443
• vscode.download.prss.microsoft.com:443
• download.visualstudio.microsoft.com:443
• open-vsx.org:443
• xextensions.coder.com:443

特别是openvsxorg.blob.core.windows.net:443，这是扩展文件的实际下载地址，许多用户容易忽略这一点。

2. 使用详细日志进行安装

在安装扩展时添加--verbose和--log trace参数，可以获取更详细的安装过程信息，帮助诊断问题：

code-server --install-extension ms-python.python --verbose --log trace

3. 离线安装注意事项

虽然理论上可以通过下载vsix文件进行离线安装，但实际上安装过程仍可能需要网络连接来完成某些依赖项的下载。如果必须离线安装，建议：

1. 确保vsix文件完整下载（检查文件大小和哈希值）
2. 准备所有可能的依赖项
3. 在完全离线的环境中测试安装

验证解决方案

在添加了openvsxorg.blob.core.windows.net:443的网络访问规则后，用户成功安装了Python扩展：

Extension 'ms-python.debugpy' v2025.4.1 was successfully installed.
Extension 'ms-python.python' v2025.2.0 was successfully installed.

总结

code-server的扩展安装问题通常与网络连接有关。通过正确配置网络设置，特别是确保能够访问扩展文件的实际下载地址，可以解决大多数安装失败的问题。对于企业环境或受限制的网络，建议预先测试所需的网络连接，并考虑建立内部扩展仓库的方案。