Crosstalk-Solutions/project-nomad 来源: https://github.com/Crosstalk-Solutions/project-nomad # Project N.O.M.A.D. ### 离线媒体、档案与数据节点 永不掉线的知识 网址: https://www.projectnomad.us Discord: https://discord.com/invite/crosstalksolutions 基准测试: https://benchmark.projectnomad.us — Project N.O.M.A.D. 是一个自包含、优先离线的知识与教育服务器，内置了关键工具、知识和人工智能，让您随时随地保持信息灵通与能力在线。 ## 安装与快速启动 Project N.O.M.A.D. 可安装在任何基于 Debian 的操作系统上（推荐 Ubuntu）。安装过程完全基于终端，所有工具和资源均可通过浏览器访问，因此如果您希望将 N.O.M.A.D. 设置为“服务器”并通过其他客户端访问，甚至无需桌面环境。 注意：运行安装脚本需要 sudo/root 权限 ### 快速安装（仅限基于 Debian 的操作系统） bash 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 N.O.M.A.D. 已安装在您的设备上！打开浏览器并访问 http://localhost:8080（或 http://设备IP:8080）即可开始探索！ 如需完整的分步说明（包括 Ubuntu 安装），请参阅安装指南 (https://www.projectnomad.us/install)。 Windows 用户请参阅 WSL2 安装指南 (https://www.projectnomad.us/install/wsl2) —— 该社区支持的路径涵盖原生 Docker 和 Docker Desktop 安装方式。 ### 高级安装 如需对安装过程有更多控制，请将 Docker Compose 模板 (https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/management_compose.yaml) 复制到 docker-compose.yml 文件中，并按需自定义（请务必将占位符替换为实际值）。然后运行 docker compose up -d 启动命令中心及其依赖项。注意：此方法仅推荐给高级用户使用，因为它需要熟悉 Docker 并在启动前进行手动配置。 ## 工作原理 N.O.M.A.D. 是一个管理 UI（“命令中心”）和 API，通过 Docker (https://www.docker.com/) 编排一组容器化的工具和资源。它负责所有内容的安装、配置和更新——您无需操心。 内置功能包括： - AI 聊天与知识库 —— 基于 Ollama (https://ollama.com/) 的本地 AI 聊天，也可使用兼容 OpenAI API 的软件（如 LM Studio 或 llama.cpp），支持文档上传与语义搜索（RAG 基于 Qdrant (https://qdrant.tech/)） - 信息图书馆 —— 离线维基百科、医学参考资料、电子书等，由 Kiwix (https://kiwix.org/) 提供支持 - 教育平台 —— Khan Academy 课程，支持进度追踪，由 Kolibri (https://learningequality.org/kolibri/) 提供支持 - 离线地图 —— 可下载区域地图，由 ProtoMaps (https://protomaps.com) 提供支持 - 数据工具 —— 加密、编码与分析，由 CyberChef (https://gchq.github.io/CyberChef/) 提供支持 - 笔记 —— 本地笔记记录，支持 Markdown，由 FlatNotes (https://github.com/dullage/flatnotes) 提供支持 - 系统基准测试 —— 硬件评分与社区排行榜 (https://benchmark.projectnomad.us) - 简易安装向导 —— 引导式首次配置，附带精选内容集合 N.O.M.A.D. 还包含内置工具，如维基百科内容选择器、ZIM 库管理器和内容浏览器。 ## 包含的内容 | 功能 | 技术提供 | 你得到什么 | |———–|———–|———––| | 信息图书馆 | Kiwix | 离线维基百科、医学参考资料、生存指南、电子书 | | AI 助手 | Ollama + Qdrant | 内置聊天，支持文档上传与语义搜索 | | 教育平台 | Kolibri | Khan Academy 课程、进度追踪、多用户支持 | | 离线地图 | ProtoMaps | 可下载的区域地图，支持搜索与导航 | | 数据工具 | CyberChef | 加密、编码、哈希与数据分析 | | 笔记 | FlatNotes | 本地笔记记录，支持 Markdown | | 系统基准测试 | 内置 | 硬件评分、构建标签与社区排行榜 | ## 硬件需求 虽然许多类似的离线生存计算机设计为在最低配置的轻量硬件上运行，Project N.O.M.A.D. 正好相反。为了安装和运行可用的人工智能工具，我们强烈建议使用性能强劲、带 GPU 的设备，以充分利用安装。但 N.O.M.A.D. 核心本身仍然非常轻量。对于管理应用本身的基础安装，需要以下最低规格： 注意：Project N.O.M.A.D. 未受任何硬件厂商赞助，旨在尽可能与硬件无关。以下列出的硬件仅供示例/对比之用 #### 最低配置 - 处理器：2 GHz 双核处理器或更高 - 内存：4 GB 系统内存 - 存储：至少 5 GB 可用磁盘空间 - 操作系统：基于 Debian（推荐 Ubuntu） - 稳定的互联网连接（仅在安装时需要） 若要运行 LLM 及其他包含的 AI 工具： #### 推荐配置 - 处理器：AMD Ryzen 7 或 Intel Core i7 或更高 - 内存：32 GB 系统内存 - 显卡：NVIDIA RTX 3060 或 AMD 同级或更高（显存越大，可运行的模型越大） - 存储：至少 250 GB 可用磁盘空间（推荐 SSD） - 操作系统：基于 Debian（推荐 Ubuntu） - 稳定的互联网连接（仅在安装时需要） 有关三个价位（150–1,000+）的详细构建建议，请参阅硬件指南 (https://www.projectnomad.us/hardware)。 再次强调，Project N.O.M.A.D. 本身相当轻量——决定您特定部署所需配置的，是您选择与 N.O.M.A.D. 一起安装的工具和资源。 #### 在不同主机上运行 AI 模型 默认情况下，N.O.M.A.D. 的安装程序会在安装 AI 助手时尝试在主机上设置 Ollama。但如果您希望在不同主机上运行 AI 模型，可以进入 AI 助手的设置，输入 Ollama 或兼容 OpenAI API 的服务器（如 LM Studio）的 URL。注意：如果您在不同主机上使用 Ollama，必须使用以下选项启动服务器：OLLAMA_HOST=0.0.0.0。Ollama 是使用 AI 助手的首选方式，因为它具有 OpenAI API 不支持的模型下载等功能。因此，如果使用 LM Studio，您需要用 LM Studio 下载模型。您需自行负责在其他主机上设置 Ollama/OpenAI 服务器。 ## 常见问题（FAQ） 关于 Project N.O.M.A.D. 常见问题的答案，请参阅我们的 FAQ 页面。 ## 关于网络使用与隐私 Project N.O.M.A.D. 专为离线使用而设计。仅在初始安装时（以下载依赖）以及用户决定稍后下载其他工具和资源时需要互联网连接。除此之外，N.O.M.A.D. 不需要互联网连接，并且完全不含内置遥测功能。为测试网络连通性，N.O.M.A.D. 会尝试向 Cloudflare 的实用端点 https://1.1.1.1/cdn-cgi/trace 发送请求，并检查是否收到成功响应。 ## 关于安全性 根据设计，Project N.O.M.A.D. 旨在开放且无门槛使用——它不包含任何身份验证。如果您在安装后将设备连接到本地网络（例如允许其他设备访问其资源），可以通过阻止/开放端口来控制哪些服务被暴露。 未来会添加身份验证吗？ 有可能。目前这不是优先事项，但如果需求足够，我们可能会考虑在未来的版本中构建可选的认证层，以支持多用户需要访问同一实例但拥有不同权限级别的场景（例如家庭使用中的家长控制、教室使用中的教师/管理员账户等）。我们在公共路线图上已有相关建议，如果您希望看到此功能，请在此投票：https://roadmap.projectnomad.us/posts/1/user-authentication-please-build-in-user-auth-with-admin-user-roles 目前，如果您计划将 N.O.M.A.D. 实例暴露给局域网中的其他设备，我们建议使用网络级控制来管理访问。N.O.M.A.D. 并非设计为直接暴露在互联网上，我们强烈建议不要这样做，除非您非常清楚自己在做什么、已采取适当的安全措施，并且了解所涉及的风险。 ## 贡献 欢迎并感谢贡献！请参阅 CONTRIBUTING.md 了解如何为项目贡献。 ## 社区与资源 - 网站： www.projectnomad.us (https://www.projectnomad.us) —— 了解更多项目信息 - Discord： 加入社区 (https://discord.com/invite/crosstalksolutions) —— 获取帮助、分享构建、与其他 NOMAD 用户交流 - 基准测试排行榜： benchmark.projectnomad.us (https://benchmark.projectnomad.us) —— 查看您的硬件与其他 NOMAD 构建的对比 - 故障排除指南： TROUBLESHOOTING.md —— 查找常见问题的解决方案 - 常见问题： FAQ.md —— 查找常见问题的答案 - 社区附加组件： admin/docs/community-add-ons.md —— 社区构建的第三方内容包 ## 许可证 Project N.O.M.A.D. 遵循 Apache License 2.0 许可。 ## 辅助脚本 安装完成后，Project N.O.M.A.D. 会提供一些辅助脚本，供您在需要通过命令中心之外进行故障排除或维护时使用。所有脚本都位于 N.O.M.A.D. 的安装目录 /opt/project-nomad 中。 ### ###### 启动脚本 - 启动所有已安装的项目容器 bash sudo bash /opt/project-nomad/start_nomad.sh ### ###### 停止脚本 - 停止所有已安装的项目容器 bash sudo bash /opt/project-nomad/stop_nomad.sh ### ###### 更新脚本 - 尝试拉取命令中心及其依赖项（如 mysql）的最新镜像并重新创建容器。注意：此脚本仅更新命令中心容器。它不会更新可安装的应用容器——这应该通过命令中心 UI 完成。 bash sudo bash /opt/project-nomad/update_nomad.sh ###### 卸载脚本 - 需要重新开始？使用卸载脚本让您省心。注意：此操作不可逆！ bash 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