Skip to main content

其他问题

一、turtle依赖包使用说明​

由于 turtle 依赖交互式 UI 渲染，目前暂不支持该依赖包的使用。

二、预览地址预测方法​

预览地址由空间Key、UrlToken、端口号及域名组成，可通过以下格式访问环境变量进行预测：

${X_IDE_SPACE_KEY}-${PORT}.${region}.cloudstudio.club

若需查询当前应用的具体环境变量，可通过echo命令快速获取：

echo ${X_IDE_SPACE_KEY}-${PORT}.${region}.cloudstudio.club

三、端口与转发相关支持说明​

（一）是否支持TCP和UDP端口转发？​

目前暂不支持TCP和UDP端口的转发。

（二）是否支持WebSocket转发？​

支持WebSocket转发，需注意：客户端需通过wss://协议进行连接。

（三）什么类型的代理支持预览转发？​

CloudStudio 提供 HTTPS 网关，仅支持代理工作空间内部的非 HTTPS 服务；若为 HTTPS 服务，则无法代理。

四、关于平台是否支持 SSH 的说明​

（一）是否支持 SSH？​

目前平台暂时不支持直接的 SSH 连接。

若您有远程访问需求且愿意自行探索配置，可通过以下方式实现类似功能，核心思路为 “安装 SSH 服务 + 网络穿透”

五、解决 Vite 验证问题​

问题​

在使用 Vite 开发时，可能会遇到前端页面无法正常访问的情况，如下图所示：

典型错误表现​：

  • 页面显示 "Blocked request" 错误提示
  • 控制台报错：该主机未被允许访问
  • Vite 服务正常启动，但网络请求被阻止

解决方案​​

在 vite.config.js 中，我们推荐使用以下配置：

server: {
    host: true,         // 启用外部访问
    port: 3000,         // 默认服务端口
    strictPort: false   // 自动处理端口占用
    // 注意：allowedHosts 字段无需配置
}

重要提示：

  • 已内置此问题的完整修复，通常无需任何额外配置
  • 如果手动配置了 allowedHosts 字段，自定义配置具有最高优先级
  • 推荐使用默认配置，无需添加 allowedHosts