Project N.O.M.A.D.

在数字化高度依赖网络的今天，一旦连接中断，我们似乎就失去了获取信息的能力。Project N.O.M.A.D. (Node for Offline Media, Archives, and Data)是一个自包含、离线优先的开源知识与教育服务器。

通过集成关键的离线工具、海量知识库和本地 AI 模型，N.O.M.A.D. 让你在任何时间、任何地点——即便是在完全断网的环境下——依然保持信息畅通，拥有独立的认知与解决问题的能力。

这不仅仅是一个软件集合，更是一座属于你的本地数字诺亚方舟。

核心能力：七大离线支柱

N.O.M.A.D. 通过 Docker 编排一系列容器化工具，提供一个统一的管理界面和 API。它自动处理所有内容的安装、配置和更新，让用户无需操心底层细节，只需专注于知识本身。

此外，系统还内置了维基百科内容选择器、ZIM 库管理器和内容探索器，让海量离线资源的检索与管理变得前所未有的简单。

设计理念：为高性能而生的离线节点

与许多设计用于运行在树莓派等极简硬件上的“生存计算机”不同，Project N.O.M.A.D. 恰恰相反。

为了充分利用本地 AI (LLM) 的强大能力，我们强烈建议将其部署在配备独立 GPU 的高性能设备上。只有足够的算力，才能让离线 AI 推理流畅如飞，让知识库的语义搜索瞬间响应。

硬件配置建议

🟢 最低配置 (基础服务)

适用于运行维基百科、地图、笔记等基础服务，AI 功能受限。

• 处理器: 2 GHz 双核或更高
• 内存: 4 GB
• 存储: 至少 5 GB 可用空间
• 操作系统: 基于 Debian 的 Linux 发行版
• 网络: 仅在初始安装时需要

🔴 推荐配置 (完整 AI 体验)

适用于运行本地大模型、复杂语义搜索及多用户并发访问。

• 处理器: AMD Ryzen 7 / Intel Core i7 或更高
• 内存: 32 GB (大模型显存/内存占用较高)
• 显卡: NVIDIA RTX 3060 (12GB+) 或 AMD 同级及以上 (关键组件)
• 存储: 至少 250 GB SSD (用于存放模型与知识库)
• 操作系统: 基于 Debian 的 Linux 发行版
• 网络: 仅在初始安装及后续更新资源时需要

极速部署指南

N.O.M.A.D. 的安装完全基于终端，所有服务设计为通过浏览器访问。这意味着你可以将其安装在无桌面环境的服务器上，通过局域网内的其他设备（手机、平板、笔记本）进行访问。

注意：运行安装脚本需要 sudo 或 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

安装完成后，打开浏览器访问 http://localhost:8080 (或服务器 IP:8080)，即可进入 N.O.M.A.D. 指挥中心。

方式二：高级自定义安装 (Docker Compose)

如果你希望精细控制每个服务的配置：

1. 将项目中的 Docker Compose 模板复制为 docker-compose.yml。
2. 根据需求修改环境变量、端口映射或卷挂载。
3. 运行启动命令：

   docker compose up -d
   

隐私、安全与网络策略

🛡️ 真正的离线优先

Project N.O.M.A.D. 专为零依赖网络环境设计。

• 零遥测：系统不包含任何内置的数据收集或遥测功能。
• 按需联网：仅在初次安装或用户主动决定下载新地图/新书籍时需要网络连接。日常使用完全无需联网。

🔒 安全使用说明

按照设计初衷，N.O.M.A.D. 是一个开放且无障碍的本地工具，默认不包含身份验证功能。

• 局域网隔离：如果你将设备接入局域网，请务必通过防火墙规则（如 ufw）严格控制端口暴露，仅允许可信 IP 访问。
• 严禁直接暴露公网：N.O.M.A.D. 绝非为直接暴露在公共互联网上而设计。除非你具备深厚的网络安全知识，并配置了反向代理、SSL 证书及额外的认证层（如 Authelia），否则切勿将其端口映射到公网，以免面临数据泄露风险。