树莓派超全系列文档--(14)无需交互使用raspi-config工具其一

发布于:2025-03-31 ⋅ 阅读:(13) ⋅ 点赞:(0)


文章来源: http://raspberry.dns8844.cn/documentation

原文网址

无需交互的 raspi-config

raspi-config 工具还支持非交互式选项和标志,它们完全在命令行上更改选项,而无需视觉组件。Raspberry Pi型号之间的可用选项可能不同。

$ sudo raspi-config nonint <command> <arguments> [optional-argument]

NOTE: 01 的含义因选项而异。在将值传递给选项之前,请始终查阅文档。

System options

Wireless LAN

配置Wi-Fi SSID和密码。

$ sudo raspi-config nonint do_wifi_ssid_passphrase <ssid> <passphrase> [hidden] [plain]

如果需要写入无线网络名称(SSID)和密码。以下标志是可选的:

<hidden> 选项表示SSID的可见性。如果网络广播打开的SSID,则通过 0 或省略该选项。如果您的SSID被隐藏,则通过 1。默认为 0

<plain> 选项表示是否用额外的引号来封装给定的口令。大多数用户可以忽略该选项:作为一个实现细节,raspi-config 可能需要在将口令传递给系统其他部分之前添加引号,<plain> 值为 0 表示已经存在引号。如果值为 1,则表示不存在引号,实施时应根据需要添加引号。默认值为 1。要传递此选项,必须指定 <hidden> 的值。

例如,运行以下命令连接到:

  • 名为 myssid 的非隐藏网络,密码为 mypassphrase:
$ sudo raspi-config nonint do_wifi_ssid_passphrase myssid mypassphrase
  • 名为 myssid 的隐藏网络,密码为 mypassphrase:
$ sudo raspi-config nonint do_wifi_ssid_passphrase myssid mypassphrase 1
  • 名为 myssid 的非隐藏网络,密码为 my passphrase
$ sudo raspi-config nonint do_wifi_ssid_passphrase myssid 'my passphrase'
  • 名为 myssid 的非隐藏网络,并使用口令 mypassphrase,在口令中已额外添加了引号:
$ sudo raspi-config nonint do_wifi_ssid_passphrase myssid '"mypassphrase"' 0 0
Audio

指定音频输出。

$ sudo raspi-config nonint do_audio <N>

在树莓派4B,您可以使用以下选项:

  • 0: bcm2835 headphone jack
  • 1: vc4-hdmi-0
  • 2: vc4-hdmi-1

有关 <N> 可选值的完整列表,请参阅此选项的交互式 raspi-config 版本中使用的数字。

Password

更改您的密码。

有关详细信息,请参阅 xref:configuration.adoc#change-user-password修改用户密码

$ sudo raspi-config nonint do_change_pass

NOTE: 此功能使用全屏交互界面,即使从CLI选项运行也是如此。

Hostname

在网络上设置此Raspberry Pi的可见 xref:remote-access.adoc#resolve-raspberrypi-local-with-mdns[mDNS] 名称。

$ sudo raspi-config nonint do_hostname <hostname>
Boot/Auto login

在启动时选择以下行为:

  • 是否启动到控制台或桌面
  • 开机时树莓派是否自动登录当前用户账户
$ sudo raspi-config nonint do_boot_behaviour <B1/B2/B3/B4>
  • B1: 启动到控制台,需要登录
  • B2: 启动到控制台,自动登录
  • B3: 启动到桌面,需要登录
  • B4: 启动到桌面,自动登录
Network at boot

配置引导继续之前是否需要等待网络连接。

$ sudo raspi-config nonint do_boot_wait <0/1>
  • 0: 启动时不等待网络连接
  • 1: 等待网络连接后启动
Splash screen

启用或禁用启动时显示的启动屏幕。

$ sudo raspi-config nonint do_boot_splash <0/1>
  • 0:启用启动画面
  • 1:禁用闪屏
Power LED

如果您的Raspberry Pi型号支持此功能,可以修改电源LED的行为。

$ sudo raspi-config nonint do_leds <0/1>
  • 0 :磁盘活动的闪存
  • 1 :始终保持电源LED亮着
Browser

更改默认网络浏览器。选择当前未安装的网络浏览器将不起作用。

$ sudo raspi-config nonint do_browser <chromium-browser/firefox>

Display options

Underscan

NOTE: 运行Wayland时不可用。

如果屏幕上显示的初始文本从边缘消失,请启用过扫描以调整边框。在某些显示器上,尤其是显示器上,禁用过扫描将使图片充满整个屏幕并删除黑色边框。

$ sudo raspi-config nonint do_overscan_kms <device> <enabled>

设备:

  • 1: HDMI-1
  • 2: HDMI-2

启用:

  • 0: enable overscan
  • 1: disable overscan
Screen blanking

启用或禁用屏幕消隐。

$ sudo raspi-config nonint do_blanking <0/1>
  • 0 :启用息屏
  • 1 :禁用息屏
VNC resolution

headless 设置中定义用于VNC的视频分辨率。

$ sudo raspi-config nonint do_vnc_resolution <width>x<height>
Composite

启用或禁用复合视频输出。

在树莓派4上:

$ sudo raspi-config nonint do_pi4video <V1/V2/V3>
  • V1 :启用4Kp60 HDMI输出
  • V2 :启用复合视频输出
  • V3 :禁用4Kp60和复合输出

在其他型号上:

$ sudo raspi-config nonint do_composite <0/1>
  • 0 :启用合成视频
  • 1 :禁用合成视频

上一篇 – 树莓派超全系列文档–(13)如何使用raspi-config工具其二
下一篇 – 树莓派超全系列文档–(15)无需交互使用raspi-config工具其二