Ozero-Tab

【开源推荐】OpenWrt一键安装Docker与Arcane轻量级管理面板

随着 OpenWrt 迈入全新的 25.12+ 版本(全面拥抱 apk 包管理器时代),官方原版系统凭借干净、稳定、高效的特点吸引了越来越多的小伙伴。不过,很多刚从定制固件(如 iStoreOS 或 ImmortalWrt)转回原版的小伙伴,总会觉得少了点什么——比如日常离不开的 Docker、好用的软件中心,以及一个能优雅管理容器的 Web 面板。

今天就给大家分享一个极其优雅的官方原版 OpenWrt 首次安装辅助脚本,只需一行命令,就能轻松搞定存储扩容、iStore 软件中心,并一键部署目前非常火爆的轻量级 Docker 面板 Arcane

在教程开始前,特别感谢 一瓶奶油(NaiYou) 大佬提供的 OpenWrt、iStoreOS、ImmortalWrt 等多平台一键辅助脚本源码,大大降低了原版 OpenWrt 的上手门槛!

一、 为什么选择 Arcane 面板?

以往我们在 OpenWrt 上管理 Docker,要么使用老牌的 Portainer(体积大、吃内存、界面偏向专业运维),要么使用 Dockerman(UI 稍显过时、有些固件兼容性不佳)。

Arcane 则是专门为家庭服务器和软路由打造的新一代轻量级 Docker 管理面板。它具备以下硬核优势:

  1. 极致轻量:基于现代 Web 技术构建,UI 极其美观(现代化清爽设计),且内存占用极低,非常适合跑在软路由这类硬件资源宝贵的设备上。

  2. 原生集成 Compose:完美支持 Docker Compose 项目管理。你可以直接在面板里编写、修改 compose.yaml,一键启动和停止项目。

  3. 环境深度适配:脚本将其无缝集成进 OpenWrt 的 LuCI 界面,并在左侧生成一级菜单入口。

  4. 智能网络优化:Arcane 默认采用 host 网络模式,彻底避开 OpenWrt 在 nftables 防火墙兼容层下常见的端口映射“LAN 无法访问”玄学问题。

二、 准备工作(非常重要!)

在用 Docker 之前,我们必须要解决一个问题:扩容。 官方原版 OpenWrt 默认的系统空间往往只有几百兆,而 Docker 镜像动辄几百兆甚至几个G,直接安装必定会爆空间。

建议遵循以下执行顺序: 系统初始化 ➡️ Overlay 存储扩容 ➡️ 安装 Docker 及 Arcane 面板

三、 一键安装实战步骤

大佬提供的脚本非常贴心地为国内网络做了优化,提供了 GitHub 和 Gitee 双源镜像。

1. 运行一键菜单

打开你的 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-easy

GitHub 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 即可。

2. 玩转快捷菜单功能

输入命令后,你将看到一个清晰的中文交互菜单:

  • 第 1 步:执行“基础初始化”(设置中文包、时区、安装常用工具)。

  • 第 2 步:执行“自定义 overlay 扩容”。脚本会自动检测你的剩余未分配磁盘空间,引导你格式化为 ext4 并挂载,扩容完成后请根据提示重启软路由

  • 第 3 步(可选):安装 iStore 软件中心,让原版 OpenWrt 秒变应用商店固件。

3. 一键部署 Docker & Arcane 面板

重启软路由并重新进入 openwrt-easy 菜单后,选择 4. 一键安装/ 更新 Arcane

脚本在后台为你默默做好了这些底层优化:

  • 自动检测系统环境,并顺带安装 dockerddockerdocker-compose 环境。

  • 智能存储防坑:自动检测你的挂载点。如果发现你的 Docker 目录在纯 overlayfs 上(会触发低效的 vfs 存储驱动,导致 NPM 等大镜像无法部署),脚本会智能地将 Docker 数据根目录指定到真实的 ext4 独立挂载点(如 /overlay/docker/opt/docker),大幅提升磁盘性能!

  • 网络防火墙补丁:自动删除 UCI 中冲突的 network.docker 接口,防止 OpenClash 或 PassWall 等插件将 Docker 误判为普通网卡而导致国内网络直连故障。同时自动补齐 lan -> docker 的转发规则。

四、 访问与体验 Arcane

安装完成后,你无需重启。

  1. 刷新你的 OpenWrt LuCI 网页后台,你会发现左侧导航栏多出了一个一级菜单——「Arcane」

  2. 点击它,或者在浏览器直接访问:http://你的软路由IP:3552

  3. 默认登录凭证

    • 账号arcane

    • 密码arcane-admin

    • 提示:首次登录后,请务必第一时间在右上角修改密码!

进入面板后,现代化的 UI 扑面而来。你可以在里面清晰地看到软路由的 CPU、内存占用,以及当前运行的容器。想要部署新的 Docker 容器时,直接新建一个项目并贴入 Docker Compose 代码即可,拉取镜像时它会完美走你软路由本机的网络出口,告别国内镜像源失效的烦恼。

五、 总结与鸣谢

原版 OpenWrt 配合优秀的辅助脚本,既保留了官方源码的纯净与稳定,又拥有了不输于定制固件的便利性。而 Arcane 的加入,更是让 Docker 容器管理变得赏心悦目。

最后,再次感谢 一瓶奶油(NaiYou) 大佬在开源社区的无私奉献,不仅维护了如此好用的一键集成源码(GitHub 项目:slobys/openwrt-official-one-click),还让无数使用 OpenWrt、iStoreOS、ImmortalWrt 的折腾党们少走了太多的弯路。

如果你也喜欢这个项目,不妨去给大佬的 GitHub 仓库点个 Star 支持一下吧!