Docker版OpenWrt旁路由安装设置教程

《 “Docker版OpenWrt旁路由安装设置教程” 》有 70 条评论

薯条说道：

2022年11月23日下午9:58

（win11 x86）为啥在创建容器的时候提示
Failed to run image.Error invoking remote method ‘docker-run-container’:Error:(HTTP code 400)unexpected No command specified
纯命令行的时候输入docker run –restart always –name openwrt kiddin9_openwrt -d –network openwrt –privileged /sbin/init 提示命令有问题

登录以回复
- sworn说道：
  
  2025年9月28日下午10:50
  
  正确命令是：docker run –restart always –name openwrt -d –network openwrt –privileged /sbin/init
  
  登录以回复
  - sworn说道：
    
    2025年9月28日下午10:53
    
    奇怪，我明明打了两个破折号，发出来就变成一个了，而且还不是正确的破折号，怪不得复制出来的命令不对，试一下打三个破折号，看看发出来是什么样的：docker run —restart always —name openwrt —d —network openwrt —privileged /sbin/init
    
    登录以回复
    - sworn说道：
      
      2025年9月28日下午10:54
      
      还是不对，三个破折号变成了更长的单个破折号，还是自己手打命令吧，别复制了，应该是两个短破折号
      
      登录以回复
可乐说道：

2022年11月25日下午11:00

试了好几次，都失败在创建容器的时候了，折腾好久容器创建完成了，但是还是不显示openwrt后台登录IP，救救孩子吧！！

登录以回复
betta说道：

2022年12月3日下午3:43

已经在raspberry 3b上进行了docker部署，旁路由替换了之前一直使用的sulinggg/openwrt:latest。

登录以回复
betta说道：

2022年12月3日下午3:45

docker exec -it openwrt bash
进入容器后台
修改网络
vim /etc/config/network
修改“lan”部分配置，需要结合你的网络ip设置
config interface ‘lan’
option proto ‘static’
option ipaddr ‘192.168.123.100’
option netmask ‘255.255.255.0’
option ip6assign ’60’
option gateway ‘192.168.123.1’
option broadcast ‘192.168.123.255’
option dns ‘192.168.123.1’

登录以回复
ajiao2000说道：

2022年12月7日下午6:34

docker run –restart always –name supes_openwrt -d –network macnet –privileged supes_openwrt /sbin/init

登录以回复
是不是缺少一步了说道：

2022年12月8日下午10:07

是不是缺少一步了，下载固件后怎么就加载了，存哪里啊？或者怎么导入dacker啊

登录以回复
llllcat说道：

2022年12月9日下午2:56

docker run –restart always –name openwrt kiddin9_openwrt -d –network openwrt –privileged /sbin/init

登录以回复
wrt说道：

2023年1月11日下午12:11

docker import openwrt-x86-64-generic-rootfs.tar.gz kiddin9_openwrt
docker run –restart always –name openwrt -d –network myvlan –privileged 022a387e984a43922a7f596dd5ee63d24cf453e62e1e918bf8d2ae8a351c0eb5 /sbin/init
docker exec -it openwrt bash

登录以回复
MUMUZI说道：

2023年1月17日下午1:55

vmdk转换成vhdx后怎么在hyper-v中设置网卡，还有启动服务

登录以回复
happyman6776说道：

2023年1月21日上午10:29

下载下来不是img镜像呢

登录以回复
kv3000lulu说道：

2023年1月28日上午6:00

Since this doesn’t use overlayfs, which path should I mount for persistent storage?

登录以回复
xinmans说道：

2023年2月10日下午9:33

docker run -d –restart always –name openwrt_77 –ip=192.168.31.77 –network br0 –privileged openwrt_77 /sbin/init

登录以回复
panna说道：

2023年2月25日下午3:43

启动镜像那出错
# docker run –restart always –name openwrt kiddin9_openwrt -d –network openwrt –privileged /sbin/init
docker: invalid reference format.
See ‘docker run –help’.

登录以回复
panna说道：

2023年2月25日下午8:33

已经正常安装好openwrt了,但是有个问题,在docker内的openwrt开了bypass等梯子应用会没效果.

登录以回复
antiparable说道：

2023年3月17日下午1:49

同样问题，luci正常工作，旁路由无效，不能留学

登录以回复
antiparable说道：

2023年3月17日下午1:51

invalid reference的话，首先-改成– 然后network后面加等于号变成network=openwrt

登录以回复
antiparable说道：

2023年3月17日下午2:10

留学问题暂且已经解决，目前采用的方法（pwall)是：
1，把dns方式改成dns2socks
2，不要使用glist，用not china list

登录以回复
- atiny说道：
  
  2024年9月11日下午11:44
  
  我也碰到相同的问题，请问怎么解决
  
  登录以回复
chyinzi说道：

2023年3月20日上午11:06

这教程的命令，经过验证么？
root@Docker:/# docker run –restart always –name openwrt chyinzi_openwrt -d –network openwrt –privileged /sbin/init
docker: invalid reference format.
See ‘docker run –help’.

登录以回复
chyinzi说道：

2023年3月20日下午12:30

docker run –name openwrt –network openwrt –restart=always –privileged=true -d chyinzi_openwrt /sbin/init 不报错了

登录以回复
duqn说道：

2023年5月5日下午6:53

有人在RouterOS容器里旁路由使用吗？之前在7.4版本还能用，升级到7.8以后就不能用了，哪位大神指导一下
之前是这么用的：
1. 导入本地docker环境 cat openwrt.tar.gz | docker import – openwrt:latest
2. 保存镜像 docker save -o /…/openwrt.tar openwrt
3.上传openwrt.tar 镜像文件拖拽到RouterOS > File List
4. 添加镜像到容器
/container/add file=openwrt.tar interface=veth1 hostname=OpenWrt cmd=/sbin/init root-dir=container/openwrt

登录以回复
斐讯N1说道：

2023年5月6日下午11:35

问下大佬，N1单臂主路由ipv6怎么开启，静待答复，谢谢

登录以回复
能不能出一个wsl2版本的镜像说道：

2023年5月13日上午12:12

WSL2下直接运行openwrt方法记录：https://zhuanlan.zhihu.com/p/499799037

能不能出一个wsl2版本的镜像，试验了一下，openwrt-x86-64-generic-rootfs.tar.gz可以被运行
但是不能启动web，貌似有很多配置文件需要修改，实在不太清楚这个封装版本的设计逻辑。

登录以回复
- balder1840说道：
  
  2023年9月6日上午9:43
  
  使用rootfs.tar.gz即可，具体步骤看这里https://zhuanlan.zhihu.com/p/652370893。有各种错误是因为wsl2有自己的Init流程，而OpenWrt需要从/sbin/init开始，然后启动procd （pid 1）。
  
  登录以回复
灿烂说道：

2023年7月23日下午12:29

armbian用这个命令启动成功：
docker run -d –restart=always –name=openwrt –network=openwrt –privileged=true kiddin9_openwrt /sbin/init

登录以回复
xfygogo说道：

2023年8月13日下午4:38

树莓派4B上导入docker，容器无法正常分配到ip，改配置也没有效果，不知道什么原因。用sulinggg/openwrt:rpi4镜像就没问题。

登录以回复
- 得到说道：
  
  2023年9月2日上午10:34
  
  同样问题解决了吗
  
  登录以回复
  - balder1840说道：
    
    2023年9月6日上午10:27
    
    ulinggg/openwrt:rpi4是基于Openwrt 19.x, 这里的是23.x, 我用时候发现/etc/config/network配置有点小小不同，用下面的这个试下：
    config interface ‘loopback’
    option device ‘lo’
    option proto ‘static’
    option ipaddr ‘127.0.0.1’
    option netmask ‘255.0.0.0’
    
    config globals ‘globals’
    
    config device
    option name ‘br-lan’
    option type ‘bridge’
    list ports ‘eth0’
    
    config interface ‘lan’
    option device ‘eth0’
    option proto ‘static’
    option ipaddr ‘192.168.8.2’
    option gateway ‘192.168.8.1’
    option netmask ‘255.255.255.0’
    option ip6assign ’60’
    list dns ‘127.0.0.1
    
    登录以回复
  - 大水怪说道：
    
    2023年9月7日下午10:20
    
    在unraid上的docker上部署总是无法访问后台，docker管理页面看不到端口转发的ip，换成别的镜像就行
    
    登录以回复
得到说道：

2023年9月2日上午10:33

同样问题解决了吗

登录以回复
opwrt 封闭问题说道：

2023年9月5日下午11:34

请问在同一个 docker里，其他容器怎么连接到 macvlan 网络模式的 openwrt ，镜像数据通信，比如ping ，@！

登录以回复
- balder1840说道：
  
  2023年9月6日上午10:17
  
  docker内容器一般走的是host的网络(docker0),所以只要Host跟Openwrt Container互通，其他容器就可以用openwrt这个做路由上网了。
  与宿主机互通：
  sudo ip link set eth0 promisc on
  sudo ip link add my_macvlan link eth0 type macvlan mode bridge
  sudo ip addr add 192.168.8.6 dev my_macvlan
  sudo ip link set my_macvlan up
  sudo ip route add 192.168.8.2 dev my_macvlan
  宿主机网关及DNS设置为openwrt:
  sudo ip route add default via 198.168.8.2 dev my_macvlan metric 1
  resolv.conf设置nameserver 192.168.8.2
  
  以上IP地址按实际情况替换。
  重启后以上设置会丢失，自己查询持久化方案.
  
  登录以回复
  - opwrt 封闭问题说道：
    
    2023年9月8日下午9:55
    
    你好哥哥，可以给我一个详细的教程访问吗！我opwrt 容器的ip 是 192.168.1.89 。我另外一个需要连接opwrt 上网的容器是 192.168.1.88，也就是宿主机的ip ，假如我只需要容器名字为 jf 的代理ip 到 opwrt 上网，该怎么弄，因为opwrt 是 macvlan 网络，我连接不到他在容器logs 里面查看到。希望能得到您的回复！详细祝您平安幸福
    
    登录以回复
opwrt 封闭问题说道：

2023年9月8日下午9:58

sudo ip addr add 192.168.8.6 dev my_macvlan 请问这个 192.168.8.6 是什么ip 呢？代表什么我不是很明白，不好意思， sudo ip route add 192.168.8.2 dev my_macvlan这个 192.168.8.2 是什么ip 呢谢谢

登录以回复
opwrt 封闭问题说道：

2023年9月8日下午10:02

environment:
– TZ=Asia/Shanghai
– ALL_PROXY=http://192.168.1.89:7890
– NO_PROXY=http://192.168.1.89:7890
– HTTP_PROXY=http://192.168.1.89:7890
– JELLYFIN_PublishedServerUrl=192.168.1.88 #optional 我是在单个容器里面添加代理 hppt 上网的，谢谢希望你能帮助我

登录以回复
Simon chan说道：

2023年10月25日下午5:56

docker run -d –restart=always –name=openwrt -network=openwrt -privileged=true kiddin9_openwrt /sbin/init
docker: invalid reference format.
See ‘docker run –help’.
一直报错

登录以回复
raspberry-pi说道：

2023年11月25日上午12:31

树莓派4B启动容器日志显示：
Failed to find the folder holding the modules
Failed to find the folder holding the modules
Failed to find the folder holding the modules
Failed to find the folder holding the modules

登录以回复
[email protected]说道：

2023年11月28日下午3:59

搞了半天，就是登不进opwrt

登录以回复
pearsonfrancis说道：

2023年11月29日下午4:49

为啥定制后，反而还进不去后台了，定制的ip根本无法访问到，进入不了系统！！！

登录以回复
- zengkid说道：
  
  2023年12月22日下午6:47
  
  看日志应该是uhttp启动有问题。logread | less 看看
  
  登录以回复
benben说道：

2024年3月21日下午2:04

【sh: write error: I/O error】一直报这个错误，咋解决

登录以回复
cyl003说道：

2024年5月2日下午1:24

怎么样安装到 emmc

登录以回复
138668说道：

2024年6月9日上午12:52

openwrt使用旁路由登录IP进不了后台，lan也无法通网，救救孩子吧！！

登录以回复
lxtdd说道：

2024年7月19日下午12:27

点击下载固件怎么会404，晕了？

登录以回复
lxtdd说道：

2024年7月19日下午2:22

请问各位定制版OPENWRT的SSH 账户和密码分别多少？也不知道怎么设置啊

登录以回复
lxtdd说道：

2024年7月25日下午8:58

最新的版本，挂载USB移动硬盘（ntfs格式）有问题，不能显示中文目录以及中文文件

登录以回复
atiny说道：

2024年9月12日上午12:10

不能科学，如何解决 DOCKER 里的

登录以回复
gaoyu说道：

2024年9月26日上午3:11

casaos如何安装下载的openwrt.tar.gz出个详细安装教程，最好是视频，一步一步教学式操作

登录以回复
naxiaozishuo说道：

2024年10月1日上午10:39

docker: invalid reference format.
创建容器一直提示这个玩客云armbian

登录以回复
- john1234说道：
  
  2024年11月10日下午10:26
  
  我也是玩客云armbian,我成功安装了这里的docker openwrt. 教程有点简单，最后docker run有错误，docker run -d –restart=always –name=openwrt –network=openwrt –privileged kiddin9_openwrt /sbin/init
  
  登录以回复
lu Jack说道：

2025年2月19日下午3:17

完整的操作命令
“`
sudo ip link set eth0 promisc on
sudo docker network create -d macvlan –subnet 192.168.1.0/24 –gateway 192.168.1.1 -o parent=eth0 openwrt
sudo docker run –restart always –name openwrt -d –network openwrt –ip 192.168.1.10 –privileged kiddin9_openwrt /sbin/init
sudo docker exec -it openwrt /bin/bash

vim /etc/config/network

config interface ‘lan’
option device ‘br-lan’
option proto ‘static’
option gateway ‘192.168.1.1’
option ip6assign ’60’
option ipaddr ‘192.168.1.10’
option netmask ‘255.255.255.0’
option peerdns ‘0’
list dns ‘192.168.1.1’

sudo /etc/init.d/network restart
“`

登录以回复
- lu Jack说道：
  
  2025年2月19日下午3:18
  
  少了导入镜像 sudo docker import kwrt-02.05.2025-bcm27xx-bcm2711-rpi-4-rootfs.tar.gz kiddin9_openwrt
  
  登录以回复
  - bnmkl说道：
    
    2025年3月2日下午11:48
    
    玩客云的docker的openwrt的passwall插件怎么升级？软件源报错，需要什么软件包？
    
    登录以回复
ccc0120说道：

2025年3月8日下午4:48

按流程做了，无法打开web界面，看网卡也没有eth0，同样的操作，sulinggg的image无问题，晕了。。

登录以回复
- ribi666说道：
  
  2025年3月23日下午7:03
  
  开个远程我帮你搞~~~
  
  登录以回复
wscg0814说道：

2025年8月26日上午12:38

sha256sum: can’t open ‘/sys/class/block/mmcblk1/device/cid’: No such file or directory
/bin/board_detect: /etc/board.d/02_network: line 273: arithmetic syntax error
/bin/board_detect: /etc/board.d/02_network: line 229: arithmetic syntax error
mount: mounting /dev/mmcblk2p1 on /mnt failed: Invalid argument

登录以回复
SINOSMG说道：

2025年9月16日下午10:40

哪位知道群晖的7.2系统的docker版用哪个镜像，为什么我用的最后那个.tar.gz的镜像上传到群里container时提示文件类型无效

登录以回复
Gaeroce说道：

2025年11月15日上午11:12

部署完好像时间不能同步，相差8小时

登录以回复
godfather1103说道：

2025年11月15日下午10:25

玩客云刷机armbian之后，用docker运行kwrt，里面passwall或者openclash路由器本机代理不起作用，只能是开启端口之后，在浏览器中搭配SwitchyOmega之类的插件使用，有谁知道这个怎么解决吗？

登录以回复
MRLSOPW说道：

2025年12月2日下午4:09

大佬，能不开放一个赞助用户选择分支的功能···万分感谢

登录以回复
dsqs666说道：

2026年1月4日上午4:25

openwrt.ai 在线如何定制24.10版本的固件，定制指定版本的固件的入口在哪？默认生成最新版本 25.12 可能不兼容，请支持历史版本的固件定制和生成，

登录以回复
dsqs666说道：

2026年1月4日上午4:27

默认生成的 25.12 版本，有些固件不兼容功能有问题，请支持历史版本 24.10 版本的固件定制与生成，

登录以回复
wcinc2008说道：

2026年1月12日下午6:48

armv7的设备不支持吗？只看到N1，好像是armv8的

登录以回复
江浸月说道：

2026年1月22日下午3:00

定制固件后，只能用命令行登录，网页没有显示，登不了，请问是什么原因。

登录以回复
- shenyao说道：
  
  2026年3月7日下午5:47
  
  不要勾选docker就行，我进去看到是 luci-lib-docker这个没有，在系统软件包里面看到的
  
  登录以回复
iff说道：

2026年3月7日下午11:10

最新版固件不能自定义后台IP地址，自定义的话固件刷入后获取不到IP地址，无法使用。

登录以回复
iff说道：

2026年3月7日下午11:13

docker也有问题

登录以回复