树莓派搭建Bottle服务器作无线AP 热点客户端连接被拒排查

核心疑问先答 #

• 无需配置「启用路由和IP伪装」：该配置仅用于转发热点流量到其他联网接口供终端上网，纯局域网内服务访问完全不需要这步配置，跳过不会导致连接被拒绝。
• 防火墙配置是可能的影响因素，但不是唯一原因，故障优先级低于服务绑定配置错误。
• 除了防火墙，还有多个高频配置遗漏会直接触发ERR_CONNECTION_REFUSED，按优先级从高到低排查即可。

逐步骤排查操作 #

• 优先检查Bottle服务绑定地址（90%同类故障根因）

Bottle默认示例代码常写为run(host='127.0.0.1', port=8080)，该配置仅监听本地回环接口，只有树莓派自身能访问，外部终端的请求根本到不了服务进程，完全匹配“本地正常、外部拒绝连接”的故障表现。

• 在树莓派终端执行命令查看服务监听状态：ss -tulpn | grep 你设置的Bottle服务端口

• 如果输出的Local Address列显示127.0.0.1:端口号，直接修改Bottle启动代码，将host参数改为0.0.0.0（代表监听所有网络接口的对应端口），重启Bottle服务后再从终端测试访问。

• 如果输出显示0.0.0.0:端口号或树莓派wlan0接口的对应IP+端口，再往下排查。

• 检查防火墙入站规则

  • 最新版Pi OS默认可能启用ufw防火墙，先执行sudo ufw status查看运行状态：
    • 如果返回Status: active，执行命令放行热点网卡的对应端口：sudo ufw allow in on wlan0 to any port 你的Bottle服务端口/tcp，规则自动生效后重试。
  • 如果使用iptables/nftables管理规则，执行sudo iptables -L INPUT -v -n查看是否存在wlan0接口的入站DROP规则，存在则添加放行规则：sudo iptables -A INPUT -i wlan0 -p tcp --dport 你的Bottle服务端口 -j ACCEPT，记得保存规则避免重启失效。

• 检查AP侧配置问题

  • 确认树莓派wlan0接口的实际IP：执行ip a show wlan0查看inet字段的地址，不要误填树莓派有线网口的IP，这类地址填写错误占故障案例的不小比例。
  • 检查连接热点的终端拿到的IP，需要和树莓派wlan0IP在同一网段（比如树莓派是192.168.4.1，终端IP需为192.168.4.0/24网段），如果网段不对检查dnsmasq的DHCP地址池配置。
  • 检查hostapd配置是否开启了客户端隔离：如果配置文件中存在ap_isolate=1，直接注释掉该行，重启hostapd服务——该配置会禁止连接热点的终端和网关、终端之间互访，也会导致连接被拒绝。

• 连通性验证

  • 先在连接热点的终端ping树莓派wlan0IP，ping不通先检查AP的无线连接、DHCP配置是否正常。
  • ping通后在终端执行telnet 树莓派wlan0IP 服务端口测试端口连通性，如果能连通说明服务和链路都正常，检查浏览器输入的地址、端口是否拼写错误。

内容的提问来源于stack exchange，提问作者KayGee