系统配置
raspi-config
raspi-config
可帮助您配置 Raspberry Pi。对 raspi-config
的更改将修改 /boot/firmware/config.txt
和其他配置文件。
开始使用
要从桌面图形用户界面打开配置工具,请转到 Preferences > Raspberry Pi Configuration。
或者,运行以下命令通过终端访问配置工具:
sudo raspi-config
一些高级配置可通过 raspi-config
CLI 进行,但不能通过 Raspberry Pi 配置图形用户界面进行。
从终端浏览配置工具:
- 使用上下箭头键滚动设置列表。
- 使用右箭头或Tab访问
<Select>
或<Finish>
选项。 - 使用左箭头或Tab返回设置列表。
- 键入字母可按字母顺序跳转。例如,键入
E
可跳转到时区列表中的Europe
。

系统选项(System Options)
配置部分启动、登录和联网流程,以及其他系统级更改。
无线局域网(Wireless LAN)
配置 Wi-Fi SSID 和密码。
音 频(Audio)
指定音频输出目标。
密码(Password)
更改你的密码。
更多信息,请参考 更改用户密码
主机名(Hostname)
设置此树莓派在 mDNS 网络上的可见名称。
启动/自动登录(Boot/Auto login)
启动到控制台或桌面,可选择自动登录当前用户账户。
启动时的网络(Network at boot)
等待网络连接后再启动。
闪屏(Splash screen)
启用或禁用启动时显示的闪屏
电源LED(Power LED)
如果您的树莓派型号允许,用此选项更改电源 LED 的行为。
浏览器(Browser)
更改默认网络浏览器
显示选项(Display options)
欠扫描(Underscan)
运行 Wayland 时不可用。
如果屏幕上显示的初始文本从边缘消失,则需要启用过扫描来对准边框。 在某些显示器(尤其是显示器)上,禁用过扫描会使图片充满整个屏幕,并移除黑色边框。
屏幕休眠(Screen blanking)
启用或禁用屏幕休眠(一段时间不活动,屏幕关闭)。
VNC分辨率(VNC resolution)
定义在无显示器设置中使用的视频分辨率。
复合视频(Composite)
启用或禁用复合视频。
4Kp60 HDMI
启用或禁用 HDMI 输出的 4Kp60 分辨率。
接口选项(Interface options)
启用和禁用各种物理接口和虚拟接口。
SSH
启用 或 禁用使用 SSH 对树莓派进行远程终端访问。
SSH 允许您从另一台计算机远程访问 Raspberry Pi 的命令行。SSH 默认为禁用。有关 SSH 的更多信息,请参阅 SSH 文档。
RPi Connect
启用或禁用 Raspberry Pi Connect,它提供了无需手动网络配置即可远程访问 Raspberry Pi 的功能。
VNC
启用 或 禁用 WayVNC 或 RealVNC 虚拟网络计算服务器。
SPI
启用/禁用 SPI 接口和 SPI 内核模块的自动加载。
I2C
启用 或 禁用 I2C 接口和自动加载 I2C 内核模块。
串行端口(Serial port)
启用 或 禁用串行连接上的Shell和Kernel信息。
1-Wire
启用 或 禁用 Dallas 1 线接口。常用于 DS18B20 温度传感器。
远程GPIO(Remote GPIO)
启用 或 禁用 GPIO 引脚的远程访问。
性能选项(Performance options)
超频(Overclock)
如果你的 Raspberry Pi 型号允许,可以对 CPU 进行超频。不同的 Raspberry Pi 设备,甚至同一型号的 Raspberry Pi,其超频潜力也各不相同。超频过高可能导致不稳定。
警告:**超频可能会缩短 Raspberry Pi 的使用寿命。**如果超频到某个级别会导致系统不稳定,请尝试更适度的超频。在启动过程中按住 Shift 键可暂时禁用超频。
GPU内存(GPU memory)
更改 GPU 可用的内存量。
覆盖文件系统(Overlay file system)
启用或禁用只读文件系统。
风扇(Fan)
自定义与 GPIO 连接的 Raspberry Pi 4 机箱风扇的行为。不适用于其他风扇型号。
本地化选项(Localisation options)
配置位置和国家相关选项。
语言(Locale)
选择一个地域,例如 en_GB.UTF-8 UTF-8。
时区(Time zone)
以 地区/城市
格式设置当地时区,例如 欧洲/伦敦
。键入一个字母,在列表中跳转到该字母。
键盘(Keyboard)
打开一个菜单,您可以在其中选择键盘布局。更改通常会立即生效,但可能需要重新启动。键入一个字母可快速跳到列表中的对应字母位置。
无线局域网国家(WLAN country)
设置无线网络的国家代码。
高级选项(Advanced options)
更改高级选项可能会导致 Raspberry Pi 无法正常工作。除非得到 Raspberry Pi 工程师的指导,否则请避免配置高级选项。
扩展文件系统(Expand filesystem)
将操作系统分区扩展到整个存储设备,为文件提供更多空间。重新启动 Raspberry Pi 以完成此操作。通常,Raspberry Pi OS 会在首次启动时执行此操作。如果 你将操作系统克隆到一个容量大于原存储设备的独立存储设备上,这个选项会很有用。
没有确认步骤:选择该选项会立即开始分区扩展。
网络接口名称(Network interface names)
启用或禁用可预测的网络接口名称。
网络代理设置(Network proxy settings)
配置网络的代理设置。
启动顺序(Boot order)
在 Raspberry Pi 4 及更高版本中,指定在未检测到 SD 卡或 SSD 时从 USB 还是网络启动。更多信息,请参阅 引导 加载器配置。
引导加载程序版本(Bootloader version)
在 Raspberry Pi 4 更高版本上,切换到最新的引导 ROM 软件。或者,如果最新版本导致问题,也可以恢复出厂默认设置。
Wayland
在 X11 和 Wayland 后端之间切换,并选择一个窗口管理器。自 Raspberry Pi OS _Bookworm_以来,所有型号的 Raspberry Pi 默认都使用 labwc 窗口管理器运行 Wayland。
要在运行早于 Bookworm 版本的 Raspberry Pi OS 的 Raspberry Pi 4 之前的 Raspberry Pi 型号上使用 Wayland,请在 /boot/firmware/cmdline.txt
中添加 wayland=on
。
音频配置(Audio config)
在 PulseAudio 和 PipeWire 音频后端之间切换。在 Raspberry Pi OS Bookworm 之前,Raspberry Pi OS 使用 PulseAudio。
更新(Update)
将此工具更新至最新版本。
关于raspi-config(About raspi-config)
显示 raspi-config
的描述文本:
完成(Finish)
退出 raspi-config
。如有必要,raspi-config
会在您退出时要求您重新启动。首次执行更改时,请重新启动以确保更改生效。
非交互式 raspi-config
raspi-config
工具还支持非交互式选项和标记,这些选项和标记完全在命令行上更改,没有可视化组件。不同型号的 Raspberry Pi 可能会有不同的可用选项。
sudo raspi-config nonint <command> <arguments> [optional-argument]
0
和 1
的含义因选项而异。在向选项传递值之前,请务必查阅文档。
系统选项
无线局域网
配置 Wi-Fi SSID 和密码。
sudo raspi-config nonint do_wifi_ssid_passphrase <ssid> <passphrase> [hidden] [plain]
如果需要,请输入无线网络名称(SSID)和密码。以下标记为可选标记:
<hidden>
选项表示 SSID 的可见性。如果网络广播的是开放的 SSID,则通过 0
或省略该选项。如果您的 SSID 是隐藏的则设置为 1
。默认为 0
。
<plain>
选项表示要以明文形式传递口令。如果口令包含空格或特殊字符(如 !
),则必须输入 0
,并在口令周围使用引号。否则,可以输入 1
或省略该选项。默认为 1
。 要传递该选项,必须为 <hidden>
指定一个值。
例如,运行以下命令连接一个
- 使用口令
mypassphrase
连接到名为myssid
的非隐藏网络:
sudo raspi-config nonint do_wifi_ssid_passphrase myssid mypassphrase
- 使用密码
mypassphrase
连接到名为myssid
的隐藏网络:
sudo raspi-config nonint do_wifi_ssid_passphrase myssid mypassphrase 1
- 使用密码
my passphrase
连接到名为myssid
的非隐藏网络:
sudo raspi-config nonint do_wifi_ssid_passphrase myssid "my passphrase" 0 0
音频
指定音频输出目的地。
sudo raspi-config nonint do_audio <N>
在 Raspberry Pi 4B,你可以使用以下选项:
0
: bcm2835 耳机1
: vc4-hdmi-02
: vc4-hdmi-1
有关可能的 <N>
值的完整列表,请参阅该选项的交互式 raspi-config
版本中使用的数字。
密码
更改你的密码。
更多信息,请参阅 更改用户密码。
sudo raspi-config nonint do_change_pass
该功能使用全屏互动界面,即使通过 CLI 选项运行也是如此。
主机名
为网络上的 Raspberry Pi 设置可见的 mDNS 名称。
sudo raspi-config nonint do_hostname <hostname>
启动/自动登录
在启动时选择以下行为:
- 是否启动到控制台或桌面
- 开机时树莓派是否自动登录当前用户账户
sudo raspi-config nonint do_boot_behaviour <B1/B2/B3/B4>
B1
: 启动到控制台,需要登录B2
: 引导至控制台,自动登录B3
: 引导至桌面,需要登录B4
: 引导至桌面,自动登录
启动时的网络
等待网络连接后再启动。
sudo raspi-config nonint do_boot_wait <0/1>
0
: 启动时不等待网络连接1
: 等待网络连接后启动
闪屏
启用或禁用启动时显示的闪屏。
sudo raspi-config nonint do_boot_splash <0/1>
0
- 启用闪屏1
- 禁用闪屏
电源LED
如果您的 Raspberry Pi 型号允许,可更改电源 LED 的行为。
sudo raspi-config nonint do_leds <0/1>
0
: 磁盘活动时闪烁1
: 始终保持电源 LED 亮起
浏览器
更改默认网络浏览器。选择当前未安装的网络浏览器将不起作用。
sudo raspi-config nonint do_browser <chromium-browser/firefox>