Crosstalk-Solutions/project-nomad
运维与部署把离线维基、课程、地图、笔记和可选本地 AI 打包成自有硬件上的自托管 Docker 知识服务器。
Project NOMAD 是一个通过浏览器管理的离线优先知识服务器。它把离线参考资料、课程、地图、笔记和可选的本地 AI 助手打包成容器,在完成初始安装后,整套内容留存在自己控制的设备上,不依赖持续联网。它更适合想要一个可携带或自成一体的学习与资料设备的人,而不是追求最低配置的“生存计算机”。
功能与工作方式
名为 Command Center 的管理界面负责安装、配置和更新一组容器化工具:Kiwix 提供离线维基、医学资料和电子书;Kolibri 提供带进度跟踪的 Khan Academy 课程;ProtoMaps 提供区域地图;此外还有 FlatNotes、用于数据工具集的 CyberChef,以及可以运行自定义 Docker 容器的 Supply Depot 应用目录 Project NOMAD README。AI 助手使用 Ollama 加 Qdrant 实现文档上传和语义搜索,也可以改为连接 OpenAI 兼容的本地服务,例如 LM Studio 或 llama.cpp Project NOMAD README。
典型的首次使用流程是:在 Debian 系主机上安装,打开 8080 端口的浏览器界面,通过设置向导选择内容集合;之后的下载和更新由用户在界面中触发。
安装路径与前提
官方支持的路径是 Debian 系系统,推荐 Ubuntu 26.04 LTS,24.04 LTS 和 Debian 12 也受支持;安装通过终端完成,需要 root 权限 安装与快速开始。高级用户可以使用 Docker Compose 模板手动配置 高级安装;Windows 只有社区支持的 WSL2 指南 WSL2 指南。
资源占用取决于安装了什么:基础管理应用约需 5 GB 磁盘和不到 1 GB 内存;加入 AI 助手后安装体积约 25 GB,模型推理所需内存会从显存或系统内存中占用 设备要求。作者更鼓励使用带 GPU 的设备来运行 AI,而不是最低配置硬件。安装期间需要联网,之后只有在用户主动下载更多工具或内容时才会再次联网 Project NOMAD README。
访问与安全边界
项目设计上没有身份认证,作者明确不建议把实例直接暴露到互联网,建议改用网络层端口控制来管理访问 安全说明。这是让局域网内其他设备访问前最需要权衡的条件。
隐私方面,项目声明没有内置遥测。联网状态检查会先请求 Cloudflare 的端点,失败后回退到 GitHub 和 NOMAD API;检查地址可以在设置中修改或用环境变量覆盖,且环境变量优先 联网与隐私。小版本和补丁版本的自动更新是可选功能,受可配置时间窗和冷却期约束,要通过预检,且大版本永远需要手动更新 自动更新。
代码以 Apache-2.0 许可发布 许可证。总体而言,NOMAD 适合想要一个受管理的自托管离线资料库、并能接受 Docker 主机和无认证局域网服务的人。
本文由 AI 根据项目 README 生成,更新于 2026年10月30日,以项目官方文档为准。