874 字约 3 分钟
仅预览模式是云原生开发的衍生能力。在该模式下，点击 云原生开发 按钮 将直接打开预览页面而非 WebIDE，提供更快捷的预览体验。
注意事项
- 此功能为 beta 版本，相关配置和使用方法后续可能会变更。
- 仅预览模式不支持 WebIDE，可借助自定义按钮创建支持 WebIDE 的云开发按钮入口。
- 若要使用 SSH 连接，请自行在镜像中安装 openssh
- 仅预览模式不支持代理，
$CNB_VSCODE_PROXY_URI环境变量在此模式下无效。如需代理，请使用标准云开发模式。
如何配置？
最简配置：
.cnb.yml
$:
vscode:
- docker:
build: .ide/Dockerfile
services:
- name: vscode
options:
onlyPreview: true
launch: node index.js完整配置示例（含所有可选参数）：
.cnb.yml
$:
vscode:
- docker:
build: .ide/Dockerfile
services:
- docker
- name: vscode
options:
onlyPreview: true
launch: node index.js
keepAliveTimeout: 10m
daemon: true
backup: true
stages:
- name: prepare
script: ls -al各参数详细说明见下方参数详解。
参数详解
onlyPreview
- 类型：
Boolean - 说明：是否启用仅预览模式
- 效果：设置为
true时，点击云原生开发按钮将打开预览页面而非 WebIDE。若要使用 SSH，需自行在镜像中安装 openssh
launch
- 类型：
String - 说明：启动业务服务的命令
- 注意：业务服务必须启动在
8686端口 - 示例：
node index.js、npm start、python app.py等
keepAliveTimeout
- 类型：
Number|String（单位默认为毫秒） - 默认值：
600000（10 分钟） - 说明：开发环境的离线保活时间。检测不到 HTTP 连接时，超过设定时间后将自动关闭开发环境
- 示例：
7200000表示 2 小时
支持直接写数字（毫秒），或带单位的字符串格式，如 10m 表示 10 分钟。支持以下单位：
ms：毫秒（默认）s：秒m：分钟h：小时
daemon
- 类型：
Boolean - 默认值：
false - 说明：进程启动模式：
true（守护进程模式）：launch 命令启动的服务直接运行在后台false（非守护进程模式）：可以查看启动日志，等待服务启动完成并主动退出后继续后续流程
backup
- 类型：
Boolean - 默认值：
false - 说明：是否备份/恢复用户数据（仅在预览模式下生效）。设置为
true时：- 启动时：恢复上次的用户漫游数据和未提交的代码更改
- 运行时：定时备份未提交的代码更改
- 关闭时：备份用户漫游数据和未提交的代码更改
使用流程
- 在项目根目录创建
.cnb.yml文件 - 按照上述配置示例进行配置
- 确保业务服务监听在
8686端口 - 点击云原生开发按钮
- 系统将自动启动开发环境并打开预览页面
仅预览模式如何使用 SSH 连接？
需在自定义开发环境中安装 openssh，在 .ide/Dockerfile 中配置示例如下：
FROM node:20
RUN apt-get update && apt-get install -y git wget unzip openssh-server
ENV LANG C.UTF-8
ENV LANGUAGE C.UTF-8仅预览模式环境创建后直接进入预览页面，不展示客户端选择页。如需客户端连接，可在「头像 → 我的云原生开发」页面找到入口。