unifreq/openwrt-aarch64

unifreq/openwrt-aarch64 Docker镜像文档

镜像概述

unifreq/openwrt-aarch64是针对aarch64架构设计的OpenWrt Docker镜像，将OpenWrt的网络功能（如路由、防火墙、DHCP等）封装为容器化应用，便于在支持aarch64架构的设备上快速部署和管理。

核心功能与特性

• 架构支持：专为aarch64架构优化，适用于ARM64设备
• 网络功能：集成OpenWrt完整网络功能，包括路由、NAT、防火墙、DHCP服务等
• 容器化优势：支持Docker容器化部署，简化安装和升级流程
• turboacc支持：r21.10.01及后续版本支持turboacc加速功能（需额外配置内核模块映射）
• 灵活配置：支持自定义网络参数、MAC地址、IP地址等

使用场景

• 家庭或小型办公网络的路由网关部署
• aarch64架构开发板（如树莓派4等）的网络功能扩展
• 网络功能测试与开发环境搭建
• 需要快速部署和迁移的网络服务场景

使用方法与配置说明

前置要求

• 已安装Docker环境（支持aarch64架构）
• 目标设备内核版本需与镜像兼容（建议使用较新内核）

网络准备

该镜像推荐使用macvlan网络模式，需先创建macvlan网络：

bash
# 创建macvlan网络（仅首次运行时需要）
docker network create -d macvlan -o parent="eth0" --subnet "192.168.3.0/24" --gateway "192.168.3.1" macnet

参数说明：

• -d macvlan：指定网络驱动为macvlan
• -o parent="eth0"：指定物理网络接口（根据实际环境调整）
• --subnet：指定子网（根据实际网络规划调整）
• --gateway：指定网关地址（根据实际网络规划调整）

完整运行脚本

以下是完整的容器启动脚本，包含环境检查、网络配置、容器管理等功能：

bash
#!/bin/bash

# 生成随机MAC地址（第一段固定为02/06/0A/0E中的一个）
get_random_mac ()
{
    if [ "$SHELL" == "/bin/bash" ];then
        MACADDR=$(printf "06:%02X:%02X:%02X:%02X:%02X\n" $[RANDOM%255] $[RANDOM%255] $[RANDOM%255] $[RANDOM%255] $[RANDOM%255])
    else
        uuid=$(cat /proc/sys/kernel/random/uuid)
        mac1="0E"
        mac2=${uuid:26:2}
        mac3=${uuid:28:2}
        mac4=${uuid:30:2}
        mac5=${uuid:32:2}
        mac6=${uuid:34:2}
        MACADDR=$(echo "$mac1:$mac2:$mac3:$mac4:$mac5:$mac6" | tr '[a-z]' '[A-Z]')
    fi
}

# 镜像参数配置
IMG_NAME=unifreq/openwrt-aarch64
IMG_TAG=latest
PREV_IMG_TAG=latest  # 如需升级，可指定旧版本标签

# 检查macvlan网络是否存在，不存在则创建
MACNET=$(docker network ls | grep macnet | wc -l)
PARENT="eth0"        # 物理网络接口
SUBNET="192.168.3.0/24"  # 子网
GATEWAY="192.168.3.1"    # 网关
IP="192.168.3.23"        # 容器IP地址
if [ $MACNET -eq 0 ];then
        docker network create -d macvlan -o parent="$PARENT" --subnet "$SUBNET" --gateway "$GATEWAY" macnet
fi

# 停止并删除旧容器（如有）
docker stop openwrt-${PREV_IMG_TAG} 2>/dev/null
docker rm openwrt-${PREV_IMG_TAG} 2>/dev/null

# 生成随机MAC地址
get_random_mac
echo "生成的MAC地址: $MACADDR"

# 获取主机内核版本，用于内核模块映射（r21.10.01及后续版本需要）
KERNEL_VERSION=$(uname -r)

# 启动容器
docker run --name openwrt-$IMG_TAG \
        --restart always \
        --network macnet \
        --mac-address $MACADDR \
        --ip $IP \
        -d --privileged=true \
        --ulimit nofile=16384:65536  \
        -v /lib/modules/${KERNEL_VERSION}:/lib/modules/${KERNEL_VERSION} \
        $IMG_NAME:$IMG_TAG

# 首次运行需修改默认IP地址（与容器IP保持一致）
docker exec openwrt-${IMG_TAG} sed -e "s/192.168.1.1/${IP}/" -i /etc/config/network

# 重启容器使配置生效
docker restart openwrt-${IMG_TAG}

参数说明

turboacc功能开启说明

对于r21.10.01及后续版本，如需开启turboacc完整功能，必须添加内核模块目录映射：

bash
-v /lib/modules/$(uname -r):/lib/modules/$(uname -r)

该映射将主机的内核模块目录挂载到容器中，确保turboacc所需的内核模块正常加载。

首次配置

容器启动后，可通过浏览器访问配置的IP地址（如示例中的192.168.3.23）进入OpenWrt管理界面，默认用户名为root，默认密码为空（首次登录需设置密码）。

容器管理

• 查看容器状态：docker ps | grep openwrt
• 进入容器命令行：docker exec -it openwrt-latest /bin/sh
• 重启容器：docker restart openwrt-latest
• 停止容器：docker stop openwrt-latest
• 删除容器：docker rm openwrt-latest

注意事项

• 物理网络接口（parent参数）需根据实际环境调整（如eth0、wlan0等）
• 子网、网关和IP地址需根据实际网络规划修改，避免IP冲突
• 内核模块映射仅r21.10.01及后续版本需要，旧版本可省略该参数
• 特权模式（--privileged=true）是必要的，确保网络功能正常运行