网硕互联帮助中心【免费下载链接】mos-releases
A Modular Operating System for Servers and Homelabs
项目地址：
https://gitcode.com/gh_mirrors/mo/mos-releases
点击查看 免费下载
MOS（Modular Operating System）是一款面向家庭服务器与 Homelab 的轻量级模块化操作系统，内置完整的 REST API 与 Swagger 在线接口文档，让你不用登录命令行，就能用浏览器或脚本完成系统监控、容器管理和自动化运维。本文带你从零读懂 MOS REST API，并落地几个真实可用的家庭服务器自动化场景。
🖥️ MOS 是什么：专为家庭服务器打造的轻量系统
MOS 基于 Devuan GNU/Linux 构建，目标是为小型、低功耗的家庭服务器提供一个简单、可靠、低开销的自托管平台。开箱默认支持三大核心能力：
- Docker：容器化应用部署
- LXC：轻量级容器虚拟
- QEMU：完整虚拟机管理
在存储层面，MOS 默认内置 mergerfs（将多块磁盘聚合为一个统一文件系统）与 SnapRAID（快照式奇偶校验保护），无需传统 RAID 的复杂度即可获得可扩展、易管理的存储方案。更多硬件与存储驱动（NVIDIA、ZFS、备份插件等）可通过 MOS Hub 以插件形式按需加载。
💡 设计哲学：无隐藏服务、无遥测、无强制云依赖，一切本地运行、完全由你掌控。
功能清单详见 README.md。
📡 如何打开 MOS Swagger 接口文档（一分钟上手）
这是全文最实用的一步：
打开后即可看到完整的 Swagger UI 在线接口参考页：所有 REST 端点、请求参数与返回结构一目了然，还可以直接点击 Try it out 在线调试——不用翻代码，不用拼凑零散文档。
这一官方地址也明确写在项目说明中：README.md。
MOS 的 Web 管理界面本身就是这套 REST API 的官方前端——你在界面上看到的 Dashboard、Docker、LXC、VMs、Pools、Plugins 等模块，背后对应的都是一组组标准化 API 端点。
🔍 Swagger 页面怎么看：三大区域 + 常用端点速览
打开 Swagger 页面后，重点看三个区域：
按功能分组的常用端点速览：
| OS / Dashboard | 查询系统版本、运行时长、CPU、内存、温度 | 定时健康巡检 |
| Network | 查看网卡状态与实时流量 | 带宽异常告警 |
| Pools / Disks / Shares | 查看 mergerfs 池用量、磁盘温度 | 容量阈值监控 |
| Docker | 容器创建、启停、日志查看 | 服务自愈脚本 |
| LXC / VMs | 容器与虚拟机生命周期管理 | 定时重启、快照 |
| Users / Settings | 账户与系统参数管理 | 批量配置下发 |
| Plugins | 驱动与插件启停 | 按需加载硬件驱动 |
⚙️ 家庭服务器自动化实践：三个高频场景
场景一：定时健康巡检
利用 OS / Dashboard 类接口，每 5 分钟请求一次系统信息端点，将 CPU 温度、内存占用、网络流量写入本地日志，超过阈值就通过邮件或消息推送告警。官方的 mos-notify、docker-watchdog 等组件做的正是这件事，而你可以用同一套 API 拼出属于自己的版本。
场景二：磁盘容量监控
通过 Pools / Disks 接口读取 mergerfs 池的已用比例（例如 39.5 TiB / 54.6 TiB），在脚本里设定 85% 阈值，触发后自动通知你清理或扩容；再配合 SnapRAID 校验盘状态，实现"数据盘快满"时第一时间知晓。
场景三：容器自动恢复
结合 Docker 相关端点轮询关键容器的运行状态：发现容器退出时自动重启，并调用日志接口定位原因。相比直接执行 docker 命令，走 REST API 的优势是——监控脚本可以跑在任何一台能访问 MOS 网卡的机器上，无需 SSH 进入系统。
🔒 安全与隐私：零遥测的开源承诺
MOS 承诺完全开源、不收集任何数据、无遥测、无追踪。使用前请注意官方免责声明：系统以 "as is" 方式提供，建议始终为重要数据保留备份。
- 安全漏洞请通过邮件（admin@mos-official.net）私密报告，而非公开 Issue，流程详见 SECURITY.md
- 许可证说明：LICENSE
- 第三方软件许可清单：THIRD_PARTY.md
🧩 项目结构与延伸阅读
本仓库（mos-releases）负责把 MOS 内核、rootfs 与驱动组装为可启动的发行版镜像，核心文件包括：
- README.md：项目总览、功能特性与最低硬件要求（x86_64 + 8 GB RAM）
- runner-setup.sh：自建 CI Runner 的完整脚本，可参考其自动化思路
- runner-mos_releases：Runner 服务的启停脚本，展示服务化封装方式
- SECURITY.md：安全漏洞报告流程
MOS 生态的分仓清单（API、前端、内核、rootfs 等）见 README.md，完整使用教程可参考官方文档 MOS Docs。
🚀 新手建议路径：先装好 MOS → 浏览器打开 /api-docs 逛一遍端点 → 用"健康巡检"场景写第一个脚本 → 逐步扩展到自己的服务。
赞
【免费下载链接】mos-releases
A Modular Operating System for Servers and Homelabs
项目地址：
https://gitcode.com/gh_mirrors/mo/mos-releases
点击查看 免费下载
相关推荐
OpCore Simplify实战指南：自动化配置OpenCore EFI的Hackintosh解决方案
打造知识共享平台：开源数字图书馆的价值与实践指南
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
评论前必须登录！
注册