Raspberry_pi4_installs_openwrt_with_docker

infini

Announcement

For more information,please click the more button.

More

858 words

4 minutes

Raspberry_pi4_installs_openwrt_with_docker

2025-10-14

openwrt

docker

制作openwrt docker 镜像#

在github上新建一个仓库
创建.github/workflows/build.yml文件:

1
name: Build OpenWrt Docker Image from RPi4 Factory IMG
2

3
on:
4
  workflow_dispatch:   # 手动触发
5

6
jobs:
7
  build:
8
    runs-on: ubuntu-latest
9

10
    steps:
11
      - name: Checkout
12
        uses: actions/checkout@v4
13

14
      - name: Download OpenWrt RPi4 Factory Image
15
        run: |
16
          mkdir image
17
          cd image
18
          wget https://downloads.openwrt.org/releases/24.10.1/targets/bcm27xx/bcm2711/openwrt-24.10.1-bcm27xx-bcm2711-rpi-4-ext4-factory.img.gz
19
          gunzip openwrt-24.10.1-bcm27xx-bcm2711-rpi-4-ext4-factory.img.gz
20
          cd ..
21

22
      - name: Extract rootfs from IMG
23
        run: |
24
          mkdir rootfs
25
          sudo apt-get update && sudo apt-get install -y kpartx e2fsprogs
26
          # 建立 loop 设备
27
          LOOP=$(sudo losetup -f --show image/openwrt-24.10.1-bcm27xx-bcm2711-rpi-4-ext4-factory.img)
28
          sudo partprobe $LOOP
29
          # 挂载第二个分区 (rootfs)
30
          sudo mount ${LOOP}p2 /mnt
31
          sudo tar -C /mnt -czf rootfs/openwrt-rpi4-rootfs.tar.gz .
32
          sudo umount /mnt
33
          sudo losetup -d $LOOP
34

35
      - name: Create Dockerfile
36
        run: |
37
          cat > Dockerfile <<'EOF'
38
          FROM scratch
39
          ADD rootfs/openwrt-rpi4-rootfs.tar.gz /
40
          CMD ["/sbin/init"]
41
          EOF
42

43
      - name: Set up QEMU
44
        uses: docker/setup-qemu-action@v3
45

46
      - name: Set up Docker Buildx
47
        uses: docker/setup-buildx-action@v3
48

49
      - name: Build Docker Image
50
        uses: docker/build-push-action@v6
51
        with:
52
          context: .
53
          file: ./Dockerfile
54
          platforms: linux/arm64
55
          push: false
56
          outputs: type=docker,dest=./openwrt-rpi4.tar
57

58
      - name: Upload Image Artifact
59
        uses: actions/upload-artifact@v4
60
        with:
61
          name: openwrt-rpi4-image
62
          path: ./openwrt-rpi4.tar

说明:

下载 openwrt-24.10.1-bcm2711-rpi-4-ext4-factory.img.gz
解压 .img.gz 得到 .img
挂载 .img 的第二个分区（rootfs）
打包 rootfs 为 tar.gz
构建 Docker 镜像（基于 scratch）
导出为 openwrt-rpi4.tar，并作为 Artifact 提供下载

使用#

点击Actions按钮
点击左侧出现的Build OpenWrt Docker Image from RPi4 Factory IMG ,再点击Run workflow
一分钟左右镜像构建成功，下载镜像

导入镜像#

1
docker load -i openwrt-rpi4.tar #镜像名

导入的镜像没有名字，用docker tag 来命名

1
docker images #查看docker images
2
docker tag images_ID openwrt24.10.1:rpi4

NOTE
可以在构建阶段加入tag
with:
tags: openwrt24.10.1

运行容器#

直接运行

1
docker run -d --name openwrt --network host --privileged openwrt24.10.1:rpi4

使用macvlan

1
sudo ip link set eth0 promisc on # 打开有线网卡的混杂模式
2
docker network create -d macvlan --subnet=192.168.0.0/24 --gateway=192.168.0.1 -o parent=eth0 openwrt_macnet
3
# 创建macvlan网卡
4
# --subnet=真实的网络
5
# parent=网卡名字 虚拟网卡名
6
docker run --restart always --name openwrt -d --network openwrt_macnet --privileged rpi4

使用docker compose(推荐)
1. 创建一个目录
Terminal window
```
1
 mkdir openwrt
```
1. 进入目录创建docker-compose.yml文件

1
services:
2
  openwrt:
3
    image: openwrt24.10.1:rpi4
4
    container_name: openwrt
5
    privileged: true
6
    networks:
7
      macnet:
8
        ipv4_address: 192.168.1.31   # 给 OpenWrt 容器分配的局域网 IP
9
    restart: unless-stopped
10
    volumes:
11
      - ./openwrt-overlay:/overlay   # 持久化 OpenWrt 配置到当前目录
12
      - ./openwrt-root:/root         # 可选：持久化 root 用户目录（在当前目录）
13
      - ./openwrt-tmp:/tmp           # 可选：持久化临时目录（避免容器重启丢失）
14

15
networks:
16
  macnet:
17
    driver: macvlan
18
    driver_opts:
19
      parent: eth0                   # 你的物理网卡名称
20
    ipam:
21
      config:
22
        - subnet: 192.168.1.0/24      # 你的局域网网段
23
          gateway: 192.168.1.1        # 你的路由器网关
24
          ip_range: 192.168.1.31/32

NOTE
用macvlan的方式，容器无法与宿主机通信(宿主机ping不通容器)
可以在宿主机再建一个macvlan接口
sudo ip link add macvlan1 link eth0 type macvlan mode bridge # 创建一个macvlan1的接口
sudo ip addr add 192.168.1.32/24 dev macvlan1 # 分配同一网段的ip地址
sudo ip link set macvlan1 up # 启用接口

使用ipvlan模式

1
services:
2
  openwrt:
3
    image: openwrt24.10.1:rpi4
4
    container_name: openwrt
5
    privileged: true
6
    networks:
7
      ipvlan_net:
8
        ipv4_address: 192.168.1.31   # 给 OpenWrt 容器分配的局域网 IP
9
    restart: unless-stopped
10
    volumes:
11
      - ./openwrt-overlay:/overlay   # 持久化 OpenWrt 配置到当前目录
12
      - ./openwrt-root:/root         # 可选：持久化 root 用户目录
13
      - ./openwrt-tmp:/tmp           # 可选：持久化临时目录
14

15
networks:
16
  ipvlan_net:
17
    driver: ipvlan
18
    driver_opts:
19
      parent: eth0                   # 改成你的物理网卡名称
20
      ipvlan_mode: l2                # L2 模式，容器像局域网独立设备
21
    ipam:
22
      config:
23
        - subnet: 192.168.1.0/24     # 你的局域网网段
24
          gateway: 192.168.1.1       # 你的路由器网关
25
          ip_range: 192.168.1.31/32  # 限定容器 IP

启动

1
docker compose up -d

进入容器

1
docker exec -it openwrt /bin/sh
2
vi /etc/config/network # 修改ip地址
3
/etc/init.d/network restart # 重启网络

使用ip地址在浏览器上访问。

Finally#

此方案没有无线功能，如果一定要有可以考虑做设备直通或者自己编译OpenWrt Docker镜像又或者直接在树莓派上安装OpenWrt。

Raspberry_pi4_installs_openwrt_with_docker

https://infini.cv/posts/raspberry/raspberry_pi4_installs_openwrt_with_docker/

Author

infini

Published at

2025-10-14

License

CC BY-SA 4.0

Some information may be outdated

Remote_power_on

Docker_learn

Live Life Link

制作openwrt docker 镜像#

使用#

导入镜像#

运行容器#

Finally#