沙箱

约束与限制

文件访问控制

启用沙箱后，码道CLI对文件目录的访问权限配置如下。您也可以根据实际业务需求，自定义码道CLI对文件目录的访问权限，详细介绍请参见启用沙箱。

启用沙箱

下面以在TUI开发环境中启用沙箱为例。在CLI开发环境中，请直接执行“codearts run "输入的指令" --sandbox”命令即可。

1. 进入TUI开发环境。
   1. 打开目标项目的根目录。
   2. 鼠标右键单击空白处，选择“在终端中打开”。
   3. 在终端中输入“/codearts”并回车，即可进入TUI开发环境。

2. 启用沙箱运行模式。
   1. 在TUI对话框中，输入“/run-mode”并回车，进入“选择运行模式”页面。
   2. 单击“Sandbox沙箱”，进入“沙箱配置”页面。
      图1 选择SandBox沙箱
      

3. 配置命令白名单。

   根据实际需求将特定命令的前缀添加到白名单。被加入白名单的命令将绕过沙箱机制，直接在沙箱外执行。

4. 选择网络访问策略。

   表3 网络访问策略说明

   参数	说明
   全网访问	允许访问所有内部及外部网络资源。
   本地网络访问	仅允许访问本地服务网络（局域网/内网），禁止访问外部互联网。
   禁止网络访问	阻断所有网络连接，禁止访问任何内部或外部资源。
   网络自定义访问	通过修改策略配置Json文件，自定义当前项目沙箱环境中进程的文件与网络访问范围。具体操作，请参见5。

5. 自定义网络访问策略。
   1. 在“网络访问策略”中，选择“网络自定义访问”，单击“确认”，进入“自定义策略”页面。
   2. 在策略配置Json文件中，根据您的需求修改配置。
      该文件的初始结构如下所示：

      {
          "filesystem": {
              "readWrite": [],
              "readOnly": []
          },
          "network": {
              "default": "Allow",
              "allow": [],
              "deny": []
          },
          "resources": {
              "cpu": 50,
              "memory": 8
          }
      }

      表4 策略配置Json文件参数说明

      参数	是否必选	参数类型	描述
      filesystem	否	filesystem Object	用于精确控制沙箱对本地文件系统的访问权限。 如果未设置（filesystem字段为空或不存在），则采用沙箱内置的文件系统安全策略。
      network	否	network Object	用于控制沙箱内进程的网络访问策略，支持配置允许或阻止对特定网络资源的访问。 如果未设置，默认允许网络访问
      resources	否	resources Object	用于定义沙箱运行时的计算资源上限，确保业务稳定并防止资源滥用。 如果未设置，系统将共享宿主机资源。

      表5 filesystem字段参数说明

      参数	参数类型	默认值	支持路径格式	优先级规则	描述
      readWrite	Array	[ ]	绝对路径：如/home/user/project、C:\Projects 相对路径：如./src、./config 环境变量：$HOME（Linux/Mac)、%USERPROFILE%（Windows） Home目录简写：~	readOnly > readWrite > 系统默认策略 如果某个路径同时匹配readOnly和readWrite，则以readOnly为准。	可读写路径列表。
      readOnly	Array	[ ]			只读路径列表。

      表6 network字段参数说明

      参数	参数类型	默认值	优先级规则	描述
      default	String	Allow	deny > allow > default 如果allow和deny同时配置同一规则时，则以deny为准。	默认的网络访问策略。 Allow：允许访问 Deny：禁止访问 说明： 该字段支持“域名:端口”和“IP:端口”两种配置格式，其中域名部分支持通配符，IP地址支持CIDR表示法。多个端口可通过逗号分隔进行配置。若未指定具体端口，则默认对所有端口生效。
      allow	Array	[ ]		允许访问的网络规则列表。
      deny	Array	[ ]		拒绝访问的网络规则列表。

      表7 resources字段参数说明

      参数	参数类型	默认值	最小值	描述
      cpu	Integer	50	20	CPU占比，单位为%。
      memory	Integer	8	1	内存大小，单位为GB。

      策略配置Json文件配置示例如下：

      {
          "filesystem": {
              "readWrite": [
                  "/home/user/project/output",
                  "~/workspace/temp"
              ],
              "readOnly": [
                  "/etc/systemd",
                  "%USERPROFILE%/.ssh"
              ]
          },
          "network": {
              "default": "Allow",
              "deny": [
                  "10.0.0.0/8",
                  "192.168.0.0/16"
              ]
          },
          "resources": {
              "cpu": 50,
              "memory": 8
          }
      }

   3. 单击“确认”，退出当前设置界面，完成沙箱模式的启用。

高风险命令执行策略

当智能体检测到高风险命令时，AI将会在对话流中发出提示（TUI开发环境会弹框是否被拦截，CLI开发环境直接被拦截）。请评估风险后，按需选择执行方式。

• Allow once，仅允许本次执行，下次遇到相同命令会再次询问。
• Allow always，本次会话中，此类命令将不再询问，直接执行。
• Reject，不执行此命令，继续对话。适合您认为有风险或不必要的操作。

如果需要关闭沙箱功能，请参考关闭沙箱模式。

关闭沙箱模式

以在TUI开发环境中关闭沙箱为例。在CLI开发环境中，请直接执行“codearts run "输入的指令" --auto”命令即可。

1. 进入TUI开发环境。
   1. 打开目标项目的根目录。
   2. 鼠标右键单击空白处，选择“在终端中打开”。
   3. 在终端中输入“/codearts”并回车，即可进入TUI开发环境。

2. 关闭沙箱运行模式。
   关闭沙箱模式就是将运行模式设置为手动或者自动。

   1. 在TUI对话框中，输入“/run-mode”并回车，进入“选择运行模式”页面。
   2. 在“Auto 自动”或“Manual 手动”上，单击Enter键，即可退出沙箱运行模式。
      • Auto 自动：智能体直接执行所有命令，无需征得您的同意。

        为了确保安全，建议只在必要时启用“自动运行”模式。此模式会绕过所有安全检查，可能在未经提醒的情况下执行高风险操作。

      • Manual 手动：智能体执行任何命令前，都会向用户发送确认提示，用户需手动确认后，命令才会继续执行。
        图3 切换沙箱运行模式