企业官网建设流程全解析

第一次拿到香橙派（orangepi）开发板的人，大概率会被同一个问题卡住：板子已经通电了、SD卡也已经刷好系统了，但没有显示器也没有键盘鼠标，人坐在电脑前，面对一块只有几颗指示灯的小板子，完全不知道下一步该干嘛。查IP和SSH登录，就是解决这个困境的第一步。简单说，IP是板子在局域网里的门牌号，SSH是一条加密的远程对话通道，打通这两样，你就能像操作一台远程服务器一样，在电脑上给板子敲命令、改配置、跑程序。这篇内容就是要把这条从零到一的链路讲透，覆盖查IP的四种可靠办法、SSH登录的完整步骤、连不上时的系统排查思路，以及登录后建议第一时间做的几件事。适合刚拿到板子的新手，也适合想把手里的板子从"能开机"变成"随手可用"的老玩家。

1. 拿到板子先别急着敲命令：理清"查IP+SSH"这条主链路

1.1 无头模式：为什么开发板不接显示器也能用

普通电脑开机之后，人通过屏幕和键鼠跟操作系统打交道。开发板不一样，它被设计成可以完全不接显示器、键盘和鼠标来工作，这种用法叫"无头模式"（headless）。很多玩家的实际状态是：板子塞在弱电箱旁边、路由器柜子里，甚至直接挂到墙上当迷你服务器，根本没有位置摆显示器。这时候，唯一的操作入口就是SSH。

SSH协议做的事情看起来很简单：在你电脑的命令行里，建立一个加密通道，连接到板子上的Shell进程。之后你敲的每一条命令、板子返回的每一行输出，都走这条加密通道，别人在局域网里抓包也看不懂内容。这个过程本质上跟"远程操作一台电脑"没有区别，只是那头连的不是机房里的服务器，而是一块巴掌大的开发板。

所以整条链路的关键节点其实只有两个：一是拿到板子当前的IP地址，二是能从你的电脑发起SSH连接并成功认证。IP负责把数据包送到门牌号对应的那块板子，SSH负责让门后面的Shell愿意接待你。任何一步做得不踏实，后面所有远程操作都无从谈起。

1.2 开始之前：你需要确认已经完成的环境准备

写这篇内容默认一个前提：你的系统镜像已经烧录进TF卡或者SD卡，并且板子已经正常上电。如果你的板子插了电源但灯不亮，先查电源适配器是不是5V供电充足，很多开发板用手机充电器供电时，电流不够会导致系统反复重启甚至根本起不来。

另外，网线插的是板子的有线网口，另一头要接到你家路由器的LAN口，千万别插到光猫的IPTV口或者墙上的的网络面板——那些口通常不在你的局域网内，后面扫描IP很容易扑空。要是你的板子型号带无线功能，理论上也可以用WiFi连接，但新手阶段我强烈建议先用有线。原因很直接：有线连接时板子会在上电后几秒内拿到IP，整个过程纯粹靠DHCP自动完成，你少调试一个无线网卡驱动的问题。

最后确认一下你电脑上有没有SSH客户端。Windows 10以上的系统自带OpenSSH客户端，直接在PowerShell或者CMD里敲ssh就能用；macOS和主流Linux发行版则都是自带OpenSSH的，不需要额外安装。只有老掉牙的Windows 7才需要去找PuTTY这类第三方工具。

2. 查IP的四种可靠办法：从路由器后台到TTL串口兜底

查IP这件事有个优先级的问题，很多人一上来就喜欢用扫描工具，一梭子nmap扫下去确实能出结果，但扫描之前你得先确认网段、处理软件安装权限，绕了一圈反而耽误时间。我的建议是：按下面的顺序来，能用最简单的方法就不要折腾。

2.1 路由器后台查DHCP租约列表：最省事也最权威

家里的路由器是这个局域网里的"DHCP服务器",所有设备上电后都会向它索要IP地址，路由器自己有个分配记录表。浏览器输入路由器的管理地址（常见的是192.168.1.1或者192.168.31.1，具体看路由器背面标签），登录后找"设备管理""终端列表""DHCP客户端列表"这类入口。不同品牌的路由器叫法不一样，但一定会有一张表，列着当前连接设备的IP、MAC地址和主机名。

在列表里找到主机名类似"orangepi"或者完全陌生的设备，重点核对MAC地址。香橙派板载有线网卡的MAC前缀通常是02:08:be开头，这个规律能帮你把板子从一堆陌生设备里分辨出来。如果列表刷不出来，刷新页面，或者把板子拔电重插一下网线，等一分钟再看。

这个办法最大的好处是信息绝对权威——路由器自己分配的IP，不会跟别的设备冲突，也不会出现"扫描到了但其实是别人家手机"的乌龙。缺点是必须能登录路由器后台，如果你是合租的网络或者公司网络，没有后台权限，那就要用下面的办法。

2.2 局域网扫描工具：nmap、arp-scan和手机App

没有路由器后台权限的局域网，可以用主动扫描的方式把所有在线设备的IP挖出来。最常用的工具是nmap。先在电脑上确定自己的IP和网段：Windows执行ipconfig，macOS/Linux执行ip addr，找到自己网卡的IPv4地址。如果自己的IP是192.168.1.8、掩码是255.255.255.0，那你的局域网就是192.168.1.0/24，扫描命令如下：

# 先做主机发现，只扫在线设备，不扫端口 nmap -sn 192.168.1.0/24

输出里会列出所有在线设备的IP和MAC地址，看到MAC前缀02:08:be或者主机名带orangepi字样的，多半就是板子。如果nmap装起来嫌麻烦，有些系统自带arp-scan，命令更简洁：

sudo arp-scan --local

这条命令直接询问局域网里所有设备的MAC地址和IP对应关系，不需要指定网段，识别效率很高。手机端的话，装一个网络扫描工具，连上同一个WiFi，点一下扫描，界面会直接列出设备清单，连MAC厂商品牌都能显示出来。这个方法适合手边没电脑的时候应急。

2.3 mDNS主机名直连：记不住IP时的捷径

其实你未必需要记住那串数字。香橙派的系统镜像大多数默认安装了Avahi服务，这个服务做的事情是让设备在局域网里广播自己的主机名。只要板子和你的电脑在同一个网段，你可以在电脑上直接解析名字：

ping orangepi.local

如果名字能够解析出来，ping的输出第一行就会显示解析到的IP地址，比如PING orangepi.local (192.168.1.21)，那个192.168.1.21就是板子的IP。macOS和绝大多数Linux发行版原生支持这个解析功能，Windows需要安装Apple的Bonjour服务才能识别.local域名，默认情况下Windows的cmd是ping不通的。

这个办法的实用场景是：你已经登录过板子，但不想每次去路由器后台查IP。板子如果换了个网络环境，名字一般还是能解析，因为mDNS的广播是即时的。不过我要提醒一句：mDNS在复杂网络环境（比如企业网、有多层防火墙的办公网络）里经常失效，它更适合家庭这种扁平局域网。所以它适合做"日常快捷方式"，不适合当"首次查IP的唯一手段"。

2.4 兜底方案：TTL串口登录看IP

万一板子的网线没接好、系统没有成功启用网络服务，甚至你压根进不了路由器后台，这时候唯一还能跟板子对话的方式就是串口调试线。香橙派的板子上几乎都预留了UART调试针脚，一般是四根针：GND、TX、RX和VCC（VCC通常不用接），用USB转TTL模块连接主板和电脑，注意串口的TX要接板子的RX、串口的RX要接板子的TX，GND接GND，接反了数据收不到。

Windows下用PuTTY选择Serial模式，指定USB转TTL模块对应的COM口，波特率设115200；macOS和Linux下用screen命令：

screen /dev/cu.usbserial-xxx 115200

连接后按回车会看到板子的登录提示，账号密码跟系统镜像的默认账号一样。登录进去之后执行ip addr或者ip route，就能看到板子所有网卡当前的IP地址、是否成功通过DHCP获取地址等信息。串口这个方案虽然要多准备一根调试线，但它是纯硬件层面的通道，不依赖网络，系统内核起没起来、网络服务有没有报错，它都能看到，属于排查问题时的最后防线。

3. SSH登录板子：从第一次连接密钥认证

拿到IP之后，接下来的操作就是发起SSH连接。这一步本身不难，但首次登录涉及默认账号、主机指纹确认、密码输入不可见这些细节，不处理清楚会反复卡壳。

3.1 首次连接前要确认的账号和SSH服务状态

系统镜像的默认账号不是统一的。香橙派官方提供的大部分系统镜像，默认用户名是orangepi，密码也是orangepi；也有少数版本是基于纯Debian改的，默认root密码需要在首次启动时设置。所以拿到一张新镜像的时候，第一件事是看镜像下载页面的说明，别想当然地猜账号。

SSH服务方面，多数官方镜像为了照顾玩家直接开箱使用，默认启动了SSH服务器。但也有一部分精简镜像默认不装OpenSSH服务端，连上去会提示拒绝连接。如果之前你已经通过串口登录过系统，可以用下面这条命令检查并启动服务：

sudo systemctl status sshd # 如果服务没运行，执行 sudo systemctl enable --now sshd

Debian系系统里服务名可能是ssh也可能是sshd，以实际为准。刚烧录完镜像第一次开机时，系统还需要几十秒完成初始化、扩展分区、生成SSH密钥等动作，太心急连不上是正常的，等一分钟再试。

3.2 Windows、macOS和Linux下的连接命令

你的电脑上已经自带SSH客户端的情况下，直接打开终端输入命令就行。Windows用户打开PowerShell或者CMD：

ssh orangepi@192.168.1.21

这里orangepi换成你镜像对应的用户名，192.168.1.21换成你查到的板子IP。第一次连接时终端会显示一行警告，提示"无法确认主机真实性，是否继续连接"，这是SSH的指纹确认机制，防止有人冒充目标主机。确认IP没敲错就直接输入yes回车，之后会提示输入密码。

输入密码的时候终端不会显示任何字符，这是安全设计，正常现象，别以为键盘坏了。macOS和Linux用户执行的是同一条命令，只是如果你的网络环境比较复杂，可以加一个超时参数，让自己快速失败、快速定位问题：

ssh -o ConnectTimeout=5 orangepi@192.168.1.21

3.3 配置SSH密钥登录：省掉每次输密码

密码登录虽然能用，但玩开发板的人往往要频繁重装系统、反复连接，每次输密码很烦，而且密码在网络上传输虽然加密，但验证环节容易被暴力猜解。更舒服的方式是配置密钥认证。先在电脑上生成一对密钥：

ssh-keygen -t ed25519

生成的公钥在~/.ssh/id_ed25519.pub。然后把公钥复制到板子上：

ssh-copy-id -i ~/.ssh/id_ed25519.pub orangepi@192.168.1.21

ssh-copy-id会自动处理权限，把公钥追加到板子上~/.ssh/authorized_keys文件末尾。如果用的是Windows没有这个工具，就用scp手动传：

scp ~/.ssh/id_ed25519.pub orangepi@192.168.1.21:/home/orangepi/ # 登录板子后执行 mkdir -p ~/.ssh && chmod 700 ~/.ssh cat id_ed25519.pub >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys

密钥文件权限不对是SSH认证失败的高频原因：~/.ssh目录必须是700，authorized_keys文件必须是600，稍微宽松一点服务端就会拒绝使用这个密钥。配好之后再ssh orangepi@192.168.1.21，直接进系统，不需要输密码。

4. 连不上时的完整排查链路：从物理层到应用层

SSH连不上是开发板玩家里出现频率最高的问题，而且报错五花八门：有的是ping不通，有的是通了但立刻弹Connection refused，还有的是输对密码也被拒绝。如果直接去搜代码往往一头雾水，我习惯按三层链路排查：物理层、网络层、服务层。每一层都验证通过，再往上一层走。

4.1 第一层：物理连接和电源是不是真的正常

先说最容易忽略的物理层。检查板子上的电源指示灯和网口指示灯：电源灯亮不代表系统正常启动了，如果网口的Link灯不亮或者一直在闪，说明网线物理链路可能没通。换个网口插，换根网线试，高级路由器有的支持PoE供电网口，普通网口并没有供电功能，不要把网线插到写着PoE的口上然后疑惑为什么没反应。

网线要插到路由器的LAN口，这个我在开头已经强调过，但还是值得再提——很多人排查半天，最后发现网线插到了路由器上方的光猫网口。光猫能分配IP的网段和路由器通常不在同一个子网，电脑和板子一个在路由器网段、一个在光猫网段，互相之间根本不可达。还有一个容易忽略的点：家里的WiFi路由器如果开了"AP隔离"或者"访客网络隔离"，那么即使同一台路由器下，不同设备之间也是禁止互访的，板子插了有线、电脑连了WiFi，手机连接的路由器后台可能都查得到，但板子就是ping不通电脑。先在路由器后台把这个选项关掉。

4.2 第二层：网络层是否真的拿到了IP

物理链接没问题之后，验证板子是否真的拿到了IP。最简单的方式是ping：ping 192.168.1.21。如果返回Destination Host Unreachable，说明局域网里根本没有这个IP的设备，或者板子压根没拿到IP。这时候用开头提到的方法重新扫描一遍，重点确认扫描到的MAC是不是板子的。如果扫描结果里没有任何疑似板子的设备，多半是板子系统里网络服务没起来，或者DHCP获取失败。回到串口登录板子，执行ip addr看网卡状态，看有没有报错信息。

还有一种情况是网段不对。你的电脑如果连着公司/学校的有线网络，本身就跟家里的路由器不在一个网段，板子接在你家用路由器上，你在办公室当然连不上。这种跨网段问题不是SSH配置能解决的，要么把板子接到同一个网络里，要么做端口映射（新手完全不建议碰）。

4.3 第三层：SSH服务本身有没有问题

ping通了说明数据链路已经打通，接下来看22端口是否开放。在电脑上执行：

nc -vz 192.168.1.21 22 # 或者用nmap nmap -p22 192.168.1.21

如果端口是closed或者filtered，说明SSH服务没起来或者被防火墙挡住了。登录板子后执行systemctl status sshd，没运行就启动它；有提示重启失败的，检查日志journalctl -u sshd -n 50看具体报错。防火墙方面，板子上如果装过ufw，执行sudo ufw status查看，确保22端口放行。

下面这个表格是我实际排查中总结的高频现象对照表，照着查能省很多时间：

最后这个Host key verification failed也经常遇到：你重刷了系统，电脑上的known_hosts还留着旧板子的指纹，SSH会比较发现不一致，直接拒绝连接。处理办法是在电脑上执行ssh-keygen -R 192.168.1.21把旧记录删掉，重新连接。

5. 登录成功之后，建议立刻做的事

能成功敲入第一个命令只是起点，顺手做几件收尾工作，后面用板子会顺心非常多。这些操作都不复杂，但能解决"第二天IP变了找不到板子""默认密码忘改被局域网扫描工具盯上""每次传文件都要开个新工具"这些真实痛点。

5.1 修改默认密码：这是最基本的习惯

很多新手觉得"反正在家里局域网，无所谓"，但实际情况是：局域网里其他设备、共享的路由器网络、甚至被扫描工具随机探测都可能撞到你的板子。默认账号密码是公开信息，等于把门钥匙挂在门口。登录之后立即执行：

passwd

按提示输入当前密码和新密码，改完后下次SSH登录就要用新密码。如果你已经配好了密钥登录，可以把密码登录直接禁掉，编辑板子上的/etc/ssh/sshd_config，把PasswordAuthentication改成no，然后重启SSH服务。这样除了持有密钥的电脑，其他设备连尝试密码的机会都没有。

5.2 固定IP和WiFi连接：让板子的地址不再飘忽

默认DHCP模式下，板子的IP是动态的，路由器重启或者租约到期后可能变。为了以后每次SSH不用重新查IP，两种办法：一种是直接在路由器后台给板子的MAC地址绑定一个固定IP，这个看路由器界面操作；另一种是在板子系统里配置静态IP，用NetworkManager的话一条命令搞定：

sudo nmcli connection modify "Wired connection 1" \ ipv4.method manual \ ipv4.addresses 192.168.1.200/24 \ ipv4.gateway 192.168.1.1 \ ipv4.dns 192.168.1.1 sudo nmcli connection up "Wired connection 1"

如果你的板子带无线网卡，想让它脱离网线也能连，NetworkManager同样可以处理：

sudo nmcli dev wifi connect "你的WiFi名称" password "你的WiFi密码"

之后用ip addr确认无线网卡拿到了IP。固定IP的地址最好选在DHCP租约段之外的位置，比如DHCP分配范围是192.168.1.100~200，那静态IP就设192.168.1.210这种高一点的位置，避免跟路由器自动分配的IP撞车。

5.3 用SCP往板子传文件：远程操作的完整闭环

远程操作不只是敲命令，文件拷贝是另一大刚需。SCP依赖SSH通道，不需要额外配置就能用：

# 从电脑传文件到板子 scp 本地文件路径 orangepi@192.168.1.200:/home/orangepi/ # 从板子拉文件到电脑 scp orangepi@192.168.1.200:/home/orangepi/目标文件 本地路径

文件量大推荐用rsync，支持断点续传和增量同步，比如把本地一个项目目录同步到板子：

rsync -avz --progress ./项目目录/ orangepi@192.168.1.200:/home/orangepi/项目目录/

到了这一步，"查IP、SSH登录、传文件、跑程序"这个闭环就完整了。你面对的不再是一块需要搬显示器才能操作的裸板，而是一台可以随时随地远程进Shell、部署脚本、跑服务的开发机器。

最后说个个人体会：查IP和SSH登录这套动作，熟练之后一分钟内就能完成，但第一次卡住的人特别多，根源往往是把问题当成"我不会用SSH"，实际上卡在"根本不知道IP"这一环。所以我的习惯一直是——板子第一次上电前就顺手打开路由器后台，或者手机装一个扫描工具，IP一旦确定就记进备注；要是长期用同一块板子，直接在路由器里给它做静态绑定。前面花十分钟，后面省出来的时间绝对不止十分钟。祝各位顺利连上自己的板子。