← 全部文章

树莓派 4B 刷入 iStoreOS 并配置路由与容器服务

在 Raspberry Pi 4B 上刷入 iStoreOS,配置 5GHz 无线、WAN/LAN 路由和本地容器服务。

树莓派 4B 刷入 iStoreOS 打造高性能 Wi-Fi 路由器与本地容器服务器实战手册

一、 硬件拓扑与网络架构抽象

1. 硬件分工

  • 主机设备:Raspberry Pi 4B(板载双物理网卡:有线网卡 eth0 + 无线网卡 wlan0)
  • 外网接入(WAN):树莓派自带 RJ45 水晶头网口(eth0),通过网线连接上级已拨号路由器/光猫(DHCP 自动获取 IP)
  • 无线发射(LAN):树莓派板载无线网卡(wlan0),工作在纯 5GHz(80MHz 频宽)AP 模式

2. 底层网络逻辑模型

从“单口网桥直通”重构为“三层路由隔离”的架构演进:

[ 物理层:硬件资源 ]       eth0 (有线网卡)              wlan0 (无线网卡)
                                │                            │
                                ▼ (端口剥离)                  ▼ (保留挂载)
[ 交换层:二层隔离 ]      (独立直通接口)             br-lan (虚拟交换机)
                                │                            │
                                ▼                            ▼
[ 路由层:三层边界 ]        WAN 口 (对外索取)   ◀══防火墙/NAT══▶   LAN 口 (对内统治)
  • 控制平面优先:单网口设备重构网络时,必须先点亮并连上无线管理通道(Wi-Fi),再剥离物理网口,避免断线失联。
  • 二层隔离防穿透:必须将 eth0 从默认局域网虚拟交换机 br-lan 中移除并单独划给 WAN,否则上级路由器的 DHCP 广播会直接穿透网桥,导致内网设备拿到上级网段 IP(如 x.x.41.x)而无法进入本地后台。

二、 完整部署实施步骤

阶段 1:固件准备与离线烧录(Windows 端)

  1. 下载固件:前往 KoolCenter 固件服务器下载树莓派 4B 专用 iStoreOS 镜像(istoreos-24.10.x-xxx-rpi-4-squashfs.img.gz)。
  2. 写入 SD 卡:
    • 使用 Windows 电脑内置 SD 卡槽接入 MicroSD 卡。
    • 打开 Raspberry Pi Imager,设备选择 Raspberry Pi 4,操作系统选择 使用自定义镜像 并加载 .img.gz 文件。
    • 写入前弹出“是否应用操作系统自定义设置”提示时,选择“否(NO)”。

阶段 2:初始连接与开启 5GHz 无线(防失联关键步)

  1. 网线直连进后台:SD 卡插回树莓派通电等待约 40 秒,用网线直连 Windows 电脑网口与树莓派网口。浏览器访问 http://192.168.100.1(默认账号 root,密码 password)。
  2. 配置满血 5GHz Wi-Fi:
    • 进入 网络 -> 无线,编辑板载无线设备(radio0)。
    • 设备配置:模式选 AC,频段选 5 GHz,频宽选 80 MHz,信道固定为 36 或 149(避开雷达 DFS 信道);在 高级设置 中将国家代码改为 US 或 CN 解锁发射功率与信道限制。
    • 接口配置:设置 Wi-Fi 名称(ESSID)与 WPA2 密码,确认网络勾选 lan。
    • 点击 保存并应用。
  3. 切换至无线管理:拔掉电脑与树莓派之间的网线,用电脑连接刚创建的 5GHz Wi-Fi,确认仍可正常访问 http://192.168.100.1。

阶段 3:重塑网口拓扑与接入外网

  1. 剥离物理网口:进入 网络 -> 接口 -> 设备(Devices),配置 br-lan,在 网桥端口 中取消勾选 eth0,点击保存(暂不应用)。
  2. 更改局域网段:切回 接口(Interfaces),修改 LAN 接口,将 IPv4 地址改为 192.168.88.1(避开上级路由器网段冲突),点击保存。
  3. 新建外网接口:左下角点击 添加新接口,名称填 WAN,协议选 DHCP 客户端,设备选 eth0,防火墙区域分配为 wan(红色),点击保存。
  4. 统一生效与接线:点击右上角 保存并应用。待设备自动重连 Wi-Fi(新后台地址 http://192.168.88.1)后,将上级外网网线插入树莓派水晶头网口即可高速上网。

三、 常见故障排查:后台网关跳变(如变为 41.1 并跳转上级路由)

  • 故障原因:eth0 未彻底从 br-lan 剥离,上级路由器的 DHCP 信号穿透网桥抢先分配了 IP。
  • 修复步骤:
    1. 临时拔掉树莓派上的外网网线。
    2. 将电脑 Wi-Fi 的 IPv4 临时改为手动静态 IP(IP:192.168.88.10,子网掩码:255.255.255.0,网关:192.168.88.1)。
    3. 浏览器访问 http://192.168.88.1 进入后台,确认 br-lan 中已取消勾选 eth0,且 LAN 接口未勾选“忽略 DHCP 服务器”,保存并应用。
    4. 将电脑网络改回 自动获取(DHCP),插回外网网线即可恢复正常。

四、 进阶扩展:作为本地服务器运行自研后端容器

iStoreOS 内置完整 Docker 引擎与 Dockerman 面板,可直接兼任轻量级开发测试服务器:

1. 扩容 Docker 专属存储空间(防撑爆系统盘)

  1. 进入后台 系统 -> 磁盘管理,将 SD 卡(/dev/mmcblk0)末尾未分配空间新建分区并格式化为 ext4,挂载至 /mnt/mmcblk0p3(或外接 USB 硬盘)。
  2. 进入 Docker -> 配置,将 Docker 根目录 修改为 /mnt/mmcblk0p3/docker 并保存。

2. 构建与部署 arm64 后端镜像

在开发机上交叉编译构建适配树莓派 4B 架构的镜像并推送运行:

# 1. 开发机构建 linux/arm64 架构镜像(Go 服务建议开启 CGO_ENABLED=0 GOARCH=arm64)
docker buildx build --platform linux/arm64 -t my-backend:v1 --load .

# 2. 导出并直接通过 SSH 管道传输加载至树莓派(局域网免仓库极速部署)
docker save my-backend:v1 | gzip | ssh root@192.168.88.1 "docker load"

# 3. 在树莓派上启动容器(避开 80/443/53 端口,限制内存防拖垮路由)
ssh root@192.168.88.1 "docker run -d \
  --name my-backend \
  --restart unless-stopped \
  --memory='512m' \
  -p 8080:8080 \
  my-backend:v1"

© 2026 llmons