随着 OpenWrt 迈入全新的 25.12+ 版本(全面拥抱 apk 包管理器时代),官方原版系统凭借干净、稳定、高效的特点吸引了越来越多的小伙伴。不过,很多刚从定制固件(如 iStoreOS 或 ImmortalWrt)转回原版的小伙伴,总会觉得少了点什么——比如日常离不开的 Docker、好用的软件中心,以及一个能优雅管理容器的 Web 面板。
今天就给大家分享一个极其优雅的官方原版 OpenWrt 首次安装辅助脚本,只需一行命令,就能轻松搞定存储扩容、iStore 软件中心,并一键部署目前非常火爆的轻量级 Docker 面板 Arcane!
在教程开始前,特别感谢 一瓶奶油(NaiYou) 大佬提供的 OpenWrt、iStoreOS、ImmortalWrt 等多平台一键辅助脚本源码,大大降低了原版 OpenWrt 的上手门槛!
以往我们在 OpenWrt 上管理 Docker,要么使用老牌的 Portainer(体积大、吃内存、界面偏向专业运维),要么使用 Dockerman(UI 稍显过时、有些固件兼容性不佳)。
而 Arcane 则是专门为家庭服务器和软路由打造的新一代轻量级 Docker 管理面板。它具备以下硬核优势:
极致轻量:基于现代 Web 技术构建,UI 极其美观(现代化清爽设计),且内存占用极低,非常适合跑在软路由这类硬件资源宝贵的设备上。
原生集成 Compose:完美支持 Docker Compose 项目管理。你可以直接在面板里编写、修改 compose.yaml,一键启动和停止项目。
环境深度适配:脚本将其无缝集成进 OpenWrt 的 LuCI 界面,并在左侧生成一级菜单入口。
智能网络优化:Arcane 默认采用 host 网络模式,彻底避开 OpenWrt 在 nftables 防火墙兼容层下常见的端口映射“LAN 无法访问”玄学问题。
在用 Docker 之前,我们必须要解决一个问题:扩容。 官方原版 OpenWrt 默认的系统空间往往只有几百兆,而 Docker 镜像动辄几百兆甚至几个G,直接安装必定会爆空间。
建议遵循以下执行顺序: 系统初始化 ➡️ Overlay 存储扩容 ➡️ 安装 Docker 及 Arcane 面板
大佬提供的脚本非常贴心地为国内网络做了优化,提供了 GitHub 和 Gitee 双源镜像。
打开你的 SSH 工具(如 Putty、Xshell 或 Termius),连接到 OpenWrt 软路由,输入以下命令:
Gitee Curl 源:
curl -kfsSL -o /usr/bin/openwrt-easy https://gitee.com/naiyou88/openwrt-official-one-click/raw/main/bootstrap.sh && chmod +x /usr/bin/openwrt-easy && RAW_BASE=https://gitee.com/naiyou88/openwrt-official-one-click/raw/main openwrt-easy
Gitee Wget 源:
wget -qO /usr/bin/openwrt-easy https://gitee.com/naiyou88/openwrt-official-one-click/raw/main/bootstrap.sh && chmod +x /usr/bin/openwrt-easy && RAW_BASE=https://gitee.com/naiyou88/openwrt-official-one-click/raw/main openwrt-easyGitHub Curl 源:
curl -kfsSL -o /usr/bin/openwrt-easy https://raw.githubusercontent.com/slobys/openwrt-official-one-click/main/bootstrap.sh && chmod +x /usr/bin/openwrt-easy && openwrt-easy
GitHub Wget 源:
wget -qO /usr/bin/openwrt-easy https://raw.githubusercontent.com/slobys/openwrt-official-one-click/main/bootstrap.sh && chmod +x /usr/bin/openwrt-easy && openwrt-easy注:后续如果需要再次调出菜单,直接在终端输入 openwrt-easy 即可。
输入命令后,你将看到一个清晰的中文交互菜单:
第 1 步:执行“基础初始化”(设置中文包、时区、安装常用工具)。
第 2 步:执行“自定义 overlay 扩容”。脚本会自动检测你的剩余未分配磁盘空间,引导你格式化为 ext4 并挂载,扩容完成后请根据提示重启软路由。
第 3 步(可选):安装 iStore 软件中心,让原版 OpenWrt 秒变应用商店固件。
重启软路由并重新进入 openwrt-easy 菜单后,选择 4. 一键安装/ 更新 Arcane。
脚本在后台为你默默做好了这些底层优化:
自动检测系统环境,并顺带安装 dockerd、docker、docker-compose 环境。
智能存储防坑:自动检测你的挂载点。如果发现你的 Docker 目录在纯 overlayfs 上(会触发低效的 vfs 存储驱动,导致 NPM 等大镜像无法部署),脚本会智能地将 Docker 数据根目录指定到真实的 ext4 独立挂载点(如 /overlay/docker 或 /opt/docker),大幅提升磁盘性能!
网络防火墙补丁:自动删除 UCI 中冲突的 network.docker 接口,防止 OpenClash 或 PassWall 等插件将 Docker 误判为普通网卡而导致国内网络直连故障。同时自动补齐 lan -> docker 的转发规则。
安装完成后,你无需重启。
刷新你的 OpenWrt LuCI 网页后台,你会发现左侧导航栏多出了一个一级菜单——「Arcane」。
点击它,或者在浏览器直接访问:http://你的软路由IP:3552。
默认登录凭证:
账号:arcane
密码:arcane-admin
提示:首次登录后,请务必第一时间在右上角修改密码!
进入面板后,现代化的 UI 扑面而来。你可以在里面清晰地看到软路由的 CPU、内存占用,以及当前运行的容器。想要部署新的 Docker 容器时,直接新建一个项目并贴入 Docker Compose 代码即可,拉取镜像时它会完美走你软路由本机的网络出口,告别国内镜像源失效的烦恼。
原版 OpenWrt 配合优秀的辅助脚本,既保留了官方源码的纯净与稳定,又拥有了不输于定制固件的便利性。而 Arcane 的加入,更是让 Docker 容器管理变得赏心悦目。
最后,再次感谢 一瓶奶油(NaiYou) 大佬在开源社区的无私奉献,不仅维护了如此好用的一键集成源码(GitHub 项目:slobys/openwrt-official-one-click),还让无数使用 OpenWrt、iStoreOS、ImmortalWrt 的折腾党们少走了太多的弯路。
如果你也喜欢这个项目,不妨去给大佬的 GitHub 仓库点个 Star 支持一下吧!