适用场景

在 Codex 里配置了一个定时任务，希望它每天自动生成内容，并调用线上接口完成发布。但任务执行时发现：手动运行脚本可以访问线上接口，定时任务运行时却被沙箱拦截，表现为无法访问目标域名或提示网络权限不足。

这个问题很容易误判成“没有互联网权限”，但实际根因往往不是互联网不可用，而是定时任务使用的命令没有命中已授权的命令前缀。

现象描述

手动在当前会话中执行脚本时，可以正常访问线上接口：

.\.venv\Scripts\python.exe .\publish_blog.py summary

输出正常，能查询到分类、标签和最近文章。

但同样的逻辑放到定时任务里执行时，任务失败，表现为：

  • 请求线上接口被沙箱阻止；
  • 任务无法访问目标站点；
  • 手动执行可以，自动执行不行；
  • 依赖安装、临时 HTTP 请求、验证请求容易失败；
  • 看起来像是“定时任务没有网络权限”。

可能原因

1. 定时任务是无人值守执行

普通对话里，如果某个命令需要访问外网，可以临时确认授权。但定时任务运行时没有人在旁边点确认，所以它必须使用已经预授权的命令。

如果任务里出现新的公网访问方式，比如：

curl https://example.com
Invoke-WebRequest https://example.com
python temp_request.py
pip install -r requirements.txt

这些命令如果没有提前授权，就可能被沙箱拦截。

2. 命令前缀必须精确匹配

沙箱放行通常不是按“这个脚本大概差不多”判断，而是按命令前缀匹配。

例如已经授权的是：

.\.venv\Scripts\python.exe .\publish_blog.py

但定时任务里写成：

.venv\Scripts\python.exe .\publish_blog.py

少了前面的 .\，看起来只是路径写法不同，但对沙箱来说可能就是不同命令，无法命中授权规则。

同样，下面这些也可能不匹配：

E:\project\.venv\Scripts\python.exe .\publish_blog.py
python .\publish_blog.py
.\.venv\Scripts\python.exe .\other_script.py

3. 定时任务里混入了未授权的联网命令

有些自动化任务会先执行：

pip install -r requirements.txt

或者发布后再用：

Invoke-WebRequest https://example.com/post/xxx.html

这些命令都可能触发新的网络访问权限。即使发布脚本本身已经授权，额外的联网命令仍然会失败。

排查思路

1. 先确认手动命令是否能跑通

在项目目录中手动运行：

.\.venv\Scripts\python.exe .\publish_blog.py summary

如果能正常输出分类、标签、最近文章，说明：

  • 脚本逻辑正常；
  • 账号密码正常；
  • 依赖正常；
  • 线上接口正常；
  • 当前命令形式已经可以访问目标接口。

2. 对比定时任务里的命令写法

重点看定时任务提示词或执行脚本里的命令是否和已授权命令完全一致。

推荐固定为：

.\.venv\Scripts\python.exe .\publish_blog.py summary

发布时也保持同一个前缀：

.\.venv\Scripts\python.exe .\publish_blog.py publish --title "文章标题" --content-file ".\posts\article.md" --category "系统运维" --tags "系统运维,Linux,排查"

不要在任务里混用绝对路径、不同 Python、不同脚本名或临时脚本。

3. 去掉定时任务里的依赖安装

依赖安装应该在人工准备阶段完成：

.\.venv\Scripts\python.exe -m pip install -r requirements.txt

定时任务里不要每天执行 pip install，因为它会访问包索引，很容易被网络沙箱拦截。

4. 验证也使用同一个发布脚本

发布后不要再用额外 HTTP 命令验证，例如：

Invoke-WebRequest https://example.com/post/xxx.html

可以改成再次运行：

.\.venv\Scripts\python.exe .\publish_blog.py summary

只要新文章出现在最近文章列表中，就能证明发布成功。

常用命令

查询线上博客状态

.\.venv\Scripts\python.exe .\publish_blog.py summary

发布 Markdown 文章

.\.venv\Scripts\python.exe .\publish_blog.py publish --title "文章标题" --content-file ".\posts\article.md" --category "系统运维" --tags "系统运维,Linux,排查"

查看脚本帮助

.\.venv\Scripts\python.exe .\publish_blog.py --help

查看发布命令帮助

.\.venv\Scripts\python.exe .\publish_blog.py publish --help

定位示例

某个定时任务失败，最初判断是“无法访问线上域名”。但手动执行：

.\.venv\Scripts\python.exe .\publish_blog.py summary

可以成功。

继续检查定时任务提示词，发现任务里写的是：

.venv\Scripts\python.exe .\publish_blog.py summary

和已授权命令相比，少了前面的 .\。

修正为：

.\.venv\Scripts\python.exe .\publish_blog.py summary

再次运行后，访问线上接口成功。

这个案例说明：定时任务网络访问失败时，不要只看目标域名，也要检查命令前缀是否精确命中授权规则。

修复方案

1. 固定唯一入口脚本

把所有线上接口访问都收敛到一个脚本里，例如：

.\.venv\Scripts\python.exe .\publish_blog.py

不要在定时任务中临时拼接新的 HTTP 请求命令。

2. 定时任务只使用已授权前缀

任务提示词中明确要求：

.\.venv\Scripts\python.exe .\publish_blog.py summary
.\.venv\Scripts\python.exe .\publish_blog.py publish ...

不要改成绝对路径，也不要省略 .\。

3. 依赖提前安装

人工阶段执行一次：

.\.venv\Scripts\python.exe -m pip install -r requirements.txt

定时任务里只运行已安装好的脚本。

4. 发布和验证都走同一个脚本

发布：

.\.venv\Scripts\python.exe .\publish_blog.py publish --title "标题" --content-file ".\posts\a.md" --category "系统运维" --tags "系统运维,Linux,排查"

验证：

.\.venv\Scripts\python.exe .\publish_blog.py summary

这样可以减少额外授权点。

预防措施

  1. 定时任务中不要使用临时联网命令。
  2. 所有外部接口访问都封装到固定脚本。
  3. 手动跑通后，把同一条命令原样写入定时任务。
  4. 不要混用相对路径、绝对路径、不同 Python 解释器。
  5. 不要在无人值守任务里执行 pip install。
  6. 定时任务提示词里明确写出“只能使用已授权命令前缀”。
  7. 任务失败时，先对比命令前缀，再排查网络、域名和接口。

总结

Codex 定时任务访问线上接口被沙箱拦截时，根因不一定是目标站点不可达，也不一定是脚本有问题。很多时候只是因为定时任务里使用的命令没有命中已授权前缀。

排查时可以按这个顺序：

  1. 手动运行固定脚本，确认接口可访问；
  2. 对比定时任务命令是否和已授权命令完全一致；
  3. 删除任务里的 pip install、curl、Invoke-WebRequest 等额外公网命令；
  4. 发布和验证都走同一个已授权脚本；
  5. 让定时任务只做稳定、可重复、已授权的动作。

一句话总结：定时任务里访问线上接口，最好只有一个入口脚本，一条固定命令，一个已授权前缀。