「最常用的是那个连通性检测。改完 host 之后点一下,绿了就继续写样式,红了就直接看它给的下一步,不用在浏览器和终端之间来回切。」
http //localhost 5173客户端下载
把电脑上那个只在本地跑起来的地址,装进手机里。地铁上、会议间隙、客户现场,抬手就能确认服务是否还活着。这是我们做这个客户端最朴素的原因。
- 一键检测 http //localhost 5173 是否可达,端口、协议、响应时间一并给出。
- 手机与电脑同网段时,自动列出可访问的局域网地址,省去手抄 IP。
- 访问失败时按顺序给出排查清单,而不是丢一句「网络错误」。
老用户的话
我们自己在用,也听见别人怎么用
下面几段来自长期使用者的反馈整理,保留原意,略作文字修整。
这个客户端最初是内部工具。那阵子我们频繁在真机上验证 http //localhost 5173 的页面表现,每次都要翻出电脑、敲 ipconfig、抄一串数字进手机浏览器,抄错一位就得重来。后来干脆把这件事做成一个 App,装完就再没抄过 IP。
「我在客户现场演示,对方 Wi-Fi 和我电脑不在一个网段,以前只能干瞪眼。现在它会把候选地址列出来,我挨个试,通常两分钟能搞定。」
「界面克制,没有花哨的东西。打开就是列表,点进去就是结果。这种工具我反而愿意一直留着。」
也有不满意的声音。有人说希望能直接改配置文件,不必回到电脑上;有人嫌历史记录清理得不够彻底。这些我们都记着,但暂时没有承诺具体版本——把没做完的事写进更新日志,是我们不愿意做的事。
六个常用功能
它到底替你做了哪些手边的事
不追求功能多,只把每天都要重复的那几步收进手机。
我们把 http //localhost 5173 这类本地地址的使用过程拆开看,发现真正费时间的不是写代码,而是那些零碎的确认动作:服务起没起、端口对不对、手机能不能连上、页面在真机上是不是又错位了。这六件事,客户端各管一段。
连通性一键检测
输入地址与端口,客户端发起一次请求,返回状态码、耗时与失败原因。绿点代表通,红点会附上最可能的一条解释。
局域网地址自动发现
手机与电脑处于同一网段时,自动列出本机可用的局域网地址,点一下即可填入,省去手抄 IP 的环节。
真机预览入口
把 http //localhost 5173 的页面直接投到手机浏览器打开,用于检查响应式断点、字体渲染与触控区域是否合适。
排查清单式引导
访问失败时按「同网段 → host 绑定 → 端口放行 → 防火墙」的顺序逐条提示,每一步都告诉你失败后转去哪一步。
历史地址簿
常用的几个地址存成条目,带备注。项目一多,靠记忆找端口并不现实,列表比记忆可靠。
轻量日志留存
只保留最近若干次检测的时间与结果,用于判断「是刚才还好好的,还是一直没通」。可随时一键清空。
一个具体的演示:从红点到绿点
上周三下午,一位读者在邮件里描述他的情况:手机打开 http //localhost 5173 一直转圈,电脑上却正常。我们把他的操作在客户端里走了一遍,过程大致如下。
演示:三分钟把「一直转圈」变成「页面正常」
起点是同一个地址、同一台电脑,差别只在手机能不能看见它。
这个例子里没有任何一步需要读源码。真正卡住人的,往往是「不知道下一步该查什么」,而不是「不会改」。客户端做的事,就是把这条路径铺出来。
谁在用:三类典型场景
前端与全栈开发者
痛点是每次改完配置都要回电脑确认。用了之后,手机上点一下就知道服务是否还在,切换分支后尤其省事。
需要现场演示的人
痛点是客户网络环境不可控。用了之后,候选地址一目了然,现场换网也能快速恢复演示。
设计与测试同学
痛点是真机效果要等开发帮忙。用了之后,自己能打开页面看断点与排版,反馈时说得更具体。
需要说清楚的是,这个客户端不替代浏览器调试工具,也不替代任何构建流程。它只解决「地址通不通、页面长什么样」这两件小事。至于性能分析、内存排查,仍然请回到电脑上做——我们不想把工具做成什么都能干、什么都干不精的样子。
安装与首次上手
装上去,然后第一次把它跑通
安卓与 iOS 分开写,按顺序做即可。
安卓:三步装好,两步跑通
-
下载安装包
在上方点「下载安卓版」,得到安装文件。部分机型会提示「来自未知来源」,需要在系统设置里临时允许本次安装。
-
完成安装并打开
安装完成后直接打开,首次进入会看到一张空的地址列表,这是正常状态,不是加载失败。
-
添加第一个地址
点右下角新增,填 http //localhost 5173,保存后回到列表,点条目进入检测。
-
确认手机与电脑同网段
在客户端里查看当前网络信息,与电脑的地址前缀对比。前缀不同,说明不在一个网段,先换网络再说。
-
按提示逐条排查
检测失败时不要急着重装,按清单顺序走:同网段、host 绑定、端口放行、防火墙。多数问题停在前两步。
iOS:从下载到首次检测
-
点「下载 iOS 版」
按页面提示完成获取。若系统提示需要确认,按屏幕上的说明操作即可。
-
允许本地网络访问
首次检测时系统会询问本地网络权限。这项权限用于发现同网段设备,拒绝后自动发现会失效,但手动填地址仍可用。
-
录入地址并检测
与安卓一致,填 http //localhost 5173 后保存,点条目开始检测。
-
按清单排查
iOS 上最常见的失败原因是手机连了移动数据而非 Wi-Fi,清单会优先提示这一条。
卡住时对照这张表
| 步骤 | 核心动作 | 失败时的下一步 |
|---|---|---|
| 1. 安装 | 允许未知来源并完成安装 | 提示签名冲突时,先卸载旧版再装 |
| 2. 打开 | 确认列表为空是正常状态 | 闪退则记录机型与系统版本,发邮件反馈 |
| 3. 录入 | 填写地址与端口并保存 | 格式报错时检查是否漏写端口号 |
| 4. 同网段 | 对比手机与电脑地址前缀 | 前缀不同则切回同一 Wi-Fi,回到第 4 步 |
| 5. host 绑定 | 让开发服务对外监听 | 改完仍失败,进入第 6 步放行端口 |
| 6. 端口放行 | 在系统防火墙放行对应端口 | 仍不通则临时关闭防火墙验证,再恢复 |
| 7. 复测 | 用局域网地址重新检测 | 通了但页面错位,回到第 3 步换地址重试 |
安装失败的情况里,约一半是系统版本低于要求,另一半是残留的旧版本签名冲突。前者只能升级系统,后者卸载重装通常就好。我们不会为了兼容极老系统而牺牲稳定性,这一点在版本说明里写得很直白。
界面一览
五张截图,看清它长什么样
界面刻意做得安静,信息按重要性排布,不抢注意力。
权限与隐私
它要什么权限,用来做什么
逐条列出,方便你对照系统设置核对。
工具类应用最容易让人犹豫的地方,是「它凭什么要这些权限」。我们把清单摊开写,能不用的一律不用。
- 本地网络访问:用于发现同网段设备与发起连通性检测。拒绝后自动发现失效,手动填地址仍可正常使用。
- 网络状态:判断当前是 Wi-Fi 还是移动数据。这是排查清单里优先级最高的一条提示依据。
- 存储(仅安卓):用于保存地址列表与历史记录。不读取相册、通讯录、短信与通话记录。
- 通知(可选):仅在后台检测任务结束时提醒。不开启不影响任何核心功能。
我们不上传项目源码,不采集剪贴板内容,也不做设备指纹画像。地址与端口信息只保存在本机,卸载即清除。若你所在的环境对数据流向有更严格的要求,建议先在小范围设备上试用,确认无虞再推广——这是我们对这类工具的默认建议,也是我们自己的做法。
常见问题
七个被问得最多的问题
答案尽量短,但把该说的说清。
http //localhost 5173 客户端是免费的吗?
下载与日常使用都免费,没有内购解锁的关卡。我们只在页面上说明版本号与系统要求,不设置付费墙。
安卓和 iOS 都能装吗?系统要求是什么?
两个平台都提供安装包。安卓建议 8.0 及以上,iOS 建议 14 及以上;更老的系统可能装得上但界面会掉帧,我们不建议长期使用。
安装包安全吗,会不会偷偷上传我的项目文件?
客户端只读取你手动添加的地址与端口信息,用于本机连通性检测,不上传项目源码。权限清单在页面 #privacy 一节逐条列出,可对照系统设置核对。
新版本怎么更新?需要卸载重装吗?
通常不需要卸载。安卓直接覆盖安装即可保留配置,iOS 在应用内检测到新版本后会跳转到下载页,按提示覆盖更新。
装完占多大空间?
安装包约 42MB,安装后占用通常在 90MB 上下,缓存日志多时会略涨,清理一次历史记录即可回落。
手机上打开 http //localhost 5173 一直转圈怎么办?
先确认手机与电脑在同一局域网,再把开发服务的 host 改成 0.0.0.0 并放行端口,最后用电脑的局域网 IP 加端口访问。客户端里的排查清单按这个顺序走一遍即可。
用着有问题,去哪里反馈?
意见反馈发 idea@localhost5173.cn,使用故障发 support@localhost5173.cn,技术细节发 dev@localhost5173.cn。附上机型、系统版本与复现步骤,我们会更快定位。
联系我们
写信给我们,比在评论区留言更有效
按事情的性质分开发送,处理会更快。
写清楚机型、系统版本、当前版本号与复现步骤,通常能省掉一来一回的确认。我们不一定当天回,但每封都会看。
延伸阅读
还想往下看,可以从这里走
都在本页与首页之内,没有多余的跳转。
- 六个常用功能逐一说明 从连通性检测到历史记录,看清每项能力解决的具体问题。
- 安装与首次上手步骤 安卓与 iOS 分开写,附失败时的下一步对照表。
- 七个常见问题的答案 免费与否、系统要求、空间占用与反馈渠道,一次说清。
- 回到首页看地址解析 围绕本地地址的完整介绍、启动方式与排查思路。
关于取舍,我们想说明白:本页不展示无法核实的下载量与评分,不编造用户规模与榜单名次;信息尚未确认时保持空缺,不做猜测补齐;也不提供任何盗版、破解或侵权传播路径。这条边界写在这里,也约束着我们每一次更新说明的措辞。