在日常的模型微调、推理部署或自动化任务中,我们往往需要与第三方服务、远程仓库打交道——比如传入一个 Token、指定模型仓库地址,或者传递运行参数。如何将这些敏感信息安全、灵活地注入容器,一直是开发者的常见痛点。
现在,HyperAI(hyper.ai)已正式为算力容器推出了「环境变量与 Secret 变量」配置功能。从今天起,无论你是创建新容器,还是调整已有任务、Jupyter 工作空间,都可以直接注入一组变量名/变量值形式的环境变量,以更优雅的方式控制容器行为。
配置环境变量
每个环境变量都包含一种类型,分为明文与 Secret 两种,由变量右侧是否勾选「Secret」决定。
在容器的创建/配置页面找到「环境变量」后,操作非常直观:
- 点击「Add environment variable」,填写「Variable name」和「Variable value」;
- 选择变量类型:默认为明文类型;如果是密钥、Token 这类敏感信息,勾选右侧的「Secret」即可变为 Secret 类型;
- 可添加多个变量,提交后随容器一起保存。

Secret 变量的脱敏与读取
Secret 变量一旦保存,平台便不会以明文形式返回其值。拥有编辑权限的成员在页面各处看到的,均为脱敏后的占位内容:
- 脱敏后仅保留头尾各 2 个字符,中间以 •••• 代替(例如
hf••••23); - 若原值长度不足 8 位,整体以 •••••• 显示,不会泄露真实长度。

没有编辑权限的成员则完全无法读取该值,接口直接返回 null。需要特别留意的是,脱敏值仅供展示,并非变量的真实内容。容器运行时注入的,始终是当初保存的原始值。
重启与克隆时的 Secret 处置
是否沿用原 Secret 的真实值,关键取决于本次操作是重启同一个执行,还是创建一个全新的执行。
重启工作空间:
对已关闭的工作空间再次启动(「Start」或「Update & Start」),属于同一执行的延续,会沿用上一次保存的 Secret 真实值,无需重新输入:
- 快速启动:直接沿用上一次的全部配置,Secret 的真实值由平台在服务端自动回填;
- 修改配置并启动:Secret 以脱敏、只读形式列出并默认沿用。如需更换,点击该变量的「替换」输入新值,点击「取消替换」则恢复为沿用原值。
克隆 / 新建执行:
以下操作均会生成一个全新的执行,因此不会带入原 Secret 的真实值:
- 从公共教程、公共资源克隆;
- 克隆他人的配置并启动、从自动建模克隆;
- 从某次执行「继续执行 / 自此克隆」创建新执行。
在这些场景下,克隆者本就无法读取原 Secret 的明文,平台也不会将其带到新执行中。页面会保留变量名并提示「原 Secret 值无法保留,请输入新值」,你需要为每个 Secret 变量填写自己的值,或者删除不需要的变量后再启动。明文变量则会照常带入新执行。
修改变量类型:
变量的类型可在明文与 Secret 之间切换:
- 明文改为 Secret:勾选「Secret」即可,已填写的值会作为该 Secret 的值保存。
- Secret 改为明文:取消勾选「Secret」。由于已保存的 Secret 原值无法再读取,切换后原值会被丢弃,需要重新填写该变量的值(页面会先弹窗确认)。
