5173 的两个身份
5173 常见两种用途：前端构建工具 Vite 的开发服务器默认监听 5173，且默认只绑本机地址；Apache DolphinScheduler 新版 Web UI 也把 5173 作为默认端口。开发阶段的 5173 基本是前端工程，生产环境出现则多半是调度平台的控制台。两者共用端口号纯属巧合，排查时先看进程与页面特征再定性。
基本信息
| 服务 | Vite 开发服务器，或 DolphinScheduler Web UI |
|---|---|
| 端口/协议 | TCP HTTP 5173，开发服务器默认仅监听回环 |
| 关键开关 | 加 --host 会把监听范围扩展到局域网 |
| 相关端口 | 4173 为预览服务器默认端口，24678 为热更新备用端口 |
| 权限要求 | 开发者启停无需特权；容器映射需宿主机配置 |
| 安全等级 | 仅开发机与内网，禁止对外暴露 |
典型使用场景
- 前端本地开发：改代码即时热更新，浏览器访问本机 5173
- 局域网真机调试：加 --host 后用手机访问同网段地址
- 容器开发：把端口映射出来在宿主机浏览器查看效果
- 接口联调：开发服务器代理转发到后端，规避跨域问题
- 调度平台运维：访问 DolphinScheduler 的 Web 控制台
启动与监听核对
启动与监听核对
npm run dev # 启动后控制台会打印 Local 与 Network 地址
# VITE ready in 300 ms
# Local: http://localhost:5173/
npx vite --host 0.0.0.0 --port 5173 # 显式暴露到局域网，谨慎使用
ss -lntp | grep 5173 # 确认监听地址是回环还是全网卡
curl -sI http://127.0.0.1:5173/ | head -3 # 本机可达性监听范围与风险
| 监听地址 | 可见范围 | 风险 |
|---|---|---|
| 127.0.0.1 | 仅本机 | 低，默认状态 |
| 局域网地址 | 同网段设备 | 源码与依赖可被浏览，热更新通道暴露 |
| 0.0.0.0 | 所有可达网络 | 配合端口映射等于对外公开，风险高 |
实践要点
- 给别人看效果要用构建产物加静态服务器，别长期挂开发服务器
- 容器开发固定端口映射范围，避免把开发机整体暴露
- 开发服务器日志会打印本机路径与环境变量名，同样属于信息泄露
- 团队统一开发端口约定，减少端口冲突带来的排查成本
- 发现 5173 先从进程与页面特征判断是 Vite 还是调度平台
Vite 的开发服务器与热更新通道不是为生产设计的，没有鉴权也没有限流，源码与 source map 可直接读取。需要团队共享时应使用构建产物或加认证的反向代理。
在云主机或容器里以全网卡地址启动开发服务器并映射端口，是源码泄露的常见原因；开发服务器的访问日志还会暴露内部路径信息。