project-nomad

环境要求

• 基于 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

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:8080（或 http://设备IP:8080）能正常显示 NOMAD 界面，即安装成功。

常见问题

注意事项

• 安装脚本必须用 sudo/root 运行，普通用户权限会失败。
• NOMAD 本体约 5 GB 磁盘、1 GB 以内内存，真正占空间的是后续下载的离线内容，AI 助手会明显抬高内存需求。
• 卸载脚本不可撤销，执行前请确认无需保留数据。
• 一键安装脚本仅适用于 Debian 系系统，其他发行版请参考官网安装指南或走 Docker Compose 方式。