dsh-port-map
在终端中运行以下命令:
dsh plugin install ozanstn1-stack/dsh-port-map
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install ozanstn1-stack/dsh-port-map 即可从 https://github.com/ozanstn1-stack/dsh-port-map 安装该只读端口与服务映射插件。
插件介绍
在一台同时跑着 systemd 服务、Docker 容器和 Caddy 反向代理的机器上,「9094 上到底是什么」「这条路由还指活着的上游吗」「哪些端口是对公网开放的」这类问题往往要来回查 ss、unit 和配置文件。dsh-port-map 把这些线索收成一张只读地图:它只报告现状,不会改防火墙、不会重启服务,适合你在排查暴露面或核对路由时快速建立上下文。
核心能力围绕四类只读工具展开。listening_ports 列出 TCP 监听套接字,包含端口、绑定地址、可达范围(公网/本机/网卡)、进程,以及对应的 systemd 单元或 Docker 容器,可按范围与端口过滤。service_map 提供反向视图:每个单元/容器及其监听端口,并标出无人认领的端口。caddy_routes 解析 Caddyfile,得到站点→路径→reverse_proxy 上游,再与当前监听套接字对照。url_check 对配置白名单内的主机做 HTTP 探测,返回状态码、延迟与 Content-Type;遇到重定向只报告不跟随。
归属解析尽量有据可查:先用 ss 拿到套接字与 PID,再通过 cgroup 关联 systemd 单元;docker-proxy 则通过已发布端口映射到容器名,而不是笼统写成 docker.service。未认领的套接字会如实标为 unowned,不做猜测。
适合 DeepSeek Harness 管理员、自建节点运维,以及任何需要在不动生产配置的前提下核对端口、服务与 Caddy 路由是否一致的人。若你的 Caddy 配置大量依赖 import、!!js 或未建模指令,或依赖 url_check 解析完整重定向链,需要知晓插件文档中列出的诚实边界。
使用场景
- 怀疑某端口被意外暴露,需要快速区分公网、本机与网卡绑定范围
- Caddy 改过后想确认 reverse_proxy 上游是否仍在监听
- Docker 与 systemd 混跑,要查清某个监听口对应哪个单元或容器
适合人员
- DeepSeek Harness 节点管理员
- 负责反向代理与暴露面自查的运维
- 不想动配置、只想看清现状的自建服务维护者