3分钟解决LocalSend常见传输故障：故障排查完整指南

3分钟解决LocalSend常见传输故障故障排查完整指南【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend你在电脑前把手机拍的照片往桌面拖LocalSend 的发送页转了半分钟Nearby devices 还是空的。先别重装或换应用——LocalSend 内置的故障排查页面正好覆盖这三类最常见的问题设备搜不到、防火墙拦截、连接失败。按现象 → 原因 → 动作的顺序对照排查绝大多数故障 3 分钟内能定位并修好你只需要做自己命中的那一条。症状自诊 先看这张对照表按你当前的现象直接跳到对应小节你的现象最可能的原因看哪一节附近设备列表一直为空搜不到任何设备不在同一 Wi-Fi、两端配置不一致、路由器开了 AP 隔离附近设备列表一直为空你能发文件对方却发不进来本机防火墙拦截 53317 入站连接单向发送总是失败互相搜不到也互相传不了文件AP 隔离开启或两端端口/加密不一致双向都连不上附近设备列表一直为空LocalSend 搜不到设备可能原因LocalSend 靠局域网内的广播包互相发现设备以下任何一种情况都会让列表为空两台设备不在同一个 Wi-Fi其中一台走了移动数据或挂着 VPN两端配置不一致端口默认 53317、组播地址、加密开关任意一项不同都会互相看不见路由器开启了 AP 隔离访客网络尤其常见。快速修复在 LocalSend 的发送页底部点击Troubleshoot文字进入故障排查页入口代码在 send_tab.dart 的 Troubleshoot 跳转在无法发现其他设备这张卡片里先确认所有设备都在同一个 Wi-Fi并且端口、组播、加密三项设置完全一致还不行就手动绕过发现机制在发送页附近设备区域通过地址输入框手动填入对方设备的 IP 和端口手动连接成功后把对方设备加入收藏以后会自动发现不用再填 IP。验证方法刷新设备列表对方应出现在附近设备里再发一个几 KB 的小文件能收到即修复完成。单向发送总是失败LocalSend 防火墙配置现象很典型你往对方发文件没问题对方却怎么都发不进你这台机器。这是防火墙拦截入站连接的标志性症状。可能原因LocalSend 接收文件时需要监听 53317 端口TCP 和 UDP 都要而 Windows、macOS 的防火墙默认不放行这条入站连接于是出现发得出去、收不进来。官方 README 的防火墙配置表也明确要求入站 TCP、UDP 的 53317 端口必须放行见 README 的 Setup 章节。快速修复打开故障排查页入口同上一节在能发不能收这张卡片下点自动修复Fix automatically按钮Windows 会弹出管理员授权确认后 LocalSend 自动执行两条 netsh 命令分别为 53317 端口的 TCP 和 UDP 添加入站放行规则macOS 点打开防火墙Open Firewall按钮直达系统防火墙设置手动允许 LocalSend 即可。按钮背后的逻辑是 _CommandFixAction 类的 runFix() 方法按当前系统选择命令执行方式且仅 Windows 支持自动加规则。验证方法请对方设备给你发一个文件本机弹出接收确认框并能成功保存说明防火墙已修好。双向都连不上可能原因两边互相搜不到、也传不了文件问题大概率在网络层或配置层两台设备不在同一网段路由器开启了 AP IsolationAP 隔离把同一 Wi-Fi 下的设备彼此隔离开了一端改过端口或加密另一端没同步。快速修复进设置页确认两端端口都是 53317或相同自定义值、加密开关状态一致请网络管理员在路由器后台关闭AP Isolation通常在无线设置里网络动不了时退回手动填 IP 的方式直接发送绕开广播发现。验证方法关闭 AP 隔离后两端 LocalSend 重启或刷新设备列表互见设备再双向各发一个测试文件均成功即可收工。进阶专区⚠️ 面向进阶用户读两份日志定位深层原因上面三步都无效时打开调试页Debug里面有发现日志和HTTP 日志两个标签。HTTP 日志里出现 403 或 TLS 错误多半是指纹校验/拦截问题连接超时则指向端口不通或路由问题。日志模型定义在 log_entry.dart两类日志分别由 http_logs_provider.dart 和 discovery_logs_provider.dart 管理。排除多余网卡LocalSend 默认使用全部网络接口。双网卡机器Wi-Fi 加有线广播可能发错网卡可在设置 → 网络接口页做白名单/黑名单页面说明在 network_interfaces_page.dart改完需重启应用内服务器才生效。手动校验防火墙规则不放心一键修复的话可在 Windows 管理员终端手动添加放行规则前提是端口仍为默认 53317netsh advfirewall firewall add rule nameLocalSend dirin actionallow protocolTCP localport53317执行后用netsh advfirewall firewall show rule nameLocalSend查看规则是否生效。阅读完整源码想审计修复逻辑或自行调试可克隆仓库git clone https://gitcode.com/GitHub_Trending/lo/localsend一表速查现象可能原因解决方案相关模块附近设备列表一直为空UDP 广播被拦截、不在同一 Wi-Fi、端口/加密不一致核对网络与配置或手动输入对方 IP 并加入收藏discovery_logs_provider.dart能发不能收防火墙拦截 53317 入站连接故障排查页点自动修复一键加规则troubleshoot_page.dart双向都连不上AP 隔离开启或两端配置不一致关闭路由器 AP 隔离核对端口与加密一致network_interfaces_page.dart发送进度条卡在 0% 或超时对方未处于接收状态或 53317 端口被占用确认对方已打开 App排查端口占用或改端口http_logs_provider.dart下一步何时该找开发者如果按上面三节操作后仍无法传输打开调试页导出发现日志和 HTTP 日志到项目仓库的 Issues 提交问题单附上四样信息系统与 LocalSend 版本号、命中的症状类型搜不到/单向失败/双向失败、日志内容、是否动过防火墙或改过端口。LocalSend 是完全开源的免费项目每张排查卡片和每条自动修复命令都能在源码里找到对应实现——这正是开源工具给你的最大底气问题透明规则可查。【免费下载链接】localsendAn open-source cross-platform alternative to AirDrop项目地址: https://gitcode.com/GitHub_Trending/lo/localsend创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考