在 Ubuntu 中使用 Copidar 的简明指南
一 确认工具类型与安装方式
- 先确认你要使用的是哪一类工具，不同来源的 copidar 安装与用法差异很大。常见可能性包括：
- Node.js 的全局命令行工具：通过 npm 安装，命令为：sudo npm install -g copidar。
- C/C++ 项目（如激光雷达控制）：从源码构建，涉及 libusb-1.0-0-dev、CMake、make 等步骤。
- 系统软件包（如 3D 打印机工具）：可能通过 apt 安装（示例：sudo apt install copidar）。
- 快速确认是否已安装：运行 which copidar；若未安装，先安装 Node.js/npm 或准备构建环境后再安装。
二 通用安装与启动步骤
- 若通过 npm 安装
- 安装依赖：sudo apt update && sudo apt install nodejs npm
- 全局安装：sudo npm install -g copidar
- 验证：copidar --version 或 copidar --help
- 若从源码构建（C/C++ 场景）
- 安装依赖：sudo apt-get update && sudo apt-get install libusb-1.0-0-dev
- 获取源码并构建：
- git clone https://github.com/strawlab/copidar.git
- cd copidar && mkdir build && cd build
- cmake … && make
- sudo make install
- 若通过 apt 安装（如 3D 打印机工具）
- 直接安装：sudo apt install copidar
- 启动与帮助
- 启动：直接运行 copidar（或带参数启动）
- 查看用法：copidar --help（不同实现会显示不同的参数与子命令）
三 常见用法示例
- 作为 Node.js 工具的常见用法
- 指定监听地址与端口：copidar -H 0.0.0.0 -p 6000
- 使用配置文件：copidar --config config.json
- 查看帮助与版本：copidar --help / copidar --version
- 作为网络扫描类工具的常见用法
- 扫描本地网段端口：copidar -p 1-255
- 扫描指定主机端口范围：copidar -H 192.168.1.1 -p 80-443
- 启用详细模式：copidar -v -p 1-100
- 作为激光雷达控制工具的常见用法
- 连接设备后查看是否识别：lsusb
- 启动采集/控制：copidar（具体参数以项目文档为准）
- 作为 3D 打印机管理工具的常见用法
- 查看状态：copidar status
- 设置喷嘴温度：copidar settemp 0 210
- 暂停/恢复/关闭：copidar pause / copidar resume / copidar shutdown
- 说明：不同来源的 copidar 命令集与参数差异较大，请以实际安装包的 --help 输出为准。
四 故障排查与注意事项
- 权限与路径
- 检查是否已安装：which copidar；若提示未找到，请先完成安装。
- 某些场景可能需要 sudo；更推荐通过用户级 npm 配置或调整权限避免长期使用 sudo。
- 端口与防火墙
- 若工具启动 Web 服务或监听端口，放行对应端口（如 8080、6000 等）：sudo ufw allow 8080/tcp 或 sudo ufw allow 6000/tcp；远程访问时确保监听地址为 0.0.0.0 而非仅 localhost。
- USB/硬件访问（C/C++/激光雷达场景）
- 安装 libusb-1.0-0-dev，连接设备后使用 lsusb 确认识别；若权限不足，可配置 udev 规则或以合适权限运行。
- 合规与安全
- 若工具具备网络扫描能力，请确保对目标网络具备授权，遵守当地法律法规，避免对未授权主机进行扫描。
