网络与远程访问

目标：掌握 LeLamp 的 WiFi 双模机制（Station 客户端 / AP 热点），学会切换 WiFi、物理强制回退热点、SSH 连接与断网自动恢复，任何情况下都能找回你的设备

一、两种网络模式

LeLamp 内置两套网络身份，本质是 NetworkManager 的两个连接配置，随时可以切换：

新设备（从未配过网）开机后自动进入 AP 热点模式，引导你完成配网。

二、AP 热点参数（记不住就收藏）

配过网之后，正常开机不会弹热点——只有新设备、被物理切换、或断网自动回退时才出现。

三、日常切换 WiFi（Web 界面）

适用：还能打开 Web 界面时的换网操作，最简单。

1. 浏览器打开 LeLamp Web 界面 → Settings（设置） 页
2. 找到 网络设置 卡片，可看到当前 SSID、模式（客户端/热点）、IP 地址
3. 点 切换 WiFi → 扫描附近网络 → 选择你的 WiFi → 输入密码 → 连接
4. 想切回热点：点 切回热点，确认弹窗后设备断开 WiFi 并开启热点

你应看到什么：网络设置卡片上的"模式"从"客户端"变为"热点"，或 SSID 变为你的新 WiFi 名称；几秒后设备 IP 更新。

四、物理切换：GPIO 短接强制回热点

适用：旧 WiFi 不在身边、忘记密码、Web 界面打不开。用一根跳线帽或金属镊子即可，不需要电脑。

1. 找到树莓派 40-pin 排针（GPIO 引脚朝外的一排）
2. 用跳线帽/金属镊子同时短接：
   • Pin 37（GPIO 26）
   • Pin 39（GND，最边上）
3. 保持短接约 0.5 秒，松开
4. 设备自动断开当前 WiFi，开启热点 lelamp_xxx

你应看到什么：约几秒后手机 WiFi 列表出现 lelamp_xxx 热点；连接后访问 192.168.4.1 即可重新配网。

防误触设计：短接需稳定保持 500ms 才触发；触发后 30 秒冷却，不会重复响应；未短接时引脚内部上拉，不会误触发。

五、断网自动回退（什么都不做也能找回）

LeLamp 内置断网监控，检测到连不上网会自动开热点：

你应看到什么：断网约 6.5 分钟后，lelamp_xxx 热点自动出现，连上即可重新配网。

不需要自动回退？可在 config.yaml 中关闭：wifi.fallback_ap.enabled: false。

三种场景换网速查

六、SSH 连接（命令行管理）

SSH 用于命令行调试、看日志、跑校准脚本，进阶用户常用。

1. 确认设备在线：同一 WiFi 下执行 ping LELAMP-V200（或 ping 设备 IP），能通再继续
2. 打开终端（macOS/Linux 直接开，Windows 用 PowerShell 或 PuTTY）：

ssh lelamp@192.168.xxx.xxx      # 或 ssh lelamp@<设备IP>

3. 首次连接会提示确认指纹，输入 yes；再输入系统登录密码

你应看到什么：登录成功进入命令行，提示符形如 lelamp@LELAMP-V200:~ $。

用户名以你系统镜像安装时设置的为准（常见为 lelamp）。SSH 需在镜像中已启用；若连不上，先确认设备与电脑在同一网络、设备在线。

七、远程访问（在外网用）

• 局域网内：Web 界面 + SSH 直接可用，无需额外配置
• 公网远程：建议用 VPN 组网（如 Tailscale 之类）或路由器端口转发，不建议直接把 Web 端口暴露到公网（有安全风险）

常见问题