project-nomad

断网也能查百科、看书、问AI,一台设备全搞定

开源 🏷️定价信息待确认 ✅ 目前可打开 学习教育 🍴 复刻 4558 🐛 待处理 189 👀 关注 281
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 44142
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

project-nomad 项目界面预览图
图片来源:项目官网

项目数据

分类学习教育
开发团队Crosstalk-Solutions
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议Apache-2.0
主要语言TypeScript
GitHub 星标★ 44142
上线时间2025-06-24 00:00:00
代码更新2026-11-18
仓库体积13.3 MB
本站数据更新2026-11-21
维护状态活跃
收录时间2026-10-07
浏览次数5

项目介绍

Project NOMAD 是一个离线优先的知识与教育服务器,把维基百科、数千本书籍、课程、地图以及可选的本地 AI 模型打包在一起,运行在用户自己拥有的硬件上,完全不需要互联网。它解决的是断网、灾区、偏远地区、旅行途中或网络受限环境下无法获取知识资源的问题。核心能力包括:内置离线维基百科镜像与电子书库,支持课程与地图浏览,可选本地 AI 问答,所有数据与计算都在本地设备完成,不依赖云服务。项目用 TypeScript 开发,部署相对简单,适合在树莓派、旧电脑或小型服务器上运行,把一台普通设备变成独立的知识中心。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 44142

使用教程

难度:入门 约 15 分钟 部署方式:本地安装 7 步

环境要求

  • 基于 Debian 的操作系统(推荐 Ubuntu 26.04 LTS,也支持 24.04 LTS 和 Debian 12)
  • 需要 sudo/root 权限运行安装脚本
  • NOMAD 自身约需 5 GB 磁盘、低于 1 GB 内存(后续离线内容与 AI 助手会显著增加占用)
  • 无需桌面环境,通过浏览器访问即可(浏览器可来自其他客户端)
  • 安装阶段需要联网下载依赖,之后可完全离线使用

安装与启动步骤

  1. 1确认系统环境

    确认是 Debian 系系统并具备 sudo 权限;检查磁盘与内存是否满足最低要求,否则后续添加离线内容会失败。

  2. 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. 3浏览器访问验证

    安装完成后在本机浏览器打开 http://localhost:8080,或从其他设备访问 http://DEVICE_IP:8080(换成实际设备 IP)。

  4. 4启动与停止服务

    安装后可用官方脚本管理容器:start_nomad.sh 启动已安装项目容器,stop_nomad.sh 停止全部容器。

    sudo bash /opt/project-nomad/start_nomad.sh
    sudo bash /opt/project-nomad/stop_nomad.sh
  5. 5更新命令中心

    update_nomad.sh 会拉取 Command Center 及其依赖(如 mysql)的最新镜像并重建容器,不影响其他应用容器。

    sudo bash /opt/project-nomad/update_nomad.sh
  6. 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. 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

同类项目推荐

slax-reader 开源

保存网页,AI 助你学透,还能和同好一起讨论

Open-source, AI-powered read-it-later — save web pages, highlight, and discuss

★ 85 2026-08-09
The-Agentic-Researcher 开源

把多个命令行 AI 智能体串成可复现的数学与机器学习科研流程

A practical framework for AI-Assisted Research in Mathematics and Machine Learning

★ 110 2026-11-17
llms 开源

边读原理边跑代码,把大模型从黑盒学成白盒

Large Language Models: In this repository Language models are introduced covering bo···

★ 394 2026-10-14
deep-learning-wizard 开源

从入门到部署,用 PyTorch 搞定深度学习全流程

Open source guides/codes for mastering deep learning to deploying deep learning in p···

★ 880 2026-08-10
academic-translation-skills 开源

外文学案一键译成中文,术语准、可导出、能记笔记

【已有收入Skill库记录】一款可供境外留学 / 中外合办 / 外文文献的AI工具包,含多档位Ski···

★ 126 2026-11-16
tue-ai-safety-course 开源

跟着大学课表系统入门 AI 安全,资料一站看全

AI safety course at the University of Tübingen (Summer Semester 2026)

★ 152 2026-09-17