前言¶
DeepSeek Harness(DSH)里,智能体抓取网页通常走内置 WebFetch 或本机 HTTP provider。若本机使用 Clash、Mihomo 等工具的 TUN Fake-IP 模式,域名会被解析到 198.18.0.0/16 一类占位地址,再由代理栈接管真实连接。在已验证的 DSH 版本中,内置 SSRF 防护会把这类地址当作非公网地址拒绝,结果是:需要走代理才能访问的 URL,反而在本机 fetch 时被拦下。官方 POST /v1/tools/fetch 则在服务端出口执行,与本机代理、Fake-IP 无关。
下面介绍社区插件 dsh-fakeip-fetch(维护者 Hariketsu,分类:联网工具)。它在可配置的 Fake-IP 网段内选择性绕过上述限制,仍使用 DSH 的 HTTP 传输实现,便于在 Fake-IP 环境下继续用本机网络出口做抓取。
这是什么¶
dsh-fakeip-fetch 的定位是:DSH local HTTP fetch with TUN Fake-IP support(npm 包名 dsh-fakeip-fetch,当前版本 0.5.2,MIT 许可证)。它注册为 DSH 的 HTTP fetch provider,针对 TUN Fake-IP 场景;若代理使用 redir-host 模式,README 说明通常不需要本插件。
与 DeepSeek 官方 Fetch API 的对比如 README 表格所示:官方抓取在服务端、不受本机 Fake-IP SSRF 影响,但出口与可达站点取决于服务端网络;本插件让抓取留在本机、走本机网络,并在你声明的 Fake-IP 网段内避免被误杀。
核心功能¶
选择性绕过 Fake-IP 相关的 SSRF 拦截¶
插件只应填写实际使用的 Fake-IP 网段(默认 198.18.0.0/16)。不要填写私网、回环或 0.0.0.0/0、::/0 等宽泛网段:插件无法验证最终连接的地址。
保留 DSH 传输层行为¶
仍使用 DSH 的 HTTP 传输实现,TLS、同源重定向、超时和响应大小等限制与宿主一致。跨源重定向仍受 DSH 限制,需要直接请求目标 URL。
设置页与自检¶
插件提供 Web 设置界面,可配置 Fake-IP 网段,以及超时、响应大小、重定向次数、User-Agent 等传输项。支持「探测本机 DNS」和「自检」。首次启动或插件与宿主版本变化时,自检会查询 en.wikipedia.org 的 DNS,并尝试抓取 https://example.com;结果保存在 DSH 本机存储中。
兼容性说明¶
地址解析器相关参数依赖 DSH 内部实现,并非公开插件 API。README 写明目前已在 DSH Desktop 0.2.1-rc.3 上测试,其他版本或构建尚未验证。自检若显示 resolver=unsupported,表示当前构建不支持插件使用的解析器参数,会回退为普通 HTTP 抓取,但无法正确处理 Fake-IP 地址。
安装与启用¶
从 npm 安装¶
在 DSH Desktop 的「插件」页面点击「添加插件」,输入 dsh-fakeip-fetch 并安装。
也可使用 CLI 安装到指定 profile:
dsh plugin --profile <profile> add dsh-fakeip-fetch --ignore-scripts --config.auto-install-peers=false
运行环境需满足 Node.js 24.9+(见 package.json engines)。
从本地包安装¶
在项目目录执行 npm pack,在 DSH「添加插件」中填入生成的 .tgz 路径,例如:
/path/to/dsh-fakeip-fetch-<version>.tgz
CLI 示例:
dsh plugin --profile <profile> add /path/to/dsh-fakeip-fetch-<version>.tgz \
--ignore-scripts --config.auto-install-peers=false --store-dir <store>
配置和自检¶
- 打开插件设置,确认 Fake-IP 网段与 Clash/Mihomo 等实际配置一致。
- 使用「探测本机 DNS」查看当前解析结果。
- 查看「自检」结果;必要时在设置页手动触发 DNS 探测与重新自检。
- 默认值:
198.18.0.0/16。
卸载插件后,内置 HTTP provider 会恢复。
典型用法与常见问题¶
本插件不单独提供「调用示例脚本」;用法是安装并配置后,让 DSH 智能体在本机继续使用 HTTP fetch(例如 WebFetch 走本机 provider 的场景)。配置步骤即「安装 → 对齐 Fake-IP 网段 → DNS 探测 → 自检通过」。
常见问题(摘自 README):
cannot register the "http" fetch provider:当前 profile 中已有其他插件注册了httpprovider。检查是否仍安装dsh-local-fetch,卸载后重启。- 地址不在配置的 Fake-IP 网段中:核对网段与设置页「探测本机 DNS」结果。
- 自检
resolver=unsupported:升级或更换已验证的 DSH 构建,或接受无法处理 Fake-IP 的回退行为。
适用场景与注意¶
适合谁:在本机使用 TUN Fake-IP 代理、且希望 DSH 在本机网络下抓取网页(而非完全依赖官方服务端 Fetch)的开发者。
安全与权限:插件以当前 DSH 进程权限运行,安装前应阅读 GitHub 仓库 源码与 MIT 许可证,并仅配置真实 Fake-IP 网段。README 强调本项目由社区维护,与 DeepSeek 官方无关;SkillHub 等社区目录为独立站点,并非 DeepSeek 官方应用商店。
与官方 Fetch 的取舍:若只需服务端可达的站点、且不依赖本机代理,官方 Fetch 仍可选;若出口必须与本机代理一致,且受 Fake-IP SSRF 影响,再考虑本插件。
结尾¶
dsh-fakeip-fetch 解决的是 TUN Fake-IP 与 DSH 本机 SSRF 策略冲突这一具体环境问题,通过可配置网段和自检,把本机 HTTP 抓取拉回可用状态。
- 社区目录页:https://www.skillhub.cn/plugins/Hariketsu/dsh-fakeip-fetch
- 源码与文档:https://github.com/Hariketsu/dsh-fakeip-fetch