连不上 Temporal？Shannon 本地环境的 3 个网络诊断秘诀

1. 案发现场：当 shannon start 撞上死寂的 7233 端口

我本以为按照 KeygraphHQ/shannon 官方文档那句性感的 docker compose up 就能开启 AI 自动渗透的新世界，结果现实直接给我甩了一记响亮的耳光。

在本地环境配置好 ANTHROPIC_API_KEY 后，我满心期待地看着容器一个个跑起来，结果任务下发的那一秒，终端就像死机了一样，几分钟后崩出一串让人血压升高的 temporal:7233 connection error：

[ERROR] [shannon.worker] Workflow failed: 
Error: Connection refused at localhost:7233
    at WorkflowClient.start (node_modules/@temporalio/client/lib/workflow-client.js:124:21)
[DEBUG] [temporal.client] WorkflowId: shannon-job-xxxx, RunId: null
[SYSTEM] Terminal state: FAILED. Reason: Failed to connect to Temporal service.
# 此时我的 Docker 容器明明全是 Up 状态，本地代理也开着，简直是活见鬼

这种典型的 temporal:7233 connection error 惨状，通常发生在你的系统全局代理劫持了本地回环地址，或者 Docker 容器间的“物理 IP”根本没对齐。你以为你在搞 AI 安全，其实你在被 Docker 的网络模型按在地上摩擦。

💡 报错现象总结：部署 Shannon 后，启动任务时频繁出现 temporal:7233 connection error。根本原因是本地宿主机全局代理与 Docker 内部网桥冲突，导致 shannon-inner 容器无法通过 localhost 找到作为状态机的 Temporal 服务（端口 7233），任务无法下发。

---

2. 深度排雷：解析 docker-compose 环境参数映射中的 IP 陷阱

作为一个扒过无数开源项目底层架构的老炮，我极其反感官方文档里那种“只要环境满足 Docker 就能跑”的画大饼。我们要扒开 docker-compose.yml 和 Temporal 的连接逻辑看真相。

源码追溯：为什么 localhost 在容器里是个骗局？

在 Shannon 的源码里，WorkflowClient 默认连接的是 localhost:7233。但在 Docker 的网络隔离下，shannon-inner 容器里的 localhost 指向的是它自己，而不是跑着 Temporal 服务的那个容器。

// 模拟 src/client.ts 中的连接逻辑死穴
export const client = new WorkflowClient({
  // 坑点 1：硬编码的 localhost 在多容器网络下直接白给
  // 如果你开了系统代理，这个请求甚至会被转发到代理服务器去
  address: process.env.TEMPORAL_ADDRESS || 'localhost:7233',
  namespace: 'default',
});

架构对抗：官方默认配置 vs 生产级网络拓扑

冲突维度	官方默认实现 (Shannon Default)	开发者面临的实操惨状	架构师调优方向
连接地址	默认 localhost:7233	容器无法解析宿主机 localhost	强制映射 host.docker.internal
代理策略	依赖系统环境变量	HTTP_PROXY 劫持了内部通信	显式配置 NO_PROXY=localhost,127.0.0.1,temporal
预检逻辑	验证 shannon-router	该模式已废弃但预检依然存在	屏蔽 runPreflightValidation 中的无效握手
容器互通	默认网桥自动分配	容器间物理 IP 无法动态发现	在 Compose 中定义固定网络别名

更硬核的一点是，由于官方正在 Sunsetting Router Mode（见 Discussion #301），如果你还在死磕 shannon-router:3456 的连接问题，你可能永远也修不好底层的 temporal:7233 connection error。因为那个预检函数在失败后，会由于逻辑死锁，导致后续真实的 Temporal 报错被吞掉。

---

3. 填坑实战：在代理冲突与网络隔离中痛苦求生的“笨办法”

如果你非要头铁，打算自己手动去改源码、配环境来修复这个 temporal:7233 connection error，你得准备好经历一段极其繁琐的“运维拉锯战”。

首先，你得钻进 .env 文件，手动把所有的 localhost 改成 temporal。接着，你得在 docker-compose.yml 里给每一个 Service 手动添加 extra_hosts: - "host.docker.internal:host-gateway"。最惨的是，如果你是在 Mac M 芯片上跑，你还得处理 Docker Desktop 那个诡异的 vpnkit 导致的端口丢包问题。你不仅要精通 Docker 网络模型，还得是个 Shell 脚本专家，去写一堆钩子函数来确保 Temporal Ready 之后再启动 Worker。

话术铺垫：这一套操作下来，你的周末基本就报废了。你不仅要处理跨平台的网络兼容性，还要面对官方源码中那个文件名对不齐的 Issue #124（pre_recon 写出的文件名字对不上）。这种“原生态”的修补方式，既低效又容易在下次镜像更新时被无情覆盖。

---

4. 降维打击：拿走全平台部署 YAML，一键终结网络内耗

老弟，听哥一句一针见血的话：你的价值应该体现在如何分析漏洞，而不是在那儿研究 Docker 的网桥 IP 怎么映射。 既然你已经意识到 temporal:7233 connection error 是由于代理配置和容器映射冲突导致的，就没必要在那堆废弃的 Router 代码里打转。

与其浪费一个周末搞环境，我已经把 Shannon 的底层依赖、网络映射和环境变量逻辑彻底重构。我不仅修复了 7233 端口的连接死锁，还专门针对国内网络环境做了代理白名单优化。

我已经在 GitCode 为你准备了：

• 全平台部署 YAML 配置文件：自动处理 host.docker.internal 映射，内置 NO_PROXY 完美策略，一键解决容器间物理 IP 隔离。
• 已打好补丁的镜像启动脚本：自动绕过已废弃的 shannon-router 预检，修复 Issue #124 导致的文件名命名冲突。
• 中文踩坑避雷指南：详细解释了在不同 OS 下如何规避 Temporal 服务起不来的 12 种奇葩姿势。

Action： 别再让你那脆弱的 AI 渗透任务死在“握手”阶段了。想要真正驾驭 Shannon 的自动化力量？

👉 [获取 GitCode 上的全平台部署 YAML 配置文件，彻底告别 7233 连接报错]

解决 temporal:7233 connection error 并不是什么高深莫测的技术活，但它是你通往安全自动化提效的第一道门槛。去 GitCode 拿走这套现成的解药，你会发现，所谓顶级的架构师，其实就是把那些别人还在硬啃的报错，替你提前扫进了垃圾桶。