# eai_deploy

**Repository Path**: eai-navigation-lab/eai_deploy

## Basic Information

- **Project Name**: eai_deploy
- **Description**: eai_deploy：专注于eai_next项目部署工作。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-11-06
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# eai_deploy

#### 介绍
eai_deploy：专注于eai_next项目部署工作。

#### 软件架构
软件架构说明（Ubuntu 22）
- LinuxARM适用于基于 ARM 架构的嵌入式设备（如Orin、树莓派、工控机等）。
- Linuxx86适用于基于 Intel/AMD 架构的标准 PC 或服务器。


#### DEB 方式部署教程

1. [点击查看 eai-next 全部发行版](https://gitee.com/eai-navigation-lab/eai_deploy/releases)  
2.  下载对应版本的 deb 包
3.  打开终端安装所下载的软件包
    ```bash
    cd your/path/to/<deb_name>.deb
    sudo dpkg -i <deb_name>.deb
    ```
4.  安装 `eai_next` 所需依赖与环境配置 进入 `eai_next` 目录并运行自动化脚本
    ```bash
    cd ~/eai_next
    bash install_requirements.sh
    ```
- `install_requirements.sh` 脚本功能说明（如检测到已安装/配置会自动跳过）：
    - **网络检查**：自动检测网络连接状态是否正常
    - **`ROS2` 环境**：检查并自动安装 `ROS2-humble`
        - 【1】一键安装(推荐) ROS(支持ROS/ROS2,树莓派Jetson)
        →【2】更换系统源再继续安装→【2】更换系统源并清理第三方源→【1】自动测速选择最快的源→【1】中科大镜像源 (推荐国内用户使用)→【1】humble(ROS2)→【1】humble(ROS2)桌面版
    - **依赖管理**：自动安装程序运行所需的系统依赖库
    - **特定设备适配**：
        - 合众 NX：按需提示是否配置静态 IP 与优先级
            - Realtek(左)：192.168.254.101；Intel(右)：192.168.1.101
            - 优先级：Realtek(左) > Intel(右)
        - 其他设备：自动跳过此步骤，不进行提示
    - **EAI 中控台 WEB 服务自启**：提供选项配置是否开启 `eai-next` 中控台自启服务
        - 将 EAI 中控台 WEB 服务以桌面快捷方式(.desktop)加入`~/.config/autostart`实现开机自启动
        - 连接机器人打开浏览器输入：`机器人IP:8080`进入 WEB 页面(默认`192.168.254.101:8080`)


#### 首次部署推荐使用 `EAi_Navi_Deploy`

1.  **克隆/下载`EAi_Navi_Deploy`**：
- 将`EAi_Navi_Deploy`直接克隆/下载或拷贝到机器人中，进入`EAi_Navi_Deploy`目录并运行自动化脚本
    ```bash
    cd your/path/to/EAi_Navi_Deploy
    bash install.sh
    ```
- `install.sh` 脚本功能说明（如检测到已安装/配置会自动跳过）：
    - **安装 Firefox**：安装支持合众 NX 的 `Firefox` 浏览器
    - **锁定 NVIDIA 相关包**：防止误触 `Upgrade` 相关操作造成系统崩溃
    - **安装常用软件**：检查并自动安装 `vscode`、`nomachine`、`eai-next`
    - **特定设备适配**：
        - 合众 NX：按需提示是否配置静态 IP 与优先级
            - Realtek(左)：192.168.254.101；Intel(右)：192.168.1.101
            - 优先级：Realtek(左) > Intel(右)
        - 其他设备：自动跳过此步骤，不进行提示
    - **EAI 中控台 WEB 服务自启**：提供选项配置是否开启 `eai-next` 中控台自启服务
        - 将 EAI 中控台 WEB 服务以桌面快捷方式(.desktop)加入`~/.config/autostart`实现开机自启动
        - 连接机器人打开浏览器输入：`机器人IP:8080`进入 WEB 页面(默认`192.168.254.101:8080`)
    - **其他配置**：如有`conda`环境，关闭 base 自动激活
2.  安装 `eai_next` 所需依赖与环境配置 进入 `eai_next` 目录并运行自动化脚本
    ```bash
    cd ~/eai_next
    bash install_requirements.sh
    ```

#### 使用说明
1.  进入 `eai_next` 目录并查看`README.md`，或通过 WEB ROBOT 中控台操作：
    ```bash
    # 连接机器人 wifi，或与相同网段localhost ，打开网页输入以下网址(端口：8080)
    http://127.0.0.1:8080/
    http://192.168.254.101:8080/    # 局域网

    # 127.0.0.1、localization ：只在本机访问本机服务用，外面访问不到
    # 192.168.254.101 ：局域网内其他机器访问这台机器的服务用
    ```

#### 程序卸载与更新(建议提前保存地图和点位数据)：

```bash
# 完全卸载 EAI-NexT (录制的点位和上传的地图会被一并清除)
sudo apt purge eai-next

# 更新：覆盖旧版本 (点位、地图和虚拟墙数据不会被覆盖)
cd your/path/to/<new_deb_name>.deb
sudo dpkg -i <new_deb_name>.deb
```