# 企业用户使用Code Server网络要求 为确保Code Server在企业内网环境中的稳定性，请满足以下要求： - 所有依赖域名已放行，详情请参见[Code Server依赖域名]。 - 企业网络设备（防火墙、CDN、代理）支持WebSocket协议透传。如遇问题，请参考[Code Server网络故障排查]。 #### Code Server依赖域名 为确保Code Server正常运行，需开放以下域名的网络访问权限。这些域名涉及插件市场、资源加载、远程开发等功能，禁用将影响相关功能的使用。 | 域名 | 用途 | |:---|:---| | authoring-modelarts-cnnorth4.huaweicloud.com | ModelArts平台域名（示例为华北-北京四，请根据实际区域修改）。 | | vscode-remote+authoring-002dmodelarts-002dcnnorth4-002ehuaweicloud-002ecom.vscode-resource.vscode-cdn.net | VS Code远程开发资源加速CDN（ModelArts平台）。 | | openvsx.eclipsecontent.org | Open VSX内容分发/镜像域名，用于加速插件文件（.vsix）下载和静态资源分发。 | | img.shields.io | 定期（或实时）从Visual Studio Marketplace的API拉取下载量数据，生成项目徽章（如下载量、版本号等），实时拉取数据并渲染为图片。 | | github.com | GitHub代码托管平台与原始文件访问入口。 | | raw.githubusercontent.com | GitHub原始文件直链服务（用于直接访问代码文件）。 | | badges.gitter.im | 生成Gitter聊天室徽章图标。 | | open-vsx.org | VS Code插件市场与扩展注册表（开源替代方案）。 | | code.visualstudio.com | VS Code官方网站（文档、下载、社区等）。 | #### Code Server网络故障排查 在企业内网环境下，Code Server可能出现以下网络故障及解决方案： #### 故障一：WebSocket连接异常 用户浏览器与Code Server服务端建立WebSocket连接时，相关插件未显示。 图1插件未显示 ![](https://support.huaweicloud.com/devtool-modelarts/figure/zh-cn_image_0000002656502661.png "点击放大") 图2插件正常显示 ![](https://support.huaweicloud.com/devtool-modelarts/figure/zh-cn_image_0000002626263300.png "点击放大") 打开浏览器调试窗口出现以下报错： ``` Invalid frame header ``` 图3浏览器报错 ![](https://support.huaweicloud.com/devtool-modelarts/figure/zh-cn_image_0000002656382709.png "点击放大") #### 故障二：创建或打开Jupyter文件报错 在Code Server中创建或打开Jupyter文件时出现以下报错。 - 创建Jupyter文件： ``` Command 'Create: New Jupyter Notebook' resulted in an error ``` 图4创建Jupyter文件 ![](https://support.huaweicloud.com/devtool-modelarts/figure/zh-cn_image_0000002626322682.png "点击放大") 图5创建Jupyter文件报错 ![](https://support.huaweicloud.com/devtool-modelarts/figure/zh-cn_image_0000002656602093.png "点击放大") - 打开Jupyter文件： ``` Unable to open 'xxx.ipynb' ``` 图6打开Jupyter文件报错 ![](https://support.huaweicloud.com/devtool-modelarts/figure/zh-cn_image_0000002626258780.png "点击放大") #### 故障可能原因及解决方案 上述故障的可能原因及解决方案如下。 | 可能原因 | 说明 | 解决方案 | |:---|:---|:---| | 协议不匹配 | WebSocket连接要求服务器严格遵循[RFC 6455协议](https://tools.ietf.org/html/rfc6455)。错误提示表明： - 服务器返回的数据帧头部格式不符合WebSocket标准。 - 代理服务器/TLS层可能修改了数据包（常见于企业网络环境）。 | 检查企业代理服务器或TLS中间件（如Nginx、Squid）是否对WebSocket流量进行了非标准处理，需关闭相关修改功能。 | | 企业防火墙/CDN干扰 | 企业网络中的防火墙或CDN可能对WebSocket流量进行拦截或优化，导致连接异常。 | - **防火墙配置** ： - 确认防火墙已放行WebSocket流量（协议类型ws或wss）。 - 检查是否拦截了Upgrade: websocket请求头。 - **CDN配置** ： 1. 关闭CDN的"自动压缩"功能（如Gzip、Brotli），避免修改WebSocket数据帧。 2. 确保CDN支持WebSocket协议透传。 - **NAT超时调整**：将NAT超时时间调整为≥1800秒（30分钟），避免连接因超时中断。 | | 代理网络异常 | 代理服务器可能未正确转发WebSocket请求，或存在中间人（MITM）加密导致协议冲突。 | 确保代理服务器支持WebSocket协议透传。 |