Umbrel OS新手指南第一次使用Web管理界面必知的8件事【免费下载链接】umbrel-osumbrelOS development has moved to https://github.com/getumbrel/umbrel项目地址: https://gitcode.com/gh_mirrors/um/umbrel-osUmbrel OS 是一款专为家庭服务器设计的轻量级操作系统核心亮点就是那个开箱即用的 Web 管理界面通过浏览器输入设备的 IP 地址就能在网页上安装应用、管理存储、查看日志全程无需命令行。本指南面向刚烧录完 Umbrel OS 系统镜像的新手用 8 个关键点带你安全、顺利地完成第一次 Web 界面操作。在开始之前先了解一下这个项目的定位本仓库 umbrel-os 是 Umbrel OS 的官方构建脚本仓库负责把系统镜像打包出来config 中定义了镜像名称、默认主机名umbrel、默认用户名等关键参数。而你现在拿到的系统镜像正是由这些脚本一步步构建而成的。一、Umbrel OS 是什么为什么推荐新手使用Umbrel OS 基于 Debian Linux专为树莓派 4以及部分 ARM64 设备优化内置 Docker 和 Docker Compose把家庭服务器这件听起来很专业的事变成了点几下鼠标就能完成的操作全 Web 操作安装应用、管理磁盘、查看状态全部在浏览器里完成应用商店内置 Umbrel 应用目录自建 Nextcloud、Jellyfin、Pi-hole 等只需一键Docker 隔离每个应用独立运行互相不干扰卸载干净状态总览Web 首页实时显示 CPU、内存、磁盘占用。 小贴士Umbrel 主程序在系统里位于/home/umbrel/umbrel目录构建脚本中的安装逻辑可参考 03-install-umbrel/01-run.sh其中还预拉取了 Umbrel 核心服务的 Docker 镜像所以首次开机就能秒开应用。二、第一件事找到 Web 管理界面的正确访问地址新手最容易卡住的第一步打不开 Web 界面。确认设备已联网树莓派通过网线连接或等待自动连上 Wi-Fi镜像默认开启 DHCP见 01-set-sources/01-run.sh 中的网络配置阶段获取 IP 地址在路由器后台查看设备列表寻找名为umbrel的主机浏览器输入http://设备IP回车即进入 Web 管理界面首次登录使用镜像的默认账号密码构建配置中定义的用户名umbrel见 config登录后系统会引导你修改密码请务必修改。⚠️ 如果打不开检查是否用了http不是https、防火墙是否放行、以及设备是否真的完成了启动首次开机要等几分钟完成初始化。三、第二件事耐心等待首次启动完成Umbrel OS 的 Web 界面在系统完全启动前是不可访问的。镜像构建时已经做足了准备首次开机会自动执行磁盘扩容把分区扩满整张 SD 卡或硬盘见 resize2fs_once 脚本固件、内核、Docker 等组件都已在镜像构建阶段预装好见 02-firmware/01-packages核心 Docker 镜像已内置避免你开机后再漫长下载。看到 Web 界面出现服务启动中提示时泡杯咖啡25 分钟后回来即可。四、第三件事认识 Web 界面的四大功能区进入界面后你会看到清晰的导航结构新手主要用到这四个区域区域作用新手建议Apps应用商店 已安装应用管理从这里开始装应用Storage磁盘挂载、备份、空间监控先挂载存储盘再装应用NetworkWi-Fi 连接、网络模式、端口转发新手先用默认配置⚙️Settings时区、更新、日志、关机最后再仔细调整五、第四件事安装第一个应用以自建云盘为例这是新手的Hello World时刻点击Apps→Browse浏览 Umbrel 应用目录选择一个应用如 Nextcloud、Jellyfin点击Install等待下载并启动界面会显示实时进度条应用卡片出现Running状态后点击应用图标即可在独立窗口打开它。整个过程就像在手机上装 App背后其实是 Umbrel 自动完成了一整套 Docker 容器编排——这套机制在构建脚本 01-run.sh 中可见端倪它预装了 Docker、Docker Compose 并绑定了服务自启动。 建议第一个应用别选太复杂的装完确认安装→运行→打开流程跑通再挑战更重的服务。六、第五件事先挂存储盘再存数据Umbrel OS 默认运行在 SD 卡上频繁写入会缩短 SD 卡寿命。正确姿势是在Storage页面点击挂载接上 U 盘或移动硬盘选择一块外部磁盘作为数据存储盘安装应用时Umbrel 会自动把应用数据写入外部盘。镜像构建脚本中也为此做了优化比如打包时特意剔除 apt 缓存以压缩体积见 export-image/prerun.sh把宝贵的存储留给你的数据。七、第六件事备份与升级的正确姿势备份Web 界面的Storage → Backups支持一键备份所有应用到 USB 磁盘换机/重装后直接恢复比手动备份 Docker 容器省心得多升级Settings → Updates会显示可用的系统与应用更新建议先备份再升级版本查看界面左下角可查看当前 Umbrel OS 版本号构建仓库 config 中记录的UMBREL_VERSION就是镜像出厂版本号的来源。八、第七件事网络配置别乱动新手最常见的翻车点改网络设置后失联Web 界面再也打不开。记住两条原则能用有线就别改 Wi-Fi 设置——有线最稳定改动前截图记录当前配置——万一断线可用 HDMI 接显示器登录系统默认 SSH 已开启见 config 中ENABLE_SSH1手动救回。镜像在构建阶段已为网络做了不少加固例如把 Avahi 绑定到有线和无线网卡上防止主机名漂移见 03-install-umbrel/01-run.sh你通常无需操心。九、第八件事日志排错与获取帮助Web 界面不只是点点点它的排错能力同样强大Settings → Logs按应用查看运行日志80% 的应用打不开问题都能在这里定位常见原因端口被占用、数据盘没挂载重启大法应用卡住时在应用卡片上点击Restart比重启整机更快求助前准备记录好应用名、版本号、日志中的报错关键字社区回复会高效很多。十、新手常见疑问快速解答QWeb 界面支持手机访问吗支持。同一局域网内手机浏览器访问设备 IP 即可操作体验与电脑端一致。QUmbrel OS 和直接装 Docker 有什么区别Umbrel 在 Docker 之上做了一层应用商店 可视化配置帮你处理了容器编排、端口管理、数据卷配置这些繁琐细节。Q数据都存哪里系统盘只存系统应用数据默认存放于你指定的外部存储盘卸载应用时可选择保留或删除数据。Q这个镜像怎么构建的如果你好奇系统是怎么打包出来的可以翻翻构建仓库stage0 完成基础系统配置stage1 处理引导与系统调优stage2 安装 Umbrel 主程序与网络组件最后由 export-image 和 export-noobs 打包出最终镜像。总结8 件事一张图记住✅ 用http://IP访问 Web 界面并修改默认密码✅ 首次启动耐心等待 25 分钟✅ 熟悉 Apps / Storage / Network / Settings 四大区域✅ 安装第一个简单应用跑通全流程✅先挂外部存储盘再大规模存数据✅ 定期使用一键备份功能✅ 改网络前截图留底备好 SSH 后手✅ 出问题先看Logs再求助社区。按照这份 Umbrel OS 新手指南完成上述 8 件事你的家庭服务器之旅就算真正开始了。祝你搭建愉快【免费下载链接】umbrel-osumbrelOS development has moved to https://github.com/getumbrel/umbrel项目地址: https://gitcode.com/gh_mirrors/um/umbrel-os创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考