环境

环境窗格设置会导出到机器 VM 中每一个 shell 的纯环境变量(机器在设置编辑器中即工作区)。它们用于非秘密的设置——日志级别、功能标志、构建开关——那些你想放进代理环境、又不需要任何凭据处理的东西。

环境窗格,显示空状态消息“未设置任何环境变量”与一个“添加变量”按钮。

说明文字写出这个窗格的用途与不适用之处:“纯 KEY=VALUE 配对,通过 proxy.env(由 .bashrc 加载)导出到 VM 中的每一个 shell。不做代理替换——这些值会原封不动抵达 VM,所以不要把秘密放在这里。适合日志级别、功能标志、构建开关。”什么都没设置时,它会显示未设置任何环境变量。

变量如何被导出

每个变量都会写入 proxy.env,而机器受管的 .bashrc 会为每一个 shell 加载它。那个值会出现在每一个终端、代理执行的每一个命令,以及每一个登录与非登录 shell 中,形式与你输入的完全相同。没有替身,线路上也没有替换。

至于令牌或密码,请改用凭据窗格:在那里 VM 只会拿到一个替身,真实值则在线路上被放入。输入在这个窗格中的秘密,会以明文抵达 VM 内部。

添加与编辑变量

添加变量会追加一行,含一个名称字段与一个值字段;减号按钮可移除它。名称必须是有效的 shell 标识符——一个字母或下划线,接着是字母、数字与下划线。不符合的名称会显示橙色警告,且不会被导出。值会照你所写的使用。

在运行中的机器上的更改

存储会在不重新启动的情况下生效:proxy.env 会被重写,而存储之后打开的 shell 会看到新值。已经在运行的代理会保有它启动时的环境;新的标签页或新的会话则会取得这项更改。

这些值保存在机器已加密的 secrets.enc 中,与这个窗格的其他数据相同,而不是在 profile.json 里。

设置参考

设置类型默认说明
变量列表名称/值的行空每一行通过 proxy.env 把一个变量导出到每一个 shell。无效的名称会显示警告并被略过。值会原样使用。
添加变量按钮—追加一个空白行。

相关章节

  • 凭据 — 秘密该放的地方。
  • MCP — MCP 服务器,其中有些会读取环境变量。
  • 设置参考 — 所有窗格一览。