在 iStoreOS 上装 Docker 应用，第一步不是挑应用，而是先把 Docker 迁走。
这话不是我说的，是官方文档把这句写在常见问题的第一行：如果用 Docker 插件，必须在首页用 Docker 迁移向导，迁移到非根目录的独立的硬盘分区。iStoreOS官方文档原因很直白，Docker 镜像、容器日志、下载缓存全堆在根目录的话，用不了几周就会遇到空间不足装不了东西的问题，B 站官方教程视频的评论区就有人吐槽，自己啥都没装，磁盘占用就到了 100G。哔哩哔哩
所以这篇不聊装什么应用，先把更前置的事说清楚：迁移做完之后，装 Docker 应用的三条路，走哪条、各有什么坑、你这种用法该选哪条。
动手前的三件事
第一件，Docker 迁移到独立硬盘分区，首页有向导，跟着点就行。没有硬盘的，至少挂个大容量 U 盘或移动硬盘——系统根目录只有 2G 左右，这是官方文档里专门列出来的常见问题，别指望根目录扛。iStoreOS官方文档
第二件，镜像加速。国内拉 Docker Hub 镜像慢、失败是常态，最好先备好加速再拉镜像。iStoreOS 官方团队自己就做了个加速工具叫 kspeeder，把加速服务打包进轻量容器部署，装好再拉镜像，体验差很多。GitHub这也是社区那些"一键懒人包"教程里反复强调的前置步骤：先挂大硬盘、迁移 Docker，再装加速。哔哩哔哩
第三件，如果你除了 Docker 还要装 iStore 商店里的插件，先把沙箱模式打开。官方原话：如果安装失败，可以通过沙箱模式回退到上个版本，插件根配置都不丢。iStoreOS官方文档手痒升级软件包之前也一样，先用沙箱试。
三条路，各有各的活法
路线一：iStore 商店里的 Docker 应用，走 DockerMan 图形化安装。
这是官方维护的路，点一下装好，端口、目录都给你配了默认值，适合"我就想用，不想懂"的人。但代价也有：应用版本偏保守，可调参数少，个别应用的默认值还有小坑——比如评论区就有人反馈，商店装的 Emby 默认 UID 权限会导致核显硬解不生效，要手动改成 root 权限。哔哩哔哩Jellyfin 装完扫媒体库 CPU 满载、硬解不生效的求助也一直有。选这条路，遇到问题先去官方文档和教程视频评论区翻，大多数都有现成答案。
路线二：一键脚本/懒人包。
B 站上热度很高的"好用斋懒人包"就是代表，一条命令装 46 个常用 Docker 程序，还能一键升级全部容器。哔哩哔哩玩影音库的还有小雅全家桶这类一键脚本。这条路的优势是快、全家桶齐，劣势是耦合度高：作者替你决定了镜像版本、端口、目录结构，出问题你要先读懂他的脚本；而且给路由器跑第三方脚本，本身就要过一遍脑子。它的评论区很能说明问题：有人第六步安装时直接提示 compose 不是 docker 命令，有人卡在 daemon 没启动，还有人重复装加速插件报冲突。想走这条路，建议先看脚本内容再执行，别闭眼复制。
路线三：自己手写 docker compose。
麻烦一点，但最自由，也最保值。目录怎么挂、端口怎么开、重启策略怎么写，全在自己手里；更重要的是，compose 文件就是几个纯文本——以后你从 24.10 换到 25.12，或者干脆换系统，这些文件直接带走重建。而商店插件在跨版本时的兼容性，得等生态跟上（25.12 尝鲜版换包管理器这事，前面已经有人踩过）。有一定 Linux 基础、打算长期玩的人，我建议最终都走到这条路上来，至少把关键应用捏在自己手里。
还有一条路要提醒：有人在 iStoreOS 上装 1Panel 这类面板管 Docker，评论区已经出现面板里 Docker 起不来的案例。路由系统毕竟精简，面板类工具不是不能用，但新手别把它当首选。
路选对了，也要知道固件侧还压着哪些雷
这些都能在 iStoreOS 的 GitHub issue 里逐条对上，不是我吓唬人。
一是 Docker 引擎版本一直停在 20.10 系列。2025 年就有用户开 issue 求升到 25 以上，到现在还开着。GitHub官方教程视频评论区也有人反馈，有的新镜像已经要求 25.x 引擎。遇到装不上的镜像，优先找兼容老引擎的版本，别急着手动升级引擎。
二是 24.10 版本上，重启后 Docker 服务不自动启动这类 issue 还开着。GitHub应对办法简单粗暴：compose 里一律写 restart: unless-stopped 或 always，每次重启路由器后顺手看一眼容器是不是都活着。
三是从 22.03 老版本升级到 24.10 的，有 N1 盒子用户反馈升完 Docker 直接起不来。GitHub升级之前，把 compose 文件、配置目录备份出来，这条路就稳很多——这也是我推荐 compose 的另一个理由。
四是日志。容器日志默认不管会越攒越大，社区里有人直接吐槽日志没法手动清、越攒越多。哔哩哔哩日志清理和日志大小限制，值得花十分钟设置一次。
按你的设备对号入座
N1 盒子/ARM 用户：性能够用但存储小，Docker 迁移必须做，且优先选有 ARM64 镜像的应用，影音硬解别抱太高期望。
x86 小主机、挂了硬盘的：三条路随便选，推荐"商店装不折腾的 + compose 捏核心的"混着来。
虚拟机用户（PVE、飞牛 NAS、ESXi 里跑的）：多一层虚拟化就多一层网络坑，容器连不上外网先查 macvlan 和桥接，再查旁路由网关设置。
接下来值得盯的信号
25.12 尝鲜版还在迭代，它换的不只是系统底包，整个插件生态都要重来一遍。如果你现在用的是 24.10，不必急着上尝鲜，但值得把 Docker 部署往 compose 方向收——等哪天正式切过去，compose 文件是你能直接带走的家当。另外两个可以顺手关注的：官方 GitHub 上 Docker 引擎升级的动向，以及 24.10 上游维护的节奏——稳定版的剩余窗口期，之前已经提醒过一次了。
