Skip to content

iStoreOS使用好用斋懒人包:一键安装46个Docker程序并统一管理 ​

📺 本图文教程由视频整理而成,对应的参考视频:iStoreOS如何使用好用斋懒人包~一键安装46个docker程序+一键升级~。如需查看更详细、更具体的操作演示,可观看原视频。

场景:iStoreOS 上已经装好 Docker,想一次性把 Jellyfin、Emby、OpenList、qBittorrent 等常用容器全部装好,并有一个统一的入口页面管理它们,以后升级也不用逐个操作。

提示:本教程配套的操作文档,可在好用斋官网 → 网盘分享(提取码 547)中下载。

整套流程实际只有五步:在好用斋官网上生成配置 → 上传脚本 → 一条命令启动 → 导入导航面板 → 需要时一键升级。前后两步属于准备工作,第一次使用请先完成。

第一步:准备 iStoreOS 环境 ​

  1. 安装好 iStoreOS,能够正常进入后台。
  2. 挂载大硬盘,并把 Docker 数据目录迁移到大硬盘。

第二点不能省:全部 46 个程序的镜像加上运行数据,占用空间相当大,如果 Docker 还放在系统盘,很容易把根分区写满。具体挂载与迁移方法可参考iStoreOS的基础设置。

第二步(可选):安装 KSpeeder 加速镜像拉取 ​

KSpeeder 用于加速 Docker 镜像拉取。如果未安装它、本地网络又不够通畅,后面的镜像可能根本拉不下来,整个流程会卡在 docker compose up -d。

网络条件良好时可以跳过;国内网络环境建议先装好,安装方法见Docker镜像加速专家KSpeeder。

第三步:在懒人包页面生成配置 ​

打开好用斋官网,点击「Docker 懒人包」,页面上只需要填写三项:

参数填法
NAS 系统选择 iStoreOS
架构x86 设备选 x86_64,ARM 设备选 arm64
IP 地址填写 iStoreOS 的局域网地址,例如 192.168.31.233,必须准确

IP 地址一定要核对:生成的 compose 脚本与导航面板配置都会把该地址写进去,填错会导致装好的程序无法在导航面板里正常跳转。

架构按设备实际情况选择。ARM 设备多为 4G 内存,装不下全部程序,只能按需选装;另外极少数镜像只有 x86 版本,在 ARM 下对应卡片会变灰、无法勾选。

随后在下方按分类勾选需要的程序,例如 Jellyfin、CD2、OpenList 等,勾选后右侧会实时生成对应的 compose 内容。只用单个程序时,也可以切到 Docker CLI 页签复制单条命令直接运行。

在懒人包页面填写系统、架构和 IP,勾选程序后右侧生成 46 个程序的 compose 脚本

为了演示完整效果,本教程点击「全选」,右上角显示共 46 个程序。然后点击两个下载按钮:

  1. 「下载文件」得到 docker-compose.yml,这是批量安装脚本。
  2. 「下载导航配置」得到 sun-panel.json,这是导航面板的配置文件。

也可以只点「复制内容」,把脚本内容直接粘贴到自己建立的compose文件中,效果相同。

第四步:新建目录并上传脚本 ​

  1. 打开 iStoreOS 后台首页,向下滑动找到「文件管理」。
  2. 依次进入 mnt → mydisk,点击右上角「新建文件夹」,输入 compose。
  3. 进入 compose,再新建一个名为 all 的文件夹。
  4. 进入 all,点击「上传」,把刚才下载的 docker-compose.yml 拖入或选中上传。

建议新手就使用 mnt/mydisk/compose/all 这个路径,与懒人包页面默认的「脚本位置」一致,后面的升级命令可以直接复用,不需要改动。

第五步:一条命令启动全部容器 ​

回到 iStoreOS 首页,向下滑动点击「终端」,用 root 登录。密码输入时屏幕没有任何显示(连星号都没有),输完直接回车即可。

进入脚本所在目录并确认文件在:

bash
cd /mnt/mydisk/compose/all
ls

能看到 docker-compose.yml 说明目录正确。接着执行:

bash
docker compose up -d

命令会自动拉取缺失的镜像并创建、启动容器。已经拉取过的镜像会直接跳过,只有新镜像需要等待;全部镜像都未拉取过时,等待时间取决于网络状况,中途不要关闭终端。

终端里逐个出现 Container xxx Started,就表示容器已启动。

第六步:导入 Sun-Panel 导航面板 ​

浏览器访问 http://<iStoreOS的IP>:3002,例如 http://192.168.31.233:3002,即可打开 Sun-Panel。

默认账号在懒人包页面的「系统工具」→「导航页 Sun-Panel」中可以查到:账号为 admin@sun.cc,密码为 12345678。首次登录后建议尽快修改密码。

刚登录时页面是空白的,按下面顺序导入配置:

  1. 点击右上角设置图标,选择「导出导入」。
  2. 选择「导入配置」,选中下载的 sun-panel.json,点击继续。
  3. 进入「分组管理」,把原有的默认分组删除。
  4. 关闭设置,刷新页面。

刷新后就能看到 46 个程序的入口:前两个固定为 iStoreOS 系统和 1Panel(需额外安装才可用),其余按顺序排列,Jellyfin、Emby 等点击即可打开对应程序。

导入配置后的 Sun-Panel 导航页,集中展示全部程序入口

图标上标注了默认账号密码;没有标注的多数需要本地自行注册,OpenList 之类则要查看容器日志获取初始密码。

右上角的小地球图标用于切换模式:公网模式下点击图标打开程序本身,内网模式下点击图标会跳转到该程序对应的参考视频,不清楚某个程序怎么用可以直接点进去看。需要修改某个按钮的名称或链接,在图标上右键选择「编辑」即可。

个性化设置(背景图、标题文字、边距等)不是必须的,按喜好调整即可。

想要了解更多内容也可以直接查看sun-panel对应的参考视频。

第七步:一键升级 ​

以后想升级懒人包里的程序,回到懒人包页面,在「脚本位置」处先确认路径,默认为 /mnt/mydisk/compose/all,然后点击「全部升级」,右侧会生成升级脚本。

点击「复制内容」,到终端里右键粘贴、回车。脚本会检查每个镜像是否有新版本,有更新则拉取新镜像并重建容器。

只想升级其中几个程序时,在「全部升级」右侧的「服务名称」框里填写服务名(不是容器名),用空格分隔,例如 jellyfin emby,再复制生成的命令执行。

注意

这里填写的是 服务名称,不是容器名称。服务名在 compose 文件的 services: 下一级,容器名在 container_name 字段,填错就不会生效。

资源占用参考 ​

46 个程序全量安装的实测数据:50G 的 Docker 空间已使用 38.5G,8G 内存占用约 73%。可见镜像与运行数据的开销都不小。

资源有限时不要全选,只勾选自己真正需要的程序,组成自己的懒人包即可。ARM 设备尤其要注意内存余量。

总结 ​

  1. 先装好 iStoreOS、挂载大硬盘并迁移 Docker,网络不佳时再补一个 KSpeeder。
  2. 懒人包页面只填系统、架构、IP 三项,IP 必须准确,勾选程序后下载 compose 脚本与导航配置。
  3. 脚本上传到 /mnt/mydisk/compose/all,终端里 docker compose up -d 一条命令启动全部容器。
  4. IP:3002 打开 Sun-Panel,导入 sun-panel.json、删掉原分组再刷新,全部入口就位。
  5. 升级同样在懒人包页面生成命令,全部升级或按服务名部分升级。

参考视频 ​

好用斋官网 ​

https://haoyongzhai.com