站点发布
将工作空间中的静态页面或 HTTP 服务发布为独立站点
站点发布
站点发布用于把工作空间中的页面或服务发布为可访问的独立站点。发布后系统会自动生成站点地址,适合分享文档、Demo 页面、原型页面、预览服务或内部工具。
- 静态 HTML:从工作空间文件系统读取 HTML、CSS、JS、图片等文件。
- HTTP 服务:发布工作空间内正在运行的 Web 应用或接口服务。
站点默认仅空间成员可见,发布者也可以按需要调整为组织内可见。未发布、草稿或已下线站点不会对外访问。
适用场景
- 将工作空间中的静态页面快速分享给团队成员查看。
- 把正在开发的前端应用、后端服务或全栈 Demo 以站点形式对外预览。
- 发布需要登录访问的内部工具,并明确告知访问者站点会读取哪些个人数据。
- 在本地执行机或云端运行环境中调试 Web 服务访问效果。
静态 HTML
静态模式需要配置站点根目录和入口文件。根路径访问会返回入口文件,子路径会映射到站点根目录下的同名资源。
静态资源支持相对路径加载,例如 ./main.js、main.js、css/style.css。HTML 中以 / 开头的绝对路径不会自动改写到站点路径下,建议静态站点使用相对路径。
文件读取统一通过工作空间文件适配器完成,因此云端 workspace 和本地执行机 workspace 都使用同一套访问规则。
HTTP 服务
HTTP 服务发布面向需要进程持续运行的 Web 应用,例如开发服务器、后端接口服务或全栈框架应用。
发布 HTTP 服务时,需要填写应用监听端口,并可补充服务启动说明、健康检查路径、基础路径等高级配置。服务启动说明用于帮助发布者或协作者在服务停止后快速恢复运行。
访问站点时,后端会根据工作空间当前执行模式解析目标:
- 云端 sandbox:如果容器已停止,会自动唤起容器。
- 本地执行机:如果本地执行机离线,会返回不可用状态,不会回退到云端 sandbox。
系统会记录服务恢复状态,便于发布者判断服务是否已恢复成功。
访问地址
站点优先使用自动生成的独立站点地址访问。独立地址可以让页面资源、接口请求、Cookie 和前端路由更接近真实部署方式。
系统也保留平台内兼容访问入口,便于从工作空间设置、文件预览等位置跳转和调试。
系统管理员可以在平台管理后台按站点禁用独立站点域名访问。禁用后,站点不会被删除,发布配置仍然保留;访问该独立站点地址时会显示临时不可用提示,用于异常流量、故障排查或稳定性保护场景。
授权数据
发布站点时,发布者需要声明站点会读取哪些访问者数据。访问者首次打开站点时,会看到对应的授权确认页面;同意后,该授权只对当前站点生效,不会被其他站点复用。
当前产品界面开放两种授权选择:
- 不读取用户数据:访问者只需要登录并打开站点。
- 只读取访问者基本信息:站点可以获取访问者的姓名、昵称和头像,用于识别当前访问者。
工作空间内容读取、站点内对话等更高风险授权能力仍在评估中,当前产品界面暂不开放给发布者选择。
访问者授权后,可以在个人设置的“站点授权”中查看站点已获得的权限,并可以打开站点、调整授权范围或撤销授权。撤销后,再次访问该站点时需要重新确认授权。
权限
站点可见性支持:
- 组织内可见:同组织登录用户可访问。
- 空间成员可见:仅工作空间成员可访问。
站点可见性控制“谁可以打开站点”,授权数据控制“站点打开后可以读取访问者哪些数据”。两者是独立配置:即使用户具备站点可见性权限,站点读取个人资料前仍需要用户确认授权。