欢迎光临

OpenShell 里的 Agent 连不上 API,怎么从日志找到被拦的请求?

同事在笔记本上能调通 API,Agent 放进沙箱后却只说“访问失败”。这时最有用的信息是:哪个进程,想连哪个主机和端口,请求走到了哪一步。下面用无需密钥的 GitHub /zen 接口做一次可回退的实验。每次只改变一条规则,前后使用同一条请求。

先排除镜像和上游服务的问题

示例基于 OpenShell v0.1.9、可连接的本地 Docker gateway,以及一个装有 CA 证书和 /usr/bin/curl 的普通用户镜像。在一个空目录放入配套 Dockerfile,构建 api 阶段。若 gateway 在远端,把镜像推到它能拉取的仓库,并在创建命令中使用相应镜像引用。下载实验 Dockerfile · OpenShell 安装说明

docker build --target api -t tbr8-api:20261121 .
docker run --rm tbr8-api:20261121 /usr/bin/curl -sS --max-time 10 \
  -o /dev/null -w 'HTTP=%{http_code}\n' https://api.github.com/zen

本地这一步得到 HTTP=200。它只回答“这个镜像在普通 Docker 网络里能否访问上游”。如果这一步已经证书报错或超时,先处理宿主机网络、组织代理或证书信任,再做策略实验。

用同一镜像在普通 Docker 网络中访问公开接口,确认 curl 位于 /usr/bin/curl,且上游可返回 200。
用同一镜像在普通 Docker 网络中访问公开接口,确认 curl 位于 /usr/bin/curl,且上游可返回 200。

在沙箱尝试一次,在宿主机找同一次请求

终端 A 从宿主机创建一次性沙箱。--no-auto-providers 跳过自动接入 provider;实验使用公开接口。保留打开的交互式 shell,另开终端 B 观察同一个沙箱。初始策略应没有允许此目标的网络规则。镜像自带策略、宿主机环境变量或全局策略都可能改变起点。

openshell sandbox create --name api-check --from tbr8-api:20261121 \
  --no-auto-providers

在 A 的沙箱提示符运行一次:

/usr/bin/curl -sS --max-time 10 -o /dev/null -w 'HTTP=%{http_code}\n' \
  https://api.github.com/zen

在 B 的宿主机提示符查最近五分钟,核对目标、可执行文件、时间和拒绝原因:

openshell policy get api-check --full
openshell logs api-check --since 5m --source sandbox

首次连接若在代理的 CONNECT 阶段被拒,curl 可能在标准错误显示代理 403,同时 http_code 打印 000。前者来自代理握手,后者表示没有收到目标 API 的 HTTP 响应。官方示例中,连接拒绝事件带有 NET:OPEN、DENIED、调用进程和目标地址。只筛 warning 可能漏掉策略记录。官方拒绝日志及字段示例

只给已确认的调用者增加读取权限

假设日志显示 /usr/bin/curl 要访问 api.github.com:443。在终端 B 加一条仅适用于这个程序、这个目标的只读 REST 规则。enforce 表示真正拦截不匹配的方法,--wait 等待策略版本被处理。然后检查已加载的版本。

openshell policy update api-check --rule-name article_github_read \
  --binary /usr/bin/curl \
  --add-endpoint api.github.com:443:read-only:rest:enforce --wait
openshell policy list api-check

回到 A,重跑完全相同的 GET。再分别做两个对照:访问另一个未授权域名,以及对同一公开只读路径发一个没有凭据、没有请求体的 POST。两个对照都应能在 B 的日志中找到对应记录。

/usr/bin/curl -sS --max-time 10 -o /dev/null https://example.org/
/usr/bin/curl -sS -i --max-time 10 -X POST https://api.github.com/zen
请求预期及判读
GET api.github.com/zen成功时收到 200。说明这条读取路径已走通。
GET example.org目标未被授权,应在连接阶段拒绝。若成功,重查完整生效策略。
POST api.github.com/zen预期由沙箱的 HTTP 方法规则拒绝;用同时间的日志确认方法与策略名。只有上游返回 404 或 405,还不足以证明规则生效。
OpenShell v0.1.9 独立网络代理实测。上半部分在建立连接时拒绝访问;下半部分按只读规则允许 GET,并对 POST 返回 403。两行 DENIED 均取自本轮代理日志。
OpenShell v0.1.9 独立网络代理实测。上半部分在建立连接时拒绝访问;下半部分按只读规则允许 GET,并对 POST 返回 403。两行 DENIED 均取自本轮代理日志。
这张图怎么复验?

两个一次性容器分别运行同一个 supervisor 的独立网络代理模式,curl 显式指定该代理和它启动时生成的 CA。每个容器加载一份策略。这项实验验证连接和 HTTP 方法的规则;本文前面通过 gateway 热更新策略和按进程匹配的流程,需要在完整沙箱中另行验证。

将探针脚本、默认拒绝策略和只读策略放在同一个 lab 目录。从 NVIDIA v0.1.9 发布页取与实验镜像架构相符的 Linux supervisor,核对发布摘要后解压到该目录,文件名为 openshell-supervisor。将同版本官方规则保存为 policy.rego。在 lab 的上级目录运行截图中的两条命令;Linux 宿主机上需先确保 supervisor 文件具有执行权限。两次运行均只读挂载 lab,实验容器退出时自动移除。

为什么 curl 通了,Agent 仍然失败?

在真实 Agent 上再跑一次失败的业务动作,回看新日志。调用者可能是 node 或 python,模型接口也可能需要 POST。给 curl 的读取权限只验证了这一条路径。先查明实际进程、目标、业务所需的方法与路径;模型调用涉及密钥时,按对应 provider 的凭据和端点配置处理。对通用解释器放行会影响该解释器下的其他代码,范围要随之收紧。网络规则与调用程序匹配

日志中没有匹配的拒绝时,先核对沙箱名称、时间窗和策略版本。若已收到上游响应,再按上游身份认证、请求路径、限流或服务故障排查。即便同为 HTTP 403,也应有相应的沙箱拒绝事件才能把故障归到 OpenShell。

验证完后,在 B 撤销本次新增的规则,回到 A 重跑第一次 GET,确认初始行为恢复。这是检查“究竟是哪次改动起了作用”的最后一步。

openshell policy update api-check --remove-rule article_github_read --wait
【本站文章皆为原创,未经允许不得转载】:汤不热吧 » OpenShell 里的 Agent 连不上 API,怎么从日志找到被拦的请求?
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址