在 Ubuntu 上使用 Copidar 的实用指南
一 名称与用途澄清
- 目前公开资料中，copidar 在不同文章里被描述为多种不同工具的名称，常见包括：
- 基于 Node.js/npm 的命令行工具（可能用于启动本地服务、网络扫描或代码覆盖率）。
- 面向 激光雷达 的命令行工具（需要 libusb-1.0-0-dev、从源码构建，连接 USB 设备采集数据）。
- 面向 3D 打印机 的管理工具（提供 status、settemp、pause、resume 等子命令）。
- 由于用途差异较大，建议先确认你手头的具体项目或设备，再按对应路径安装与使用。若你不确定，请先执行：which copidar 与 copidar --version 查看本地可执行文件与版本信息，并查阅该项目的 README/官方文档以确认功能定位。
二 通用安装与快速验证
- 若你的 copidar 属于 Node.js 生态（很多教程采用此方式）：
- 安装依赖：sudo apt update && sudo apt install -y nodejs npm
- 全局安装：sudo npm install -g copidar
- 验证安装：copidar --version 或 which copidar
- 若你的 copidar 是激光雷达工具（C/C++ 源码构建）：
- 安装依赖：sudo apt-get update && sudo apt-get install -y libusb-1.0-0-dev
- 获取源码并构建（示例）：
- git clone https://github.com/strawlab/copidar.git
- cd copidar && mkdir build && cd build
- cmake … && make
- sudo make install
- 连接设备后用 lsusb 检查是否识别，再按项目 README 执行相应命令。
- 若你的 copidar 提供系统包（少数教程提到）：sudo apt install copidar（可用性取决于你的发行版与仓库）。
三 常见用法示例
- Node.js/npm 版本（服务或扫描类用法，端口以项目实际为准）
- 启动服务：copidar
- 指定监听地址与端口：copidar -H 0.0.0.0 -p 6000
- 使用配置文件：copidar --config config.json
- 查看帮助：copidar --help
- 激光雷达版本（USB 采集类用法）
- 连接设备并检查：lsusb
- 运行采集/控制：copidar（具体子命令与参数以项目文档为准）
- 3D 打印机版本（设备管理类用法）
- 查看状态：copidar status
- 设置喷嘴温度：copidar settemp 0 210
- 暂停/恢复：copidar pause / copidar resume
- 安全关机：copidar shutdown
- 调试信息：copidar debug
- 提示：不同项目的命令、参数与默认端口差异很大，请以你实际安装的项目的帮助信息为准（copidar --help）。
四 故障排查与注意事项
- 权限与端口
- 若报权限错误或端口被占用，优先检查端口占用：ss -tulpen | grep <端口>；必要时更换端口或以具有相应权限的用户运行。
- 远程访问时，确保监听地址为 0.0.0.0 并在防火墙放行对应端口（如 UFW：sudo ufw allow <端口>/tcp）。
- USB/设备访问（激光雷达场景）
- 未识别时确认设备连接、供电与驱动；必要时检查 udev 规则或以 sudo 运行（注意安全）。
- 合法合规（网络扫描场景）
- 若工具具备端口/网络扫描能力，请确保对目标网络具备明确授权，遵守当地法律法规与网络使用政策。