OpenWrt LuCI界面搞不定？试试用SSH命令行手动配置树莓派的网络接口
当你刚给树莓派刷完OpenWrt系统，却发现Web管理界面无法访问，或者LuCI配置总是出错时，别急着重装系统。对于熟悉Linux命令行的用户来说，SSH才是更强大、更可靠的配置工具。本文将带你从零开始，仅用命令行完成树莓派上OpenWrt的WAN、LAN和WiFi接口配置。
1. 初始状态诊断与接口识别
首先通过SSH连接到树莓派（如果不知道IP，可以尝试用arp -a扫描局域网）。登录后，我们需要先摸清当前网络接口的状态：
cat /proc/net/dev这个命令会列出所有可用的网络接口。典型输出如下：
Inter-| Receive | Transmit face |bytes packets errs drop fifo frame compressed multicast|bytes packets errs drop fifo colls carrier compressed lo: 6528 96 0 0 0 0 0 0 6528 96 0 0 0 0 0 0 wlan0: 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 eth0: 8264 134 0 1 0 0 0 0 2366 17 0 0 0 0 0 0 br-lan: 4634 76 0 17 0 0 0 0 1714 11 0 0 0 0 0 0关键接口说明：
- eth0：树莓派的有线网卡
- wlan0：无线网卡（可能未激活）
- br-lan：默认的桥接接口（通常包含eth0）
接着用ifconfig查看详细配置：
ifconfig br-lan你会看到类似这样的信息：
br-lan Link encap:Ethernet HWaddr B8:27:EB:1F:83:06 inet addr:192.168.1.1 Bcast:192.168.1.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:191 errors:0 dropped:53 overruns:0 frame:0 TX packets:11 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:1000注意：如果
br-lan的IP（192.168.1.1）与你现有网络冲突，需要优先修改。
2. 基础网络配置调整
2.1 修改LAN口IP地址
使用UCI（Unified Configuration Interface）命令修改LAN口IP：
uci set network.lan.ipaddr='192.168.10.1' uci commit network /etc/init.d/network restart验证修改是否生效：
ifconfig br-lan | grep 'inet addr'2.2 检查桥接配置
查看当前桥接状态：
brctl show典型输出：
bridge name bridge id STP enabled interfaces br-lan 7fff.b827eb1f8306 no eth0如果eth0被错误地桥接到br-lan（应该作为WAN口），需要移除：
uci set network.lan.ifname='wlan0' # 只保留wlan0在桥接中 uci commit network /etc/init.d/network restart3. WiFi接入点配置
3.1 激活无线接口
首先启用无线硬件：
ifconfig wlan0 up检查无线配置：
uci show wireless你会看到类似配置：
wireless.radio0.disabled='1' # 表示无线被禁用 wireless.default_radio0.mode='ap' # 接入点模式 wireless.default_radio0.ssid='OpenWrt'启用无线并重启服务：
uci set wireless.radio0.disabled='0' uci commit wireless wifi3.2 高级WiFi设置
修改SSID和加密方式：
uci set wireless.default_radio0.ssid='MySecureWiFi' uci set wireless.default_radio0.encryption='psk2' uci set wireless.default_radio0.key='StrongPassword123' uci commit wireless wifi reload查看连接设备：
iwinfo wlan0 assoclist4. WAN口配置实战
4.1 DHCP客户端配置
将eth0配置为DHCP客户端获取外网IP：
uci set network.wan=interface uci set network.wan.ifname='eth0' uci set network.wan.proto='dhcp' uci commit network /etc/init.d/network restart检查IP获取情况：
ifconfig eth04.2 PPPoE拨号配置
如果是PPPoE拨号：
uci set network.wan.proto='pppoe' uci set network.wan.username='your_isp_username' uci set network.wan.password='your_isp_password' uci commit network /etc/init.d/network restart查看拨号日志：
logread | grep pppd5. 防火墙与高级路由配置
5.1 基础防火墙规则
查看当前规则：
uci show firewall允许WAN到LAN的SSH（谨慎使用）：
uci add firewall rule uci set firewall.@rule[-1].name='Allow-WAN-SSH' uci set firewall.@rule[-1].src='wan' uci set firewall.@rule[-1].target='ACCEPT' uci set firewall.@rule[-1].proto='tcp' uci set firewall.@rule[-1].dest_port='22' uci commit firewall /etc/init.d/firewall restart5.2 静态路由添加
添加静态路由示例：
uci add network route uci set network.@route[-1].interface='lan' uci set network.@route[-1].target='192.168.2.0' uci set network.@route[-1].netmask='255.255.255.0' uci set network.@route[-1].gateway='192.168.10.254' uci commit network /etc/init.d/network restart验证路由表：
route -n6. 故障排查技巧
6.1 常见问题诊断
网络不通时检查步骤：
- 物理层检查：
ethtool eth0 | grep 'Link detected' - IP配置验证：
ip addr show - 路由检查：
ip route show - DNS测试：
nslookup google.com
6.2 日志分析关键命令
查看系统日志：
logread | tail -20过滤网络相关日志：
logread | grep -E 'network|pppd|dhcp|wifi'7. 配置备份与恢复
7.1 完整配置备份
备份所有配置：
sysupgrade -b /tmp/backup.tar.gz单独备份网络配置：
uci export network > /etc/config/network.backup7.2 快速恢复技巧
从备份恢复：
tar -C / -xzvf /tmp/backup.tar.gz重置单个配置：
uci revert wireless /etc/init.d/network reload经过这些步骤，你的树莓派OpenWrt系统应该已经完成了全部网络配置。命令行配置虽然学习曲线略陡，但一旦掌握，你会发现它比图形界面更高效、更稳定。特别是在LuCI不可用的情况下，这些技能将成为你的救命稻草。
