RaspiWiFi热点找不到、打不开10.0.0.1?8个常见问题排查清单【免费下载链接】RaspiWiFiHeadless WiFi configuration for the Raspberry Pi (or most other devices running Linux) by using a temporary WiFi access point and web interface项目地址: https://gitcode.com/gh_mirrors/ra/RaspiWiFiRaspiWiFi 是一款树莓派无头HeadlessWiFi 配置工具树莓派开机后自己变成一个临时 WiFi 热点你用手机或笔记本连上它再打开 10.0.0.1 网页就能给树莓派配网。但很多新手遇到找不到热点或10.0.0.1 打不开就卡住了。本文提供 8 个常见问题的排查清单帮你快速定位原因。排查前先搞懂树莓派有两种模式 这是理解所有问题的关键模式热点行为网页配置模式Host Mode✅ 广播RaspiWiFi Setup XXXX热点10.0.0.1 可访问客户端模式Client Mode❌ 不广播热点作为普通 WiFi 客户端接入你的路由器需用路由器分配的 IP 访问树莓派只有在配置模式下才会广播热点。如果你之前已经成功配过网重启后它默认直连已保存的 WiFi热点自然消失了。所有配置都保存在/etc/raspiwifi/raspiwifi.conf中例如ssid_prefixRaspiWiFi Setup server_port80 ssl_enabled0 wpa_enabled0 auto_config0 auto_config_delay300问题1WiFi列表里找不到热点原因A树莓派没有进入配置模式。它已保存过 WiFi 信息直接进入了客户端模式。解决方法——强制树莓派重置回配置模式两种方式任选其一按住接在GPIO 18上的重置按钮10 秒树莓派会播放提示音、清除配置并重启进入配置模式逻辑见 reset.py 中的主循环该逻辑对应安装后的/usr/lib/raspiwifi/reset_device/reset.py。通过 SSH 执行sudo python3 /usr/lib/raspiwifi/reset_device/manual_reset.py原因B热点名称和你想象的不一样。默认 SSID 是前缀RaspiWiFi Setup 空格 树莓派序列号后4位例如RaspiWiFi Setup 9A3F。如果你安装时自定义了前缀ssid_prefix就按实际名称搜索。问题2连上了热点但 10.0.0.1 打不开✅ 确认手机/电脑真正切换到了树莓派热点部分手机连上后仍沿用原网络 DNS导致域名解析错误。✅ 试试直接访问备用的特殊域名raspiwifisetup.com它会被劫持指向 10.0.0.1可绕过 DNS 缓存问题。✅ 清除浏览器缓存或换浏览器、换设备重试。✅ 若手机一直分配了旧的固定 IP在 WiFi 设置中改为自动或手动设为10.0.0.2、子网掩码255.255.255.0。树莓派在配置模式下通过 dhcpcd.conf 固定占用10.0.0.1这个地址在热点内不会变。问题3自定义过端口忘记加端口号默认 Web 服务监听80 端口直接访问http://10.0.0.1即可。但如果你把配置里的server_port改成了其他值例如 12345就必须写成http://10.0.0.1:12345忘了加端口号是打不开的头号原因之一先检查/etc/raspiwifi/raspiwifi.conf里的server_port。问题4开启了 SSL 模式地址要手动加 https://若ssl_enabled1浏览器会自动用 http 访问然后失败。你需要手动输入https://10.0.0.1页面会提示证书未受信任——这是自签名证书的正常警告选择继续访问即可数据仍然是加密的。问题5热点连不上提示密码错误如果安装时开启了 WPA2 加密wpa_enabled1连接热点时需要输入当时设置的wpa_key。忘记密码的解决路径SSH 进树莓派修改/etc/raspiwifi/raspiwifi.conf中的wpa_key或在配置网页左上角的 WPA 设置面板中修改修改后树莓派会自动重启生效对应 wpa_settings.html 页面。问题6网页时开时不开、连接频繁掉线配置模式的热点由hostapd提供若它未正常启动如wlan0被其他程序占用网页就会不稳定。确认wlan0网卡状态正常后重启树莓派通常可恢复。启动流程见 aphost_bootstrapper它会在开机时依次拉起重置监听、Web 应用app.py和 hostapd。问题7树莓派莫名其妙又变成热点了这不是故障如果开启了Auto-Config 自动回退模式auto_config1树莓派会持续监测网络连接一旦断线超过auto_config_delay秒默认 300 秒就自动重启回配置模式等你重新配网——逻辑见 connection_monitor.py。移动设备到新地点后这正是它的价值所在。问题8想彻底重置所有设置硬件方式GPIO 18 按钮按住 ≥10 秒命令行方式sudo python3 /usr/lib/raspiwifi/reset_device/manual_reset.py源码 manual_reset.py。重置会清除已保存的 WiFi 凭据树莓派重启后重新广播配置热点。速查表 ⚡症状最可能原因一步解决找不到热点树莓派在客户端模式按重置按钮10秒 / 跑 manual_reset.py10.0.0.1 打不开设备没真正切到热点手动切换 WiFi重试备用域名加端口才通改过 server_porthttp://10.0.0.1:端口号SSL 下打不开用了 http手动输入https://热点密码不对忘了 wpa_key改配置或从网页 WPA 面板修改反复掉线hostapd 未正常启动检查 wlan0重启树莓派 提示所有功能文件在initial_setup.py安装后都复制到/usr/lib/raspiwifi/下运行项目源码中可参考 libs/reset_device/ 与 libs/configuration_app/ 两个模块理解各配置项的作用。总结排查顺序建议先确认树莓派在配置模式问题1→ 再看端口和协议问题3/4→ 最后查密码与网卡问题5/6。绝大多数热点找不到、10.0.0.1 打不开的问题都能在这 8 条清单中 5 分钟内定位解决。【免费下载链接】RaspiWiFiHeadless WiFi configuration for the Raspberry Pi (or most other devices running Linux) by using a temporary WiFi access point and web interface项目地址: https://gitcode.com/gh_mirrors/ra/RaspiWiFi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考