容器计算服务 ACS：为ACS Agent Sandbox配置增强型出口流量管理

步骤一：创建 Sandbox

在创建 Sandbox 时，可以通过 network.alibabacloud.com/network-policy-mode 注解（Annotation）来声明不同的网络策略模式。本示例将创建一个开启 增强流量策略（Enhanced Traffic Policy） 模式的 Sandbox，系统将自动注入 traffic-proxy Sidecar。

1. 将以下内容保存为 sandbox.yaml，执行kubectl apply -f sandbox.yaml进行资源创建：

   apiVersion: agents.kruise.io/v1alpha1
   kind: Sandbox
   metadata:
     name: sample
     namespace: default
   spec:
     template:
       metadata:
         labels:
           agent: sample
           alibabacloud.com/compute-class: agent-sandbox
         annotations:
           network.alibabacloud.com/network-policy-mode: enhanced-traffic-policy
       spec:
         containers:
         - name: sandbox
           image: registry.cn-hangzhou.aliyuncs.com/acs/curl:8.1.2
           command: ["/bin/sleep", "infinity"]

   关键配置说明

   • network.alibabacloud.com/network-policy-mode: 该注解用于定义 Sandbox 的网络治理能力。不同取值的区别请参考概述。

   • spec.template.metadata.labels: Pod 的标签，用于被 SecurityProfile 的 selector 选中以应用安全策略。

2. 执行以下命令确认 Sandbox 已正常运行：

   kubectl get sandbox sample -n default

   预期输出：

   NAME     STATUS    AGE
   sample   Running   2m

3. 执行以下命令确认 traffic-proxy Sidecar 已注入：

   kubectl get pod -l agent=sample -n default

   预期输出：

   NAME      READY   STATUS    RESTARTS   AGE
   sample    2/2     Running   0          2m

   READY状态2/2表示业务容器与 traffic-proxy Sidecar 均已就绪。

步骤二：验证默认放行行为

未配置 SecurityProfile 时，Sandbox 的所有出口流量默认放行。

1. 测试访问外部服务：

   kubectl exec sample -n default -c sandbox -- curl -s http://httpbin.org/get

   预期返回正常的HTTP 200响应：

   {
     "args": {},
     "headers": {
       "Host": "httpbin.org",
       "User-Agent": "curl/8.1.2"
     },
     "origin": "47.239.x.x",
     "url": "http://httpbin.org/get"
   }

2. 测试访问/admin路径：

   kubectl exec sample -n default -c sandbox -- curl -s -o /dev/null -w "%{http_code}" http://httpbin.org/admin

   预期返回 404（httpbin.org 自身返回的状态码，说明请求已到达目标服务，未被阻断）。

步骤三：创建 SecurityProfile 阻断规则

创建 SecurityProfile 阻止访问任何域名下的 /admin 前缀路径。完整示例及配置说明，请参考完整示例。

1. 将以下内容保存为 securityprofile.yaml，并执行kubectl apply -f securityprofile.yaml创建资源：

   apiVersion: agents.kruise.io/v1alpha1
   kind: SecurityProfile
   metadata:
     name: agent-profile
     namespace: default
   spec:
     selector:
       matchLabels:
         agent: sample
     rules:
     - name: deny-admin
       match:
       - domains:
         - "*"
         paths:
         - type: Prefix
           value: /admin
         methods:
         - GET
         - POST
         - PUT
         - DELETE
       actions:
         block:
           statusCode: 403
           body: '{"error":"admin path is blocked"}'

2. 查看 SecurityProfile 状态：

   kubectl get securityprofile -n default

   预期输出：

   NAME            AGE
   agent-profile   30s

步骤四：验证流量阻断效果

SecurityProfile 创建后规则立即生效。

• 测试 1：访问被阻断的 /admin 路径

  kubectl exec sample -n default -c sandbox -- curl -s http://httpbin.org/admin

  预期输出：

  {"error":"admin path is blocked"}

  验证状态码：

  kubectl exec sample -n default -c sandbox -- curl -s -o /dev/null -w "%{http_code}" http://httpbin.org/admin

  预期返回 403。

• 测试 2：/admin 子路径同样被阻断

  由于规则使用 Prefix 匹配，所有以 /admin 为前缀的路径均被阻断：

  kubectl exec sample -n default -c sandbox -- curl -s http://httpbin.org/admin/users

  预期输出：

  {"error":"admin path is blocked"}

• 测试 3：非 /admin 路径正常放行

  kubectl exec sample -n default -c sandbox -- curl -s -o /dev/null -w "%{http_code}" http://httpbin.org/get

  预期返回 200。

• 测试 4：未在 methods 列表中的方法不受影响

  kubectl exec sample -n default -c sandbox -- curl -s -o /dev/null -w "%{http_code}" -X OPTIONS http://httpbin.org/admin

  规则仅配置了 GET/POST/PUT/DELETE 方法，OPTIONS 不在限制范围内，请求被放行。

步骤五：更新 SecurityProfile（可选）

可随时更新 SecurityProfile 规则，变更实时生效。以下示例新增一条阻断特定域名访问的规则：

apiVersion: agents.kruise.io/v1alpha1
kind: SecurityProfile
metadata:
  name: agent-profile
  namespace: default
spec:
  selector:
    matchLabels:
      agent: sample
  rules:
  - name: deny-admin
    match:
    - domains:
      - "*"
      paths:
      - type: Prefix
        value: /admin
      methods:
      - GET
      - POST
      - PUT
      - DELETE
    actions:
      block:
        statusCode: 403
        body: '{"error":"admin path is blocked"}'
  - name: deny-internal-service
    match:
    - domains:
      - "*.internal.company.com"  # 阻断的域名，支持通配
    actions:
      block:
        statusCode: 403                                               # 自定义响应状态
        body: '{"error":"access to internal services is forbidden"}'  # 自定义响应提示

步骤六：删除 SecurityProfile 配置（可选）

kubectl delete securityprofile agent-profile -n default

场景一：阻断管理后台路径访问

阻止 Agent 访问任何域名下的管理后台路径（/admin、/console、/dashboard）。

rules:
- name: deny-management-paths
  match:
  - domains: ["*"]
    paths:
    - type: Prefix
      value: /admin
    - type: Prefix
      value: /console
    - type: Prefix
      value: /dashboard
    - type: Prefix
      value: /manage
  actions:
    block:
      statusCode: 403
      body: '{"error":"management paths are blocked"}'

场景二：阻断敏感域名和元数据服务访问

阻止访问内部服务域名和云平台元数据服务地址，防止 SSRF 攻击。

rules:
- name: deny-internal-and-metadata
  match:
  - domains:
    - "*.internal.company.com"
    - "*.corp.net"
    - "metadata.google.internal"
  actions:
    block:
      statusCode: 403
      body: '{"error":"access to internal services and metadata endpoints is forbidden"}'

场景三：只读模式（阻断写操作）

仅允许 GET/HEAD 请求，阻止所有数据修改操作，适用于只读型 Agent。

rules:
- name: read-only-mode
  match:
  - domains: ["*"]
    paths:
    - type: Prefix
      value: /
    methods: ["POST", "PUT", "DELETE", "PATCH"]
  actions:
    block:
      statusCode: 405
      body: '{"error":"write operations are not allowed in read-only mode"}'

场景四：精确阻断特定 API 端点

使用 Exact 类型精确匹配某个 API 路径，不影响同前缀下的其他接口。

rules:
- name: deny-user-deletion
  match:
  - domains: ["api.example.com"]
    paths:
    - type: Exact
      value: /api/v1/users/delete
    methods: ["POST", "DELETE"]
  actions:
    block:
      statusCode: 403
      body: '{"error":"user deletion API is not permitted"}'

场景五：基于正则表达式阻断动态路径

使用 Regex 匹配阻断符合特定模式的动态路径（如 /internal/v1/...、/internal/v2/...）。

rules:
- name: deny-internal-versioned-api
  match:
  - domains: ["*"]
    paths:
    - type: Regex
      value: "^/internal/v[0-9]+/.*"
  actions:
    block:
      statusCode: 403
      body: '{"error":"access to internal versioned APIs is blocked"}'

场景六：阻断携带特定请求头的流量

阻止 Agent 伪造管理员身份头访问外部服务。

rules:
- name: deny-admin-role-header
  match:
  - domains: ["*"]
    headers:
    - name: X-User-Role
      type: Exact
      value: admin
  actions:
    block:
      statusCode: 403
      body: '{"error":"requests with admin role header are not allowed"}'

场景七：组合多维度条件精细化阻断

同一 match 条目中的多个字段为逻辑与（AND）关系（必须同时满足），多个 match 条目为 OR 关系（满足任一即触发）。

rules:
- name: deny-json-upload
  match:
  - domains: ["storage.example.com"]
    paths:
    - type: Prefix
      value: /upload
    methods: ["POST", "PUT"]
    headers:
    - name: Content-Type
      type: Prefix
      value: "application/json"
  actions:
    block:
      statusCode: 403
      body: '{"error":"JSON upload to storage service is not allowed"}'

场景八：阻断非标准端口的访问

阻止通过非常规端口进行的规避安全审计或越权访问。

rules:
- name: deny-non-standard-ports
  match:
  - domains: ["*"]
    ports: [8080, 8443, 9090, 3000, 6379, 27017]
  actions:
    block:
      statusCode: 403
      body: '{"error":"access to non-standard ports is blocked"}'

完整示例

以下示例综合使用域名通配、路径前缀/精确/正则匹配、HTTP 方法过滤等多种匹配维度：

apiVersion: agents.kruise.io/v1alpha1
kind: SecurityProfile
metadata:
  name: comprehensive-profile
  namespace: default
spec:
  selector:
    matchLabels:
      app: ai-agent
  rules:
  # 阻断所有管理后台路径
  - name: deny-admin-paths
    match:
    - domains: ["*"]
      paths:
      - type: Prefix
        value: "/admin"
      - type: Prefix
        value: "/console"
      - type: Prefix
        value: "/dashboard"
      methods: ["GET", "POST", "PUT", "DELETE"]
    actions:
      block:
        statusCode: 403
        body: '{"error":"management paths are blocked"}'
  # 只读模式 - 阻断所有写操作
  - name: read-only-mode
    match:
    - domains: ["*"]
      paths:
      - type: Prefix
        value: "/"
      methods: ["POST", "PUT", "DELETE", "PATCH"]
    actions:
      block:
        statusCode: 405
        body: '{"error":"write operations are not allowed"}'
  # 正则匹配阻断内部版本化 API
  - name: deny-internal-api
    match:
    - domains: ["api.internal.com"]
      paths:
      - type: Regex
        value: "^/api/v[0-9]+/(users|tokens)/delete"
    actions:
      block:
        statusCode: 403
        body: '{"error":"deletion APIs are blocked"}'
  # 阻断非标准端口
  - name: deny-debug-ports
    match:
    - domains: ["*"]
      ports: [8080, 9090, 3000]
    actions:
      block:
        statusCode: 403
        body: '{"error":"non-standard port access is blocked"}'

SecurityProfileSpec

spec 定义应用于目标 Pod 出口流量的 L7 安全策略。

SecurityRule

规则链中的单条规则。采用 Default Continue 语义：执行完一条规则的动作后继续评估下一条，除非遇到终止性动作（如 Block）短路。

RuleMatch

单条匹配条件。同一 RuleMatch 内多个字段为逻辑与（AND）关系；多个 RuleMatch 条目为 OR 关系。

SecurityRuleActions

动作配置。当前版本仅开放 block 动作，其余动作类型后续支持。

组件日志

kubectl logs -l gateway.networking.k8s.io/gateway-name=egress-gateway -n sandbox-traffic-system -f

kubectl logs -l app=gateway-controller -n sandbox-traffic-system -f

监控指标

各组件暴露的 Prometheus 监控指标：

组件已预置 prometheus.io/scrape: "true" 注解。如集群已启用阿里云 Prometheus 监控或部署了社区版 Prometheus 且配置了注解服务发现规则，指标自动采集，无需额外配置。

默认组件规格

增强出口流量管理组件部署在 sandbox-traffic-system 命名空间中，默认规格如下：

egress-gateway 与 traffic-extension

两个组件的承载能力受底层计算资源的 CPU 和网络带宽限制，建议保持相同规格。

• 高 QPS 场景（小请求）

  单个 egress-gateway Pod（8C 8Gi 规格）的 QPS 承载能力：

  计算类型	单Pod可支撑 QPS
  ACS通用型（general-purpose）	约 10,000
  ACS性能型（performance）	约 25,000

  说明

  以上为实验室测试数据，阿里云不作为业务指标承诺，请以实际业务场景为准。建议在运行过程中关注业务侧是否存在丢包现象，或通过网关日志监测是否出现502状态码，以评估实际承载性能。

  限制说明：

  • 高 QPS 场景建议选择 ACS性能型Pod。

  • 受 Linux 临时端口范围限制（默认 32768-60999），单 Pod QPS 存在上限。如需更大流量，需通过 HPA 水平扩容增加副本数。

• 大文件传输场景（高带宽）

  egress-gateway 吞吐能力主要取决于底层计算资源网络带宽上限：

  计算类型	单Pod最大网络带宽（参考值）
  ACS通用型（8C 规格）	约 10.5 Gbps
  ACS性能型（8C 规格）	约 16 Gbps

  说明

  ACS Pod支持的最大网络带宽以ACS实例规格中列出的规格为准。

  限制说明：

  • 网络带宽接近上限时延迟显著增加，建议监控网络吞吐指标。

  • ACS可通过增加副本数将流量分散到多个 Pod。

  • 大文件传输场景建议为 egress-gateway 配置至少 8Gi 内存。

gateway-controller

资源需求取决于集群纳管的 Pod 规模：

如何调整 egress-gateway 或 traffic-extension 的资源规格？

请在业务低峰期操作。

1. 在目标集群详情页，左侧导航栏选择组件管理。

2. 在组件管理页搜索定位ack-sandbox-manager，单击配置。

3. 在组件配置页，调整enhancedTrafficManagement区块的egress-gateway 或 traffic-extension组件resources值（CPU 的requests和limits建议设置为相等值，确保 HPA 基于 CPU 利用率的扩缩容计算准确）。然后单击确认。