应用装不上、起不来、更新失败：飞牛应用排查手册

一句话结论

飞牛上应用出问题，八成集中在四件事：端口冲突、镜像拉不到、权限不对、空间不足。这四类问题的表象都是”装不上”或”起不来”，但排查路径完全不同。按顺序先定位类别再动手，比反复重装有效得多——重装解决不了配置类问题，只会让你多等一次下载。

先建立一个排查顺序

遇到应用异常，按这个顺序走，不要跳步：

1. 看状态：在应用中心里确认它到底是”安装中””启动失败”还是”已停止” 2. 看日志：真正的原因几乎都在日志里 3. 对资源：查端口占用、磁盘空间 4. 最后才考虑重装

大部分人直接从第 4 步开始，结果同一个问题反复出现。

问题一：端口冲突

典型症状：应用装完起不来，或两个应用不能同时运行。

怎么确认：SSH 登录后查端口占用情况：

sudo ss -tlnp

在输出里找你要用的端口，看是不是已经被别的进程占了。

怎么解决：

• 改应用的对外端口，避开已被占用的那个
• 或者停掉占用端口的旧应用（确认它确实不再需要）
• 改完重启应用，再确认状态变为「运行中」

预防办法：给自己记一份端口分配表，每装一个新应用就登记一次。应用一多，这张表能省掉大量排查时间。

问题二：镜像拉不动

典型症状：状态卡在「安装中」很久，或提示拉取失败。

怎么判断：这是网络问题，不是应用问题。判断依据是——浏览器里 NAS 能不能正常访问外网镜像源。访问不了就是网络。

怎么解决：

• 给飞牛配置镜像加速地址，很多界面本身就提供加速配置入口
• 手动安装 fpk 的方式绕过在线拉取（详见离线安装那篇）
• 临时用手机热点让 NAS 连一次网，装完断开

一个重要的时间预期：Docker 封装的应用首次启动要拉镜像，一般一到三分钟是正常的。超过三分钟还没好才需要干预，不要一开始就判定失败。

问题三：权限不对

典型症状：应用能启动，但读不到文件、写不进数据、或报权限错误。

常见原因：

• 应用运行身份和你共享文件夹的权限设置不匹配
• 挂载的目录本身没有给应用足够的读写权限
• 应用以非 root 身份运行，而目录属主不匹配

怎么解决：

• 先确认应用的运行身份，在应用详情或说明里查
• 再去共享文件夹的权限设置里，确认这个身份对目标目录有读写权限
• 改完权限重启应用验证

一个判断原则：正规打包的应用默认以非 root 运行，这是好事，但也意味着权限必须显式配好。遇到权限问题时，优先调整目录权限，而不是想办法让它跑 root。

问题四：磁盘空间不足

典型症状：安装到一半失败、更新失败、应用运行中突然异常。

怎么确认：

df -h

重点看两块：系统盘和应用数据所在的数据盘。

为什么系统盘会满：应用数据如果默认落在系统盘，装几个应用就可能撑爆。这是新手最常踩的坑之一。

怎么解决：

• 清理不需要的旧镜像和容器
• 把应用数据迁移到数据盘（在应用设置或重新安装时指定位置）
• 装新应用前先看清楚存储位置选项

问题五：更新失败或更新后异常

典型症状：点更新后卡住，或更新完成后应用打不开、配置丢失。

排查顺序：

1. 先看是否是空间不足或网络问题（回到上面两类） 2. 确认这次更新是不是大版本跨越——大版本可能有不兼容的配置变更 3. 如果配置丢了，检查数据目录是否还在（数据通常还在，丢的一般是配置项）

一条重要经验：重要应用更新前，先把它的数据目录复制一份。 这一步花一分钟，能避免最坏情况下的数据事故。

问题六：卸载后的残留

典型症状：卸载了应用，但磁盘空间没释放，或数据目录还在。

实际情况：不同应用的处理不一致，有些卸载后保留数据卷，有些清掉。飞牛本身不像某些系统那样提供统一的”是否保留数据”选项，所以别默认它一定保留。

正确做法：

• 卸载前先确认数据目录位置，需要的内容先复制出来
• 卸载后手动检查目录是否残留，不需要的再手动删除
• 清理不再使用的镜像，回收空间

一张速查表

小结

飞牛应用的故障绝大多数是配置问题而非软件缺陷，重装是效率最低的解法。养成三个习惯基本能覆盖绝大多数情况：记端口分配表、重要应用更新前备份数据目录、先看日志再动手。做到这三条，你在这上面花的时间会大幅下降。