香橙派（Orange Pi）入门使用教程：从开箱到跑通第一个项目

1. 引言

香橙派（Orange Pi）是一款性价比极高的单板计算机，它凭借丰富的接口、多样的型号和亲民的价格，成为众多极客、学生和嵌入式开发者的心头好。无论你是想搭建一台家用服务器、学习 Linux 系统，还是玩转 GPIO 控制硬件，香橙派都能满足你的需求。

本教程将从零开始，带你完成香橙派的开箱、系统烧录、首次启动、基础配置，并最终跑通一个 LED 闪烁的实战项目，让你快速上手这块神奇的小板子。

2. 认识香橙派

2.1 常见型号对比

香橙派家族型号众多，常见的有：

Orange Pi Zero 系列：超小体积，适合物联网和轻量任务。
Orange Pi 3 / 3B：性能均衡，适合日常桌面使用和多媒体。
Orange Pi 5 系列：搭载瑞芯微 RK3588S，性能强劲，支持 8K 视频解码，适合 AI 和边缘计算。
Orange Pi Zero 2W：小巧且支持 Wi-Fi，适合嵌入式项目。

选购时，根据你的项目需求（性能、接口、体积、预算）选择合适的型号即可。

2.2 硬件接口速览

以常见的 Orange Pi 3B 为例，主要接口包括：

USB 接口（用于连接键盘、鼠标、U 盘等）
HDMI 接口（连接显示器）
以太网口（有线网络）
MicroSD 卡槽（用于插入系统卡）
40 Pin GPIO 排针（用于连接传感器、LED 等外设）
电源接口（通常为 USB-C 或 Micro-USB）

3. 准备工作

在开始之前，请准备好以下物品：

香橙派主板一块
一张 MicroSD 卡（建议 16GB 及以上，Class 10 或 A1 速度等级）
读卡器（用于将系统写入 SD 卡）
5V 电源适配器（电流建议 2A 及以上，具体参考官方规格）
HDMI 线 + 显示器（或使用串口调试）
USB 键盘和鼠标
一台用于烧录系统的电脑（Windows / Linux / macOS 均可）

4. 系统烧录

4.1 下载系统镜像

访问香橙派官方网站（orangepi.org），在「下载」页面找到你对应型号的系统镜像。官方提供多种系统，如：

Orange Pi OS（官方桌面系统，基于 Linux）
Ubuntu / Debian 服务器版（无桌面，适合服务器用途）
Android（部分型号支持）

建议新手先选择官方推荐的桌面版系统，便于图形化操作。

4.2 烧录工具

推荐使用以下工具将镜像写入 SD 卡：

balenaEtcher（跨平台，界面友好，推荐）
Win32DiskImager（Windows）
dd 命令（Linux / macOS 命令行）

4.3 烧录步骤（以 balenaEtcher 为例）

将 SD 卡插入读卡器，并连接到电脑。
打开 balenaEtcher，点击「Flash from file」选择下载好的系统镜像。
点击「Select target」选择你的 SD 卡（注意别选错磁盘！）。
点击「Flash!」开始烧录，等待完成即可。

烧录完成后，安全弹出 SD 卡，将其插入香橙派的卡槽。

5. 首次启动与基础配置

5.1 连接外设并开机

将 HDMI 线连接显示器、USB 键盘鼠标连接香橙派，插入 SD 卡，最后接上电源。此时香橙派开始启动，显示器上会出现启动画面。

5.2 初始设置

首次进入桌面系统后，通常需要设置：

系统语言和时区
创建用户账户和密码
连接 Wi-Fi 网络（若使用无线）

5.3 更新系统

打开终端（Terminal），执行以下命令更新软件源和系统：

bash 复制代码

sudo apt update
sudo apt upgrade -y

6. 远程连接（SSH）

如果你使用的是无桌面的服务器版系统，或者想从电脑远程操作香橙派，SSH 是最常用的方式。

6.1 开启 SSH

在香橙派终端中执行：

bash 复制代码

sudo systemctl enable ssh
sudo systemctl start ssh

6.2 从电脑连接

在电脑终端（Windows 可用 PowerShell 或 PuTTY）中输入：

bash 复制代码

ssh 用户名@香橙派IP地址

输入密码即可登录。查看香橙派 IP 地址可用：

bash 复制代码

ip addr

或

bash 复制代码

hostname -I

7. 实战项目：点亮 LED

接下来，我们通过 GPIO 控制一个 LED 灯，体验香橙派的硬件控制能力。

7.1 硬件连接

准备一个 LED、一个 220Ω 限流电阻和若干杜邦线。将 LED 正极（长脚）通过电阻连接到香橙派 40 Pin 排针的物理引脚 11（对应 GPIO17），负极连接到 GND（物理引脚 6）。

7.2 安装 Python GPIO 库

在终端中安装 OPi.GPIO 库：

bash 复制代码

sudo apt install python3-pip
sudo pip3 install OPi.GPIO

7.3 编写控制代码

创建文件 led.py：

bash 复制代码

nano led.py

输入以下内容：

python 复制代码

import OPi.GPIO as GPIO
import time

# 使用物理引脚编号
GPIO.setmode(GPIO.BOARD)
LED_PIN = 11

GPIO.setup(LED_PIN, GPIO.OUT)

try:
    while True:
        GPIO.output(LED_PIN, GPIO.HIGH)   # 点亮
        time.sleep(1)
        GPIO.output(LED_PIN, GPIO.LOW)    # 熄灭
        time.sleep(1)
except KeyboardInterrupt:
    pass
finally:
    GPIO.cleanup()

保存后运行：

bash 复制代码

sudo python3 led.py

此时 LED 应开始以 1 秒间隔闪烁。按 Ctrl+C 停止程序。

8. 常见问题与排查

无法开机 / 无显示：检查 SD 卡是否烧录正确、电源是否足够、HDMI 线是否插好。
系统卡顿：确认 SD 卡速度等级，建议使用 A1 及以上；也可考虑使用 eMMC 模块。
SSH 连接不上：确认香橙派与电脑在同一网络，且 SSH 服务已开启。
GPIO 无响应 ：确认引脚编号是否正确，代码是否以 sudo 运行。

9. 总结

通过本教程，你已经完成了香橙派从开箱到跑通第一个硬件项目的全过程。香橙派的世界远不止于此，你还可以尝试搭建 NAS、家庭影音中心、智能家居网关、AI 推理服务器等。