ophub/openwrt-aarch64

openwrt-armv8 Docker镜像文档

镜像概述

openwrt-armv8是针对ARMv8架构设备的OpenWrt Docker镜像，适用于Armbian等系统的Docker环境。该镜像前身为openwrt-aarch64，现正式更名为openwrt-armv8，提供OpenWrt的核心网络功能，可作为软路由、旁路由等网络设备使用。

镜像仓库地址：https://hub.docker.com/r/ophub/openwrt-armv8

默认信息

• IP地址：192.168.1.1
• 用户名：root
• 密码：password

镜像下载源

• OpenWrt镜像源码：https://github.com/ophub/amlogic-s9xxx-openwrt
• Armbian系统源码：https://github.com/ophub/amlogic-s9xxx-armbian

使用方法

1. 检查macvlan网络

首先检查系统中是否已存在macvlan网络：

shell
docker network ls

2. 创建macvlan网络

根据实际网络环境修改网段、网关和网口参数，创建macvlan网络：

shell
docker network create -d macvlan \
  --subnet=192.168.1.0/24 \  # 替换为实际网段
  --gateway=192.168.1.1 \     # 替换为实际网关
  -o parent=eth0 \            # 替换为实际网口
  macnet                      # 网络名称

3. 拉取并运行镜像

shell
docker run -d --name=openwrt \
  --network macnet \          # 使用创建的macvlan网络
  --privileged \              # 授予特权模式
  --restart always \          # 设置自动重启
  ophub/openwrt-armv8:latest  # 镜像名称及标签

4. 修改网络配置

进入容器内部修改网络参数（IP、网关、DNS等）：

shell
docker exec -it openwrt bash

编辑网络配置文件：

shell
vi /etc/config/network

修改完成后，按ESC键，输入:wq!保存退出。

5. 重启网络服务

shell
/etc/init.d/network restart

旁路由配置

核心配置步骤

1. 关闭DHCP服务
2. 设置网关：填写主路由器IP地址
3. 设置DNS：可为主路由器IP或公共DNS（如114.114.114.114）
4. 物理设置：取消勾选“桥接接口”
5. 添加防火墙规则：

shell
iptables -t nat -I POSTROUTING -o eth0 -j MASQUERADE

重启防火墙

shell
/etc/init.d/firewall restart

网络互联互通配置

如需设置Armbian系统与OpenWrt容器的互相访问，详细配置步骤请参考：
https://github.com/ophub/amlogic-s9xxx-armbian/tree/main/documents 中的第12.7章节。