kangkang223/openwrt

OpenWrt-Docker For 极空间Nas

镜像概述和主要用途

本镜像基于 https://hub.docker.com/r/sulinggg/openwrt 修改，主要解决极空间Nas在无特权环境下的部分问题（其他设备同样适用），如 /etc/resolv.conf 无法写入正确DNS地址等。同时增加环境变量以简化配置流程，并修复luci缓存异常问题。

核心功能和特性

• 适配极空间Nas无特权环境，解决DNS配置写入问题
• 提供环境变量支持，简化网络配置流程
• 修复luci管理页面缓存异常问题
• 支持x86架构设备通用

版本说明

kangkang223/openwrt:z4

基于x86_64架构，适用于x86设备通用

kangkang223/openwrt:z2

暂无相关信息

环境变量说明

## lan接口ip地址，会替换 /etc/config/network 中的lan接口 "option ipaddr" 配置
ENV LAN_ADDR 192.168.123.100

## lan接口网关，会替换 /etc/config/network 中的lan接口 "option gateway" 配置
ENV LAN_GATEWAY 192.168.123.1

## lan接口dns，会替换 /etc/config/network 中的lan接口 "option dns" 配置
ENV LAN_DNS 192.168.123.1

## dnsmasq的主机地址，由于openwrt默认启动该服务，这里只填写127.0.0.1即可，也可填写114.114.114.114等公共dns
## 该选项会被写入/etc/resolv.conf : nameserver 127.0.0.1
ENV DNS_MASQ_SERVER 127.0.0.1

环境变量说明

• LAN_ADDR: LAN接口IP地址，用于替换网络配置中的option ipaddr
• LAN_GATEWAY: LAN接口网关地址，用于替换网络配置中的option gateway
• LAN_DNS: LAN接口DNS地址，用于替换网络配置中的option dns
• DNS_MASQ_SERVER: dnsmasq服务的主机地址，将写入/etc/resolv.conf的nameserver

使用方法和配置示例

Docker运行示例

bash
docker run --privileged -e "LAN_ADDR=192.168.10.100" -e "LAN_GATEWAY=192.168.10.1" -e "LAN_DNS=192.168.10.1" --restart always --name openwrt -d --network macnet kangkang223/openwrt:z4 /sbin/init

参数说明

• --privileged: 赋予容器特权模式，确保网络配置正常
• -e: 设置环境变量，如LAN_ADDR、LAN_GATEWAY等
• --restart always: 容器退出时自动重启
• --name openwrt: 指定容器名称
• -d: 后台运行容器
• --network macnet: 指定网络模式（需根据实际环境调整）

常见问题解决

解决luci缓存异常问题

OpenWrt后端管理页面偶发以下异常：

/usr/lib/lua/luci/dispatcher.lua:417: Fatal: Indexcache is not sane!stack traceback: [C]: in function 'assert'        
/usr/lib/lua/luci/dispatcher.lua:417: in function 'createindex'        
/usr/lib/lua/luci/dispatcher.lua:452: in function 'createtree'        
/usr/lib/lua/luci/dispatcher.lua:188: in function 'dispatch'        
/usr/lib/lua/luci/dispatcher.lua:95: in function </usr/lib/lua/luci/dispatcher.lua:94>

解决方案：进入容器删除缓存或重启容器

bash
rm -r /tmp/luci-indexcache

Z4下路由模式