Project NOMAD 是一套自包含、离线优先（offline-first）的知识与教育服务器，集成了一系列关键工具、知识资源以及 AI 能力，让你在任何时间、任何地点都能获取信息并保持自主。

安装与快速上手

Project NOMAD 可安装到任何基于 Debian 的操作系统（推荐 Ubuntu 26.04 LTS；同时支持 24.04 LTS 与 Debian 12）。整个安装过程完全在终端中完成，所有工具与资源均通过浏览器访问，因此你不必安装桌面环境——完全可以将 NOMAD 部署为「服务器」，然后通过其他客户端访问它。

注意：运行安装脚本需要 sudo/root 权限。

快速安装（仅限基于 Debian 的系统）

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

Project NOMAD 已安装到你的设备！打开浏览器，访问 http://localhost:8080（或 http://DEVICE_IP:8080）即可开始使用。

如需完整逐步教程（包括 Ubuntu 安装），请参阅 Installation Guide。Windows 用户请参阅 WSL2 install guide——这是一条社区支持的安装路径，覆盖原生 Docker 与 Docker Desktop 安装方式。

高级安装

如果需要对安装过程进行更多控制，可将 Docker Compose 模板 复制到 docker-compose.yml 文件中，并按需自定义（务必将所有占位符替换为你的实际配置）。然后运行 docker compose up -d 即可启动 Command Center 及其依赖项。注意：此方式仅推荐高级用户使用，因为它要求你熟悉 Docker 并在启动前完成必要的手动配置。

工作原理

NOMAD 是一个管理界面（称为 "Command Center"）与 API，通过 Docker 编排一组容器化的工具与资源。它负责所有组件的安装、配置与更新——你无需手动干预。

内置能力包括：

• 带知识库的 AI 聊天 — 基于 Ollama 的本地 AI 对话，也支持任何兼容 OpenAI API 的软件（例如 LM Studio 或 llama.cpp），并支持文档上传与语义检索（通过 Qdrant 实现 RAG）
• 信息库（Information Library） — 通过 Kiwix 提供离线维基百科、医学参考资料、电子书等
• 教育平台（Education Platform） — 通过 Kolibri 提供可汗学院课程与学习进度跟踪
• 离线地图（Offline Maps） — 通过 ProtoMaps 下载可离线查看的区域地图
• 数据工具（Data Tools） — 通过 CyberChef 进行加密、编码与分析
• 笔记（Notes） — 通过 FlatNotes 进行本地笔记
• 系统跑分（System Benchmark） — 硬件评分，并附带 社区排行榜
• 补给站（Supply Depot） — 一键应用目录（PDF 工具、文件浏览器、电子书库、密码管理器等），并支持运行你自己的自定义 Docker 容器
• 自动更新（Automatic Updates） — 可按你设定的计划，对核心软件、已安装的应用以及离线内容进行无需人工介入的更新
• 简易安装向导（Easy Setup Wizard） — 首次配置引导，提供精选的内容合集

NOMAD 还内置了诸如维基百科内容选择器、ZIM 资料库管理器、内容浏览器等工具。

包含的内容

设备要求

虽然许多类似的离线「生存电脑」是为最低配置的轻量硬件设计的，但 Project NOMAD 恰恰相反。为了安装并运行可用的 AI 工具，我们强烈建议你使用性能强劲、带 GPU 的设备，以充分发挥安装效果。

然而从核心来看，NOMAD 本身依然非常轻量。如果只部署管理应用本身，以下是所需的最小配置：

注意：Project NOMAD 未获得任何硬件厂商赞助，并被设计为尽可能与硬件无关。以下列出的硬件仅用于示例与对比参考。

最低配置

• 处理器：2 GHz 双核或更高
• 内存：4 GB 系统内存
• 存储：至少 5 GB 可用磁盘空间
• 操作系统：基于 Debian（推荐 Ubuntu 26.04 LTS）
• 稳定的互联网连接（仅在安装阶段需要）

如果要运行大语言模型以及其他内置 AI 工具：

推荐配置

• 处理器：AMD Ryzen 7 或 Intel Core i7 或更高
• 内存：32 GB 系统内存
• 显卡：NVIDIA RTX 3060 或同等级 AMD 及以上（显存越大，可运行的模型越大）
• 存储：至少 250 GB 可用磁盘空间（推荐使用 SSD）
• 操作系统：基于 Debian（推荐 Ubuntu 26.04 LTS）
• 稳定的互联网连接（仅在安装阶段需要）

如需了解三个价位区间（$150–$1,000+）的详细装机推荐，请参阅 Hardware Guide。

再次强调，Project NOMAD 本身非常轻量——决定你部署所需硬件规格的，是你选择与 NOMAD 一起安装的工具与资源。

在其他主机上运行 AI 模型

默认情况下，安装 AI 助手时，NOMAD 的安装程序会尝试在主机上配置 Ollama。不过，如果你希望在其他主机上运行 AI 模型，可以进入 AI 助手的设置界面，输入一个 Ollama 或兼容 OpenAI 的 API 服务器 URL（例如 LM Studio）。

请注意，如果你在其他主机上使用 Ollama，必须使用以下选项启动服务：OLLAMA_HOST=0.0.0.0。

Ollama 是使用 AI 助手的首选方式，因为它支持诸如模型下载等功能，而这些是 OpenAI API 所不支持的。因此，例如使用 LM Studio 时，你需要通过 LM Studio 自行下载模型。

你需自行负责在其他主机上配置 Ollama / OpenAI 兼容服务器。

常见问题解答（FAQ）

关于 Project NOMAD 的常见问题，请参阅我们的 FAQ 页面。

关于网络使用与隐私

Project NOMAD 专为离线使用而设计。互联网连接仅在初次安装（用于下载依赖）以及当你（用户）后续决定下载更多工具与资源时需要。除此之外，NOMAD 不需要联网，且内置遥测为零（ZERO built-in telemetry）。

为检测网络连通性，NOMAD 首先尝试请求 Cloudflare 的工具接口 https://1.1.1.1/cdn-cgi/trace。如果该接口不可达（例如你的网络屏蔽了 1.1.1.1），它会回退到应用本身已经会访问的其他接口（GitHub API 与 Project NOMAD API），只要其中任何一个有响应，就判定为在线。

你可以通过两种方式覆盖连通性检测所使用的接口：

• 在 UI 的 Settings → Advanced 中配置连通性测试 URL（仅保存在本地实例上）；
• 或设置环境变量 INTERNET_STATUS_TEST_URL。

当环境变量被设置时，它始终优先于 UI 中的配置。若两者均未设置，则使用上文所述的内置默认值。

关于安全

按设计，Project NOMAD 旨在保持开放与无障碍——它默认不包含身份验证。如果你在安装后将设备接入本地网络（例如允许其他设备访问其资源），可以通过开放或关闭端口来控制哪些服务对外暴露。

未来会加入身份验证吗？ 也许会。目前它不是首要任务，但如果需求足够大，我们可能会在未来的版本中考虑加入可选的身份验证层，以支持多用户访问同一实例但需要不同权限级别的场景（例如家庭场景下需要家长控制、教室场景下需要教师/管理员账户等）。我们已在公开路线图中就此提出了建议；如果你希望看到该功能，请在此点赞支持：https://roadmap.projectnomad.us/posts/1/user-authentication-please-build-in-user-auth-with-admin-user-roles

目前，如果你计划将 NOMAD 实例暴露给本地网络中的其他设备，我们建议使用网络层面的访问控制。NOMAD 并非为直接暴露在公网而设计，除非你非常清楚自己在做什么、已采取合适的安全措施并理解相关风险，否则我们强烈反对这样做。