机载调试一句话掌握最容易踩的误解——ssh root单独写不是「以 root 用户登录」而是「登录到一台名为 root 的主机」等价于ssh 本地用户root通常报 Could not resolve hostname root正确写法是ssh rootIP。目录适用人群与前置一、SSH 远程登录基础1.ssh root是什么指令2. 正确写法3. 免密登录流程链4. 无人机上典型用途5. 常见报错含义6. 安全提醒7. 排障顺序二、专业名词总表44 项分类速查1. 连接与链路12 项2. 通讯协议与传输10 项3. 定位与差分9 项4. 飞控与调试8 项5. 测试与运维5 项三、术语速查本章 SSH 相关四、机载调试检查单五、来源与勘误适用人群与前置面向使用 SSH 调试机载计算机树莓派 / Jetson / 伴飞电脑的开发者、运维与现场支持。建议先具备Linux 用户与权限概念、SSH 客户端基本认知。一、SSH 远程登录基础1.ssh root是什么指令SSHSecure Shell安全外壳是加密的远程登录/命令执行协议。其语法为ssh [选项] [用户]主机名关键点只给一个参数时它被当作主机名用户名默认取本地当前登录用户名。所以ssh root实际等价于ssh 本地用户名root通常报Could not resolve hostname root——因为系统试图找一台叫 root 的主机而不是以 root 用户登录。2. 正确写法命令说明ssh root192.168.1.100最常用ssh -l root 192.168.1.100等价-l 指定登录名ssh -p 2222 root…非默认端口默认 22ssh -i ~/.ssh/id_ed25519 roothost指定私钥文件登录配置别名多机场景强烈推荐在~/.ssh/config写Host drone1 / HostName / User / Port之后直接ssh drone1即可。编队多机时给每架飞机配一个别名批量运维效率差别很大。3. 免密登录流程链ssh-keygen -t ed25519 生成密钥对 → ssh-copy-id root192.168.1.100 推公钥 → 之后不再输密码4. 无人机上典型用途用途示例命令登录机载计算机查状态改配置树莓派/Jetson/伴飞电脑拉取飞行日志scp roothost:/path/*.ulg ./远程执行单条命令ssh roothost systemctl restart mavros端口转发把机载 Web 服务映射到本机ssh -L 8501:localhost:8501 roothostscp 说明scpSecure Copy安全复制是走 SSH 的文件传输工具语法与 cp 类似roothost:路径表示远端文件。5. 常见报错含义报错含义 / 处理Could not resolve hostname root把用户名当成了主机名需写rootIPConnection refusedsshd 未启动 / 端口不对 / 被防火墙拦截Permission denied认证失败密码/密钥错误Host key verification failed执行ssh-keygen -R host清除旧指纹后重连连接超时网络不通或被防火墙拦截排障时加-v或-vvv看详细过程6. 安全提醒PermitRootLogin控制是否允许 root 直接登录对公网暴露的主机不建议放开 root 密码登录。默认 22 端口暴露公网极易被扫描爆破建议改端口并只允许密钥认证。7. 排障顺序先加-vvv看握手到哪一步失败。确认第一跳网络是否通ping / 网段。确认 sshd 端口与监听ss -tlnp | grep ssh。确认认证方式与密钥权限PermitRootLogin、~/.ssh权限。二、专业名词总表44 项分类速查使用建议遇到「连不上 / 数据跳变 / 定位漂移 / 指令不生效」四类现象时先对照本表确认涉及的名词定义是否理解一致避免名词错位导致误判。1. 连接与链路12 项名词中文/解释一句话解释与要点信道传输通道2.4GHz 上互不重叠的只有 1/6/11频段频率范围如 2.4GHz / 5.8GHz / 1430-1444MHz带宽频谱宽度或吞吐注意区分「信道带宽」MHz 与「吞吐带宽」MbpsAP接入点WiFi 网络枢纽设备STA站点无线终端如飞机、手机SSID网络名给人看的名字隐藏 SSID 不构成认证DHCP动态主机配置自动分配 IP地址池耗尽会「连不上」NAT网络地址转换内网/公网 IP 映射蜂窝后端在其后APN接入点名称蜂窝网络接入标识SIM 上网必配RSSI接收信号强度典型 -30 极好到 -90 极差丢包率丢包占比升高先于彻底断开出现抖动延迟波动比平均延迟更影响实时控制2. 通讯协议与传输10 项名词中文/解释一句话解释与要点波特率每秒符号数不匹配表现为乱码或彻底连不上帧数据包协议层成帧的数据单元分帧数据切片把长数据拆成多帧传输校验错误检测MAVLink 用 CRC-16/MCRF4XX序号帧编号MAVLink 用 seq 字段检测丢帧/乱序ACK确认应答确认收到配合超时重传重传重发配合递增的 confirmation 字段避免被当成新指令SYSID/COMPID系统/组件号标识哪架飞机的哪个组件半双工收发分时同一时刻只能发或收如 WiFi/数传透传透明转发数据原样转发不做解析3. 定位与差分9 项名词中文/解释一句话解释与要点RTK实时动态差分定位用差分改正实现厘米级定位基准站已知坐标参考站坐标不准误差会进入流动站流动站移动接收机接收基准站改正数解算RTCM差分数据格式广播改正数的标准协议NTRIP网络差分传输通过互联网传差分数据的协议Fixed/Float固定解/浮点解Fixed 厘米级、Float 分米级基线长度基准-流动距离超出 10-30km 后误差空间相关性变差HDOP/PDOP精度因子越小定位精度越好双天线定向双天线测向两副天线测方位角用于飞行器定向4. 飞控与调试8 项名词中文/解释一句话解释与要点Arm/Disarm解锁/上锁空中上锁会导致掉落飞行模式控制模式手动/定高/自动/Offboard 等Offboard外部控制中断约 0.5 秒自动切出EKF卡尔曼滤波估计融合惯性/磁力/GPS 的导航状态估计uORB微发布-订阅总线PX4 内各模块消息通道参数可调参数PX4 参数名长上限 16 字符Failsafe失效保护链路/信号丢失时自主处置Geofence地理围栏限制飞行范围5. 测试与运维5 项拉距测试、覆盖测试、冷启动/热启动、校准、日志 ULog。名词一句话解释拉距测试测试遥控/链路最大有效距离覆盖测试验证地面/空中各区域链路覆盖冷启动/热启动接收机冷启动需重新定位热启动利用已存星历更快校准让飞控匹配实际安装的电罗盘/加速度计等三、术语速查本章 SSH 相关缩写/术语中文全称一句话解释SSH安全外壳Secure Shell加密远程登录/命令执行协议scp安全复制Secure Copy走 SSH 的远程文件传输工具systemctl系统服务管理命令管理 Linux 服务如 systemctl restartroot超级用户Linux 最高权限账号私钥/公钥密钥对SSH 免密登录的认证凭据四、机载调试检查单能通先于能连确认第一跳网络ping IP再看 sshd 端口与服务。认证明确用户名写全rootIP不用单参数ssh root。免密与别名多机批量运维配置 SSH config 别名与密钥免密。日志归档用 scp 按「日期机号架次」拉取 .ulg 日志。权限与安全控制 PermitRootLogin公网改端口并只允许密钥。名词统一排障前先对照第 2 节术语表统一名词定义。五、来源与勘误依据来源本文基于 SSH 标准用法、Linux/系统运维通用实践、PX4/MAVLink 与 RTK 行业通用口径整理。