关键不是“能不能装”,而是“谁来下载、在哪解压、怎么让插件连上后端”:需在有网机下载校验code-server二进制、.vsix插件包及模型文件,拷入内网后手动解压、命令行强制安装、配置本地Ollama/Qwen2.5-Coder服务并显式指定OLLAMA_HOST,确保版本兼容。

私有云无外网环境部署 VSCode 及其核心插件,关键不是“能不能装”,而是“谁来下载、在哪解压、怎么让插件连上后端”。离线部署本质是把网络依赖提前转移——vscode-server 二进制、.vsix 插件包、模型服务(如 ollama 或 qwen2.5-coder)必须全部在有网机器上拉取并校验完整,再拷贝进内网。跳过这步直接传文件,90% 的失败源于 .vsix 包损坏或版本不匹配。
手动下载 vs code-server 并解压到目标路径
VSCode Remote-SSH 卡在“正在下载 vscode-server”时,实际是远程服务器尝试从 https://github.com/coder/code-server/releases 拉取对应架构的 tar.gz 包。无外网时必须人工介入:
- 在能联网的机器上,根据目标服务器 CPU 架构(
x86_64或aarch64)和系统(linux-amd64/linux-arm64)下载对应code-server-*.tar.gz,例如code-server-4.12.0-linux-amd64.tar.gz - 用
sha256sum核对哈希值(官网 release 页面提供),避免传输损坏 - 上传至服务器任意目录(如
/opt/code-server),执行:tar -xzf code-server-*.tar.gz -C /opt/ && ln -sf /opt/code-server-*/bin/code-server /usr/local/bin/code-server
- 确认
code-server --version可正常输出,否则说明解压路径或权限不对(需chmod +x二进制)
离线安装 .vsix 插件:别信“拖拽安装”
VSCode 界面里直接拖 .vsix 文件看似可行,但在私有云中常因插件依赖未满足而静默失败(比如 continue.continue 依赖 ms-vscode.vscode-typescript-next)。可靠做法是命令行强制安装:
- 所有插件(含依赖)提前在有网环境用
code --install-extension导出为--force .vsix,ID 可查open-vsx.org或插件 marketplace 页面 URL - 将
.vsix全部拷入服务器,逐个执行:code-server --install-extension /path/to/continue-0.6.7.vsix --force
- 注意:如果插件含 native binary(如通义灵码的
aliyun-lingma),必须确保其预编译二进制与服务器libc版本兼容(Ubuntu 22.04 用glibc 2.35,CentOS 7 是2.17)
插件后端服务(如 Ollama/Qwen2.5-Coder)必须本地运行
很多 AI 插件(continue、code-whisperer-lite)默认调用 http://localhost:11434 这类本地模型服务。离线环境中,这个地址不能是占位符:
- 在服务器上安装
ollama(curl -fsSL https://ollama.com/install.sh | sh需提前下载脚本并修改源为内网镜像) - 用
ollama pull qwen2.5-coder:1.5b-q4_k_m命令前,先从 ollama 官网或镜像站下载对应safetensors和gguf文件,手动导入:ollama create qwen2.5-coder -f Modelfile
(Modelfile 中指定本地路径) - 启动后验证:
curl http://localhost:11434/api/tags应返回模型列表;插件配置里的OLLAMA_HOST必须显式设为http://127.0.0.1:11434,不能留空或写localhost(某些容器网络下解析失败)
最容易被忽略的是插件与后端服务之间的协议兼容性:比如 continue 插件 v0.6.7 要求 Ollama API v0.1.40+,但私有云里若混用旧版 ollama 二进制,会返回 404 Not Found 而非明确报错。务必比对插件文档中标注的最低服务版本,并在内网统一固化二进制和模型版本。











