1. 项目定位与用途
Project N.O.M.A.D.（Node for Offline Media, Archives, and Data）是一个自包含的离线优先知识教育服务器，定位为“知识永不离线”的综合信息平台。它通过浏览器界面提供多种离线工具和服务，包括 AI 聊天、离线维基百科、Khan Academy 教育课程、离线地图、数据加密工具和笔记系统。项目旨在任何环境下（尤其是无网络条件）为用户提供关键信息查询、学习支持和实用工具，适用于个人、教育机构或应急场景。
项目档案应用项目
Crosstalk-Solutions/project-nomad 是什么？用途、安装与使用指南
Project N.O.M.A.D. 是一个自包含的离线优先知识教育服务器，通过 Docker 集成 AI 助手、离线百科、教育课程、地图和数据工具。本文详解项目定位、安装步骤（快速脚本与 Docker Compose）、使用方式及架构特点，助你在无网络环境获取关键信息。
AI 总结
Project N.O.M.A.D. 是一个离线优先的自包含知识服务器，通过 Docker 集成 AI 聊天、离线百科、教育课程等工具，旨在无网络环境下提供关键信息与生存支持。
中文项目介绍
Project N.O.M.A.D. 是一个自包含的离线优先知识教育服务器，旨在任何网络环境下提供关键信息与工具。
它解决在无网络或网络不稳定时无法访问知识库、教育资源和实用工具的问题，通过集成多个容器化服务实现离线可用。
适用场景包括偏远地区作业、野外生存、航行、紧急救援、隐私敏感场景以及搭建本地化教育平台。
技术实现上，项目基于 Docker 编排，核心 Command Center 采用 AdonisJS 构建管理 UI 与 API，集成 Ollama（AI 推理）、Kiwix（离线百科）、Kolibri（教育）、ProtoMaps（地图）、CyberChef（数据工具）、FlatNotes（笔记）和 Qdrant（向量检索）。所有工具通过浏览器访问，存储路径由 NOMAD_STORAGE_PATH 统一管理。
详细信息与使用说明
2. 解决的问题
项目主要解决在无网络或网络不稳定环境下无法访问知识库、教育资源和实用工具的问题。传统在线服务依赖持续网络连接，而在偏远地区、野外作业、航行或紧急情况下，网络可能完全不可用。N.O.M.A.D. 通过将所有工具和服务容器化并本地部署，实现完全离线运行，确保用户随时获取维基百科、医疗参考、生存指南、教育内容等关键信息，同时提供本地 AI 助手进行文档分析和问答，增强信息获取与处理能力。
3. 适用场景
典型适用场景包括：偏远地区或发展中国家的学校与社区中心，用于搭建本地化教育平台；野外作业、探险、航行等无网络环境下的知识查询与生存支持；紧急救援或灾害响应中快速获取医疗、地理等信息；隐私敏感场景下使用本地 AI 助手处理敏感文档，避免数据上传云端；以及个人或家庭搭建离线知识库，用于终身学习或兴趣研究。项目也适合作为社区服务器，在局域网内多用户共享资源。
4. 安装方式
项目支持 Debian 系操作系统（推荐 Ubuntu），需要 sudo/root 权限。提供两种安装方式：快速安装通过运行 install_nomad.sh 脚本自动完成依赖安装和容器部署，命令为：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；高级安装使用 Docker Compose 模板（management_compose.yaml），用户需手动配置环境变量并运行 docker compose up -d，适用于熟悉 Docker 的用户。安装后通过浏览器访问 http://localhost:8080 或设备 IP:8080。
5. 使用方式
首次访问会自动启动 Easy Setup 向导，引导用户完成四步配置：选择启用的能力（如 AI、地图）、选择地图区域、设置内容层级（Essential/Standard/Comprehensive）以及开始下载内容。所有工具通过浏览器界面使用：AI 聊天支持文档上传和语义搜索；Information Library 提供离线维基百科和医学参考；Education Platform 集成 Khan Academy 课程并跟踪进度；Offline Maps 可下载区域地图；Data Tools 提供加密编码功能；Notes 支持本地笔记。设置页面可管理 Docker 容器、下载内容和系统基准测试。
6. 补充说明与实现特点
项目采用 Docker 容器编排架构，Command Center 基于 AdonisJS 框架提供统一管理 UI 和 API，负责安装、配置和更新所有集成服务。存储层通过环境变量 NOMAD_STORAGE_PATH（如 /opt/project-nomad/storage）统一管理 ZIM 文件、地图等离线内容。集成服务包括 Ollama（本地 AI）、Qdrant（向量检索）、Kiwix（ZIM 内容）、Kolibri（教育）、ProtoMaps（地图）、CyberChef（数据工具）和 FlatNotes（笔记）。系统还提供硬件基准测试和社区排行榜。仓库中未明确给出多语言支持细节或具体硬件要求，但建议使用 Debian 系系统。
思维导图
Project N.O.M.A.D.
Command Center
AdonisJS 管理 UI
API 服务
Docker 编排
Easy Setup 向导
AI 助手
Ollama 集成
Qdrant 向量检索
文档上传与 RAG
OpenAI 兼容支持
信息库
Kiwix 离线百科
ZIM 文件管理
医学参考与电子书
教育平台
Kolibri 集成
Khan Academy 课程
进度跟踪与多用户
离线地图
ProtoMaps 服务
区域地图下载
搜索与导航
数据工具
CyberChef 集成
加密与编码
数据分析
笔记系统
FlatNotes 集成
Markdown 支持
本地存储
系统功能
硬件基准测试
社区排行榜
容器管理与更新
常见问题
如何安装 Project N.O.M.A.D.？
支持 Debian 系系统（如 Ubuntu），需 sudo 权限。快速安装：运行提供的 install_nomad.sh 脚本自动部署；高级安装：使用 Docker Compose 模板手动配置后启动。详细步骤见项目安装指南。
是否需要桌面环境或持续网络连接？
不需要。项目设计为服务器模式，无需桌面环境，所有工具通过浏览器访问。安装和初始配置后，日常使用完全离线，仅内容下载时需要网络。
项目包含哪些离线内容和工具？
包括离线维基百科、医学参考、生存指南（Kiwix）；Khan Academy 课程（Kolibri）；可下载区域地图（ProtoMaps）；AI 聊天与文档分析（Ollama + Qdrant）；数据加密工具（CyberChef）；本地笔记（FlatNotes）；以及系统基准测试。
AI 聊天功能如何工作？是否必须使用 Ollama？
默认集成 Ollama 提供本地 AI 推理，支持文档上传和语义搜索（RAG）。同时兼容 OpenAI API 兼容软件（如 LM Studio、llama.cpp），用户可替换为其他后端。AI 模型需单独下载，可通过界面管理。
数据存储在何处？如何管理存储空间？
所有离线内容（ZIM 文件、地图等）存储在 NOMAD_STORAGE_PATH 指定路径（默认 /opt/project-nomad/storage），可在 admin/.env.example 中配置。浏览器界面提供内容选择器和下载管理，支持删除或更新内容以释放空间。