必须自建兼容Open VSX协议的私有插件仓库,因VSCode 1.80+强制内置网络栈且校验签名,仅改serviceUrl无效;需实现/vscode/gallery、/vscode/item、/vscode/resource及/recommendations四个端点。

内网或私有云环境无法直连 Visual Studio Marketplace,唯一可靠路径是自建兼容 Open VSX 协议的私有插件仓库服务,而非试图代理或镜像官方市场。
为什么不能只改 extensions.gallery.serviceUrl 就完事?
VSCode 1.80+ 版本对扩展市场的所有请求(包括搜索、安装、更新、推荐)都强制走内置网络栈,绕过系统代理;且部分请求带签名 header,普通反向代理无法透传。单纯修改配置项后若服务端不满足 Open VSX 协议规范,客户端会静默失败或报 getGalleryServiceUrl failed、network error 等模糊错误。
必须部署一个能响应以下三类 endpoint 的服务:
-
/vscode/gallery(返回服务元信息) -
/vscode/item(按 publisher/name/version 返回扩展详情) -
/vscode/resource/{publisher}/{name}/{version}/{path}(提供 .vsix 文件下载)
选 jvs-server 还是 open-vsx-server?
中小团队优先用 jvs-server:零依赖、纯内存索引、启动快、无数据库运维成本。它不存扩展包本身,只做路由和元数据聚合,需配合静态文件服务(如 Nginx)托管 .vsix 文件。
大型组织建议用 open-vsx-server(Docker 部署):支持命名空间权限(如 team-a.can-publish)、LDAP/OAuth 集成、前端 UI 管理界面,但需维护 registry + webui + CLI 三组件。
注意:vscode-extension-marketplace-server 虽轻量,但已多年未更新,对 VSCode 1.85+ 的 resourceUrlTemplate 渲染存在兼容问题,不建议新项目采用。
上传插件前必须处理的三个细节
上传不是把 .vsix 往目录一丢就完事。常见失败源于:
-
publisher字段必须与你在package.json中定义的一致,且不能是vscode、ms-vscode等保留名,否则ovsx publish会拒绝 - 私有仓库默认不校验签名,但 VSCode 客户端仍会检查
engines.vscode兼容性。若插件声明"^1.90.0",而内网用户用的是 1.87.2,则安装时提示Incompatible extension - 上传命令必须带
--registry参数指向你的私有服务地址,例如:ovsx publish --registry https://vsx.your-company.com -p your-publisher-name;漏掉--registry会默认发往 public open-vsx.org
客户端配置最容易漏掉的字段
仅配 serviceUrl 不够。VSCode 会同时请求推荐插件列表,若 recommendationsUrl 仍指向官方地址,控制台会报 403 并卡住“正在加载推荐”状态栏。必须在 settings.json 中补全:
"extensionsGallery": {
"serviceUrl": "https://vsx.your-company.com/vscode/gallery",
"itemUrl": "https://vsx.your-company.com/vscode/item",
"resourceUrlTemplate": "https://vsx.your-company.com/vscode/resource/{publisher}/{name}/{version}/{path}",
"recommendationsUrl": "https://vsx.your-company.com/vscode/recommendations"
}
其中 recommendationsUrl 对应的 endpoint 必须由服务端实际实现——jvs-server 默认不提供,需自行补充静态 JSON 响应(如返回空数组),否则客户端行为不可控。


















