项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 44142
使用教程
环境要求
- 基于 Debian 的操作系统(推荐 Ubuntu 26.04 LTS,也支持 24.04 LTS 和 Debian 12)
- 需要 sudo/root 权限运行安装脚本
- NOMAD 自身约需 5 GB 磁盘、低于 1 GB 内存(后续离线内容与 AI 助手会显著增加占用)
- 无需桌面环境,通过浏览器访问即可(浏览器可来自其他客户端)
- 安装阶段需要联网下载依赖,之后可完全离线使用
安装与启动步骤
-
1确认系统环境
确认是 Debian 系系统并具备 sudo 权限;检查磁盘与内存是否满足最低要求,否则后续添加离线内容会失败。
-
2一键安装 NOMAD
更新软件源、安装 curl、下载 install_nomad.sh 并以 root 执行,脚本会完成全部安装,过程较慢请勿中断。
sudo apt-get update && \ sudo apt-get install -y curl && \ curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/install_nomad.sh \ -o install_nomad.sh && \ sudo bash install_nomad.sh -
3浏览器访问验证
安装完成后在本机浏览器打开 http://localhost:8080,或从其他设备访问 http://DEVICE_IP:8080(换成实际设备 IP)。
-
4启动与停止服务
安装后可用官方脚本管理容器:start_nomad.sh 启动已安装项目容器,stop_nomad.sh 停止全部容器。
sudo bash /opt/project-nomad/start_nomad.sh sudo bash /opt/project-nomad/stop_nomad.sh -
5更新命令中心
update_nomad.sh 会拉取 Command Center 及其依赖(如 mysql)的最新镜像并重建容器,不影响其他应用容器。
sudo bash /opt/project-nomad/update_nomad.sh -
6高级 Docker Compose 部署
进阶用户可下载官方 Compose 模板存为 docker-compose.yml,替换占位值后启动;README 提示仅推荐熟悉 Docker 的用户使用。
curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/management_compose.yaml -o docker-compose.yml docker compose up -d -
7卸载重装
需要全新开始时运行卸载脚本,注意该操作不可撤销,会清掉现有实例。
curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/uninstall_nomad.sh -o uninstall_nomad.sh && sudo bash uninstall_nomad.sh
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
INTERNET_STATUS_TEST_URL | 否 | 自定义联网检测地址,环境变量优先级高于 UI 中 Settings → Advanced 的设置 | https://1.1.1.1/cdn-cgi/trace |
OLLAMA_HOST | 否 | 在另一台主机运行 Ollama 供 NOMAD 连接时必须以此参数启动服务 | 0.0.0.0 |
如何确认成功
浏览器打开 http://localhost:8080(或 http://设备IP:8080)能正常显示 NOMAD 界面,即安装成功。
常见问题
Q:Windows 上能装吗?
A:README 指向官方 WSL2 安装指南,涵盖原生 Docker 与 Docker Desktop 两条路线,属社区支持路径;一键安装脚本本身仅支持 Debian 系系统。
Q:必须一直联网吗?
A:不需要。仅在初次安装下载依赖、以及之后你主动下载额外资源时需要联网,平时完全离线,且不含任何遥测。
Q:能让 AI 模型跑在另一台机器上吗?
A:可以,在 AI 助手设置中填写 ollama 或 OpenAI 兼容服务(如 LM Studio)的 URL;用 Ollama 时需以 OLLAMA_HOST=0.0.0.0 启动,目标主机的服务需自行搭建。
Q:update_nomad.sh 会更新所有应用吗?
A:不会。它只更新 Command Center 及其依赖容器,可安装的应用容器需在 Command Center 界面中更新。
注意事项
- 安装脚本必须用 sudo/root 运行,普通用户权限会失败。
- NOMAD 本体约 5 GB 磁盘、1 GB 以内内存,真正占空间的是后续下载的离线内容,AI 助手会明显抬高内存需求。
- 卸载脚本不可撤销,执行前请确认无需保留数据。
- 一键安装脚本仅适用于 Debian 系系统,其他发行版请参考官网安装指南或走 Docker Compose 方式。
核心亮点
- 离线优先设计,无网环境也能完整访问维基百科、书籍、课程和地图
- 支持可选本地 AI,数据不出设备,隐私和可用性兼顾
- 部署在自有硬件上,不依赖云服务,适合偏远地区或应急场景
不足之处
- 本地 AI 功能对硬件有一定要求,低配设备体验可能受限
- 内容更新依赖手动同步,无法像在线服务那样实时获取最新资料
适用场景
- 灾区或野外考察时搭建临时知识站
- 学校或图书馆在无稳定网络环境下提供数字资源
- 个人在旅行、露营或断网时查阅百科与书籍
替代项目
Kiwix、Internet-in-a-Box
同类项目推荐
GenAiGuidebook
开源
可运行的笔记本,带你从零手写生成式 AI 应用
slax-reader
开源
保存网页,AI 助你学透,还能和同好一起讨论
Open-source, AI-powered read-it-later — save web pages, highlight, and discuss
The-Agentic-Researcher
开源
把多个命令行 AI 智能体串成可复现的数学与机器学习科研流程
A practical framework for AI-Assisted Research in Mathematics and Machine Learning
llms
开源
边读原理边跑代码,把大模型从黑盒学成白盒
Large Language Models: In this repository Language models are introduced covering bo···
deep-learning-wizard
开源
从入门到部署,用 PyTorch 搞定深度学习全流程
Open source guides/codes for mastering deep learning to deploying deep learning in p···
ai-engineering-from-scratch
开源
从零学AI工程,动手构建并交付真实项目
Learn AI Engineering! Learn it. Build it. Ship it for others.
academic-translation-skills
开源
外文学案一键译成中文,术语准、可导出、能记笔记
【已有收入Skill库记录】一款可供境外留学 / 中外合办 / 外文文献的AI工具包,含多档位Ski···
tue-ai-safety-course
开源
跟着大学课表系统入门 AI 安全,资料一站看全
AI safety course at the University of Tübingen (Summer Semester 2026)
production-ai-agents-for-media-g···
开源
免费学做能上线出图出视频出音频的AI代理
Build production AI agents that generate images, video and audio on serverless GPUs.···
