企业官网建设流程全解析

听到舵机咔咔响的那一刹那，我以为这台机器狗最难的部分已经过去了。结果下一秒，电脑屏幕上蹦出一行红字：Could not resolve hostname puppy: Name or service not known，整个人当场愣住。机器就摆在桌面上，主板灯亮着，风扇转着，但我的电脑就是连不上它。

这不是个例。我后来在群里问了一圈，发现做过这类开源机器狗项目的朋友，十个里有六七个都卡在联网这一步上。更烦人的是，这类报错在不同系统里的表现还不太一样，有的写“Host does not exist”，有的写“Could not resolve hostname”，还有工具直接提示“找不到目标主机”。如果你正好也组装了一台、正在测试阶段被这个错误拦路，那这篇文章就是写给你看的。我会把组装过程中真正值得注意的细节、软件环境怎么搭、以及“Host does not exist”这类问题从根上怎么解决，全部梳理一遍。

需要说明的是，下面这些经验全部基于我自己实际组装、调试这台开源机器狗的过程。硬件版本、系统版本、路由器环境都可能和你不一样，但排查思路是通用的，照着链路走一遍，基本都能定位到问题。

1. 拆解机器狗的整体架构：12个舵机、四条腿和一个树莓派

在动手安装螺丝之前，先把这台机器狗到底在“跑什么”搞清楚。这个项目叫“机器狗”，但本质上它是一台12自由度（DOF）的四足机器人，每条腿有3个关节：髋关节负责左右抬腿，大腿关节负责前后摆动，小腿关节负责弯曲伸展。3个关节乘以4条腿，正好12路PWM信号，也就对应12个舵机。

控制链路并不复杂：树莓派负责跑运动学算法，通过I2C总线把角度指令发给舵机驱动板，驱动板再生成对应的PWM脉宽，控制每个舵机转到指定角度。机器狗能不能站起来、能不能走起来，核心就在这条链路里：“树莓派算得对 → 驱动板发得准 → 舵机转到位”。

1.1 从开源图纸开始：打印件、螺丝与公差

整套结构的零件几乎全是3D打印件。别小看这些塑料件，它们直接决定了后续装配的顺利程度。我用的是PLA材料，打印参数设置为层高0.2mm、壁厚1.2mm、填充度25%，打印出来的强度足够支撑机器狗的日常行走，没必要上ABS或者碳纤维混材。

实际操作中最让人头疼的是公差。开源图纸在设计时按标准M3螺丝孔和标准轴承位预留了尺寸，但不同打印机的收缩率不同，很多孔位打印出来会偏小。这时候千万不要用蛮力硬敲，很容易把塑料件敲裂。我准备了M3螺丝丝锥和一柄小圆锉，遇到太紧的孔位先手动过一遍丝锥，轴承位则用细砂纸卷成筒状轻轻打磨内壁，一边磨一边试装，直到轴承能用手轻轻推入、转动顺滑为止。

打印件还有一个容易忽略的点：打印方向。图纸里的STL文件已经按最优方向摆好了，调整方向打印可能省一点支撑材料，但会大大削弱受力部位的强度，尤其是在腿部连接件和髋关节支架这两个位置，受力方向一旦变了，走几步就会开裂。

1.2 舵机选型的取舍与供电预算

这个项目用到的舵机，严格说是“数字舵机”。核心参数有这么几个：扭矩、转速、电压范围和是否支持连续旋转。机器狗站立时每条腿承担约1/4机身重量，运动时会有动态冲击，扭矩太小的舵机根本扶不住机身。我实测下来，选择单舵机扭矩不低于15kg·cm的型号比较稳妥，轻量化的窄体舵机在这台机器上稍微有点勉强。

供电预算是另一个大坑。很多第一次做机器狗的朋友会低估舵机启动瞬间的电流。12个舵机同时动作时，瞬时电流很容易冲到5A甚至更高，这不是一个普通USB充电宝能扛住的。我一开始偷懒用充电宝给树莓派供电，结果舵机一动、电压一跌，树莓派直接重启，测试一度陷入僵局。后来老老实实做了双路供电：舵机用2S锂电池直接供给，树莓派则从独立的5V降压模块取电，中间不共用同一路电源。

这里我给一张简单的选型对比表，方便你根据手上的零件做判断：

2. 结构组装：打磨、中位与线材布局的真实体验

硬件选型和打印件都准备好之后，开始进入真正的组装环节。这部分的内容看起来零零碎碎，但每一个细节都会在后续测试中回馈给你——或者给你添堵。

2.1 舵机中位校准：这一步错了后面全是歪的

这是我在整个项目中最想强调的一步，没有之一。

舵机的“中位”指的是PWM脉宽为1.5ms时舵机输出轴所处的角度位置。组装机器狗时，每条腿的初始姿态完全依赖这个中位：机身要水平，腿要自然垂直于地面，全靠舵机在中位时舵盘安装的角度来保证。

很多第一次装机器狗的人，直接把舵机塞进打印件，装上舵盘就拧螺丝，结果一上电，机器狗的腿全部歪向外侧或者内侧。你以为这是代码参数的问题，调试了半天，其实根源是舵机安装前没有校准中位。

正确的做法是这样：先把舵机接上驱动板，用一段简单的测试代码让舵机输出1.5ms的中位脉冲，舵机输出轴会自动转到中位。然后在这个状态下，把舵盘安装到输出轴上，并让舵盘的缺口对齐输出轴的花键。此时舵盘的方向就是机器狗腿部连杆的基准方向。如果你手头的舵机没有自带中位测试程序，用PCA9685直接发一个固定脉宽即可。

以PCA9685为例，驱动板工作在50Hz频率下，周期为20ms。要输出1.5ms脉宽，对应的占空比计数就是：

4096 × (1.5 / 20) ≈ 307

所以在代码里让对应通道输出307这个计数值，舵机就会停在理论中位。

2.2 机架组装顺序与螺丝预装技巧

组装顺序上，我吃过一个亏：先装好了四条腿，再往机身上装，结果内部走线被堵得死死的，拧螺丝拧到怀疑人生。后来重新拆开，总结经验是按下面这个顺序来：

第一步，先把每条腿的三根连杆和对应的三个舵机单独组装好，但先不着急拧紧所有螺丝，保持关节可以自由活动；第二步，把每条腿的髋关节舵机固定到机身侧板的对应位置，注意区分左右腿的安装方向；第三步，将大腿和小腿的连杆稍微对位后，统一锁紧所有螺丝；第四步，最后才安装顶板和电池支架。

还有一个很实用的技巧：所有M3螺丝在拧入前，先在螺纹上蹭一点固体润滑剂或者蜡烛蜡。打印件的PLA材料偏软，直接拧容易滑丝。特别是同一个孔位需要反复拆装校准时，没有润滑的孔位可能拧两三次就报废了。

2.3 走线和电气隔离的细节

12个舵机的线如果不好好整理，反正是要炸的。舵机线从腿部延伸到机身内部，中间要经过关节活动区域，如果线的长度预留不够，腿部转到极限位置时会把线拉断或者扯掉端子。

我建议给每条腿的舵机线都做延长线，并且留出至少1.5倍的关节活动余量。线材选用硅胶软线，温度适应性好、柔韧性也强。机构内部用编织网管把同一束线套起来，再用扎带固定在机架侧板上，避免线材在机身运动时乱窜。

接线端子也需要格外注意：常见的舵机插头是2.54mm间距的3pin母座，线序多数是信号、正极、负极，但不同厂家、不同批次的舵机可能存在差别。插错正负极轻则舵机不转，重则直接烧掉驱动板。通电之前务必用万用表量一遍每个端子的电压和线序。

3. 软件链路搭建：为什么SSH是绕不开的一环

硬件组装完成，机器狗有了“身体”，接下来要给它装“大脑”。项目的主控程序跑在树莓派上，但没有屏幕也没有键盘，日常调试几乎全靠SSH连接。这也是“Host does not exist”这个问题最集中爆发的阶段。

3.1 系统烧录与开机第一件事

系统我用的是Lite版，不装桌面环境，纯命令行跑控制程序，资源占用少，干扰也小。烧录完系统后，先别急着拔卡，直接在烧录阶段做两件事：开启SSH服务和配置Wi-Fi。具体做法是在TF卡根目录创建两个文件：一个名为ssh的空文件，另一个名为wpa_supplicant.conf的网络配置文件，把家里的Wi-Fi名称和密码填进去。

机箱上电之后，等一分钟左右，树莓派会自动连上路由器。这时候还不知道它的IP是多少，最简单的办法是登录路由器管理后台，在DHCP客户端列表里找到名为raspberrypi或者你自己设置的主机名的设备，记录下它的IP。

用IP地址能SSH登录之后，我做的第一件事是修改主机名。开源控制程序里很多脚本和服务都依赖固定的主机名，默认的raspberrypi长得丑不说，在多台设备共存的网络环境里还容易冲突。修改主机名的命令很简单：

sudo hostnamectl set-hostname puppy sudo reboot

重启之后再用hostnamectl确认一下输出，确保确实是puppy而不是拼写错误。主机名的坑说白了就是拼写、大小写和空格，这三个问题能让你怀疑一整天的网络。

3.2 固定IP、主机名与SSH客户端配置

设备主机名改好之后，真正稳定的调试环境还差一步：固定IP。DHCP分配的IP地址不是一成不变的，今天连接是192.168.1.100，明天租约到期可能就变成了192.168.1.105。主机名没变，但对应的IP一直在变，这时候依赖主机名解析就会出问题。

所以老老实实做两件事。第一，在路由器后台给树莓派绑定一个DHCP静态保留地址，让路由器永远把同一个IP分配给树莓派。第二，在客户端机器的/etc/hosts（Windows则是C:\Windows\System32\drivers\etc\hosts，注意需要管理员权限）文件里加一行：

192.168.1.100 puppy

这样，在你自己的电脑上，puppy这个主机名就固定对应到了192.168.1.100，无论路由器那边怎么折腾都不会影响你。这一行配置，是我后来屡试不爽的终极保障。

4. “Host does not exist”排查七步：亲测有效的完整链路

这一部分，是整篇文章的重头戏。

我遇到的报错原文是这样的：在终端里输入ssh puppy，系统返回ssh: Could not resolve hostname puppy: Name or service not known。换到图形化SSH工具里，提示就更直接了：The host 'puppy' does not exist。

这个报错翻译成人话就是：你的电脑根本不知道puppy对应哪个IP地址。不是网络不通，也不是密码错，而是名字解析这一步就卡死了。网络世界找人靠IP，就像现实世界找人靠门牌号；“puppy”只是个昵称，你的电脑手里没有“昵称 → 门牌号”的对照表，自然找不到人。

4.1 第一步：先区分“解析失败”和“连接超时”

收到报错之后，先冷静下来，确认报错类型。三种最典型的SSH失败信息长这样，排错方向完全不同：

我见过不少人拿到“Connection refused”的报错，以为是主机名的问题，拼命去改hosts文件，折腾一晚也没用。所以第一步永远是先看清报错说的是哪一类。

4.2 第二步：直接用IP地址连接，验证物理链路

看到“Could not resolve hostname”之后，最快的验证方法是绕过主机名，直接用树莓派的IP地址连接：

ssh ubuntu@192.168.1.100

如果这个命令能秒连，说明树莓派本身没有毛病，问题100%出在“主机名解析”这一层。此时直接跳到第4.4、4.5步去修解析配置就行。

如果连IP地址都连不上，那问题出在更底层的网络链路上。这时候先回到路由器后台，确认树莓派是不是真的在线；再检查电脑和树莓派是否在同一个网段；然后ping 192.168.1.100看看有没有回包。不要跳过这些基础检查，我见过太多人在配置层面折腾半天，最后发现是网线松了。

4.3 第三步：检查树莓派主机名是否真的叫“puppy”

很多情况下，树莓派的主机名压根就不是你以为的那个。比如有朋友以为自己在配置文件里把主机名设成了“puppy”，实际那个文件是大小写写错了，主机名还是“Puppy”，或者多了一个空格。另外，系统烧录后默认主机名是raspberrypi，如果没有任何人改过它，你输入ssh raspberrypi试试可能一下就通了。

SSH登录树莓派之后，用下面几条命令核对一下：

hostname hostnamectl

确保输出里的主机名和你输入的命令完全一致，一个字母都不能差。

4.4 第四步：在客户端配置“puppy → IP”的映射

既然电脑手里没有“puppy”这个昵称对应的门牌号，那我们就手动把这张对照表塞给它。改客户端机器的hosts文件是最直接的办法。

Linux和macOS修改/etc/hosts，Windows修改C:\Windows\System32\drivers\etc\hosts，在文件末尾加一行：

192.168.1.100 puppy

存盘后重新执行ssh puppy，电脑再去解析puppy时，会第一个查这个本地hosts文件，一下就找到了。这一招我试过在macOS、Windows 11和Ubuntu三种系统上都有效，是解决“Host does not exist”最稳的方案。

4.5 第五步：启用mDNS，让你的主机名带个“.local”

如果不想手动维护hosts文件，也可以让主机名通过mDNS协议自动解析。mDNS相当于局域网里的“点名广播”，设备上线后自动告诉全网“我是puppy”，其他设备就能用puppy.local找到它。

需要做两件事。树莓派端安装服务：

sudo apt update sudo apt install avahi-daemon -y sudo systemctl enable avahi-daemon --now

客户端方面，macOS和Linux自带mDNS解析能力，不用额外装东西；Windows则需要安装Bonjour服务，装完之后，就可以直接用：

ssh puppy.local

需要注意的是，mDNS依赖局域网广播。如果电脑和树莓派不在同一个网段，或者路由器开启了“AP隔离”功能，mDNS也会失效。

4.6 第六步：检查SSH客户端配置文件的“坑”

还有一种情况：你已经配置好了~/.ssh/config文件，在里面写了：

Host puppy HostName 192.168.1.100 User ubuntu

理论上ssh puppy应该直接按文件里的配置连接。但如果这个配置文件里之前残留着其他错误条目，或者同一个Host puppy出现了两次，后者覆盖前者，也可能导致解析异常。检查方法很简单，在终端里执行：

ssh -v puppy

打开详细日志，看它在解析puppy时到底是走了哪一条路径：是查了hosts文件还是查了SSH config，日志里写得明明白白。

4.7 第七步：清理known_hosts里的旧指纹

如果以上几步都查过了，还是提示连接失败，但报错变成了Host key verification failed，那就是另一回事了。这个报错说的是“主机名能找到了，但是指纹对不上”，常见于树莓派重装系统后IP不变、但主机的身份密钥变了。

解决办法是把旧指纹从known_hosts里删掉：

ssh-keygen -R puppy ssh-keygen -R 192.168.1.100

然后再连一次，系统会重新询问你确认指纹，输入yes即可。

到这里，“Host does not exist”这个问题的完整排查链路就结束了。我给出的七步中，第二步和第四步的组合基本能解决90%的情况。核心思路就是：别让它猜名字，直接把名字和IP的对应关系写死；如果非要让它猜，就把mDNS服务装好。

5. 跑起来之后的坑：从抽搐到站直再到步态

连接问题解决，软件环境搭好，机器狗终于能连上了。但真正的战斗才刚刚开始——运动控制测试里还有一堆让人血压升高的坑在等着。

5.1 上电顺序与舵机抽搐现象

无论是在测试台上还是在地面上，给机器狗上电都很有讲究。我第一次上电时，舵机全部疯狂抽搐，机身像抽风一样抖了五六秒，吓得我赶紧断电。后来才想明白，是控制程序已经在开机自启中运行了，但驱动板还没完成初始化，双方节奏没对上，瞬间电流也把电源电压拉得很低。

标准做法很简单：**先给驱动板和舵机上电，等舵机稳定在中位，再启动树莓派上的控制程序。**你甚至可以写一个手动启动脚本，不要把这个程序设置成开机自启。等到调完参、确认一切稳定后，再考虑服务化部署的事。

5.2 初始姿态与关节方向调校

机器狗能不能站稳，首先取决于初始姿态对不对。我调好中位之后，第一次运行“站立”指令时，机器狗的右前腿不落地，左后腿又反着蜷起来，活脱脱一只生病的螃蟹。

问题出在关节方向配置上。因为左右两侧的关节安装方向相反，同一角度数值在左腿和右腿上产生的实际运动方向是镜像的。开源控制程序的配置里有一个关节方向（正负号）的配置项，需要根据实际情况逐个调整。正确顺序是：

先不装腿，让每个关节单独输出一个固定角度，用眼睛观察实际转动方向和程序预期是否一致；然后记下需要反向的通道；把反向标志填进配置；最后装好整机，观察四条腿的初始姿态是否对称且垂直于地面。

这个小步验证的方法，可以帮你把“装反了”和“算错了”这两个问题彻底分开。别跳过它，直接调步态参数的话，你会被乱七八糟的腿部轨迹逼疯。

5.3 步态抖动、重心和续航实测

机器狗能站直之后，开始调步态。开源程序里常见的几个参数是步频、抬腿高度、摆动距离。一开始我把步频调得过高，机器狗每一步都在原地哆嗦，舵机发出高频尖啸，机身明显抖动。把步频从3Hz降到1.5Hz之后，动作立刻变得沉稳许多。

还有一个非常容易被忽视的点：重心位置。电池如果固定得太靠后，机器狗一起步就前倾下栽；如果太靠前，后腿又会悬空。我用魔术贴把电池横放在机身后部中央位置，前后移动进行测试，最终找到了一个让四条腿受力均衡的位置。说句实在话，调整电池位置比调任何参数都见效快。

续航方面，我用的是2S电池配降压模块的方案，在普通平坦地面上持续行走测试，连续跑大约25分钟后，舵机明显发烫、动作变软，就该休息了。机器狗的运动控制是个“高电流短续航”场景，电池容量和放电倍率比机身重量更值得优先保证。

整套项目做下来，我的体会是：硬件组装反而还好，真正磨人的地方在“每个细节都要有逻辑可循”。尤其是“Host does not exist”这一类报错，看起来是网络问题，其实本质上是对象命名和解析的问题。最后再分享一个小技巧：把puppy对应的固定IP写进客户端hosts之后，以后不管重启多少次、路由器怎么闹脾气，SSH都能秒连。我后来换了三次路由器，都没再遇到过这个报错。