用途:当用户提供 site_<sandbox-id>_<code> 格式的站点连接 Key,要求连接、验证或操作站点空间时使用。仅连接和维护已有站点,不创建站点或沙箱。
主要能力:通过 sandbox exec 执行命令与构建;fs ls/cat/mkdir/cp/mv/rm 管理文件;sandbox host 获取 80 端口访问地址。Key 同时是受限 API Key,其权限只作用于绑定的一个沙箱,无法列出、删除沙箱或操作模板。
使用方式:先确认最低版本 v1.3.2,用官方安装脚本装到 ~/.local/bin。Linux/macOS 在同一 shell 中校验 Key、把完整 Key 设为 UCLOUD_SANDBOX_API_KEY、派生 SANDBOX_ID(仅取第一个 _ 之前部分),再三合一验证连接与目录。部署要求服务监听 0.0.0.0:80、加载 /home/user/.site.env、后台持久运行并保存 PID 与日志,站点内 HTTP 验证成功后再获取公共地址。Windows 需按 Windows PowerShell 指南操作。
限制:旧格式 site_<sandbox-id> 已不可用,须重新获取。连接码与完整 Key 属敏感凭证,不得写入回复、日志、代码或配置文件。401 访问码保护、403 IP 名单或自定义域名限制均不由 CLI 处理,只能由客户在控制台调整。缺失信息(如具体地域、访问码)不在资料内,需向用户确认。