从新手到专家:sdm完整使用手册与最佳实践
2026/7/28 8:09:49 网站建设 项目流程

从新手到专家:sdm完整使用手册与最佳实践

【免费下载链接】sdmRaspberry Pi SD Card Image Manager项目地址: https://gitcode.com/gh_mirrors/sdm1/sdm

sdm(Raspberry Pi SSD/SD Card Image Manager)是一款强大的命令行工具,专为树莓派用户打造,能够快速构建一致且即用型的SSD/SD卡镜像。无论你是拥有多台树莓派设备,还是希望每次都能以一致的方式重建系统,sdm都能帮你节省大量时间,让你更专注于树莓派项目的开发与创新。

为什么选择sdm?

使用sdm,你可以轻松实现以下目标:

  • 确保多台树莓派设备从相同的软件包、配置脚本和设置开始运行
  • 快速重建包含个人定制和所有喜爱软件包的系统
  • 避免在新RasPiOS版本发布时重复繁琐的配置工作
  • 安全地为他人制作磁盘或镜像,避免意外分发个人数据

快速入门:sdm安装与基础操作

安装sdm

通过以下命令快速安装sdm:

curl -L https://raw.githubusercontent.com/gitbls/sdm/master/install-sdm | bash

install-sdm脚本会将sdm文件安装到/usr/local/sdm,并自动安装所需的RasPiOS软件包(如binfmt-support、coreutils、gdisk等)。

如果你希望在运行前检查安装脚本,可以使用:

curl -L https://raw.githubusercontent.com/gitbls/sdm/master/install-sdm -o /path/to/install-sdm chmod 755 /path/to/install-sdm # 检查脚本内容 /path/to/install-sdm

获取RasPiOS镜像

首先需要下载所需的RasPiOS压缩镜像并解压。你可以从Raspberry Pi官网下载最新的Trixie或Bookworm镜像:

  • 32位:raspios_armhf或raspios_lite_armhf
  • 64位:raspios_arm64或raspios_lite_arm64

自定义镜像

开始使用sdm自定义镜像的最简单方法是将/usr/local/sdm/ezsdm复制到自己的目录并进行编辑。默认情况下,ezsdm会进行以下设置:

  • 复制本地的键盘映射、区域设置、时区和WiFi国家配置
  • 启用SSH
  • 创建用户myuser并设置密码,同时启用sudo权限
  • 执行apt update和apt upgrade
  • 安装一些示例应用
  • 配置WiFi(SSID: myssid,密码: mywifipassword)
  • 阻止piwiz和cloudinit运行

烧录镜像到SD卡

使用以下命令将自定义后的镜像烧录到SD卡(假设SD卡位于/dev/sdX):

sudo sdm --burn /dev/sdX --hostname mypi1 --expand-root 2025-10-01-raspios-trixie-arm64.img --plugin sshhostkey:generate-keys

--expand-root选项会在烧录完成后自动扩展根文件系统,sshhostkey插件则会重新生成SSH主机密钥,提高系统安全性。

启动与验证

将SD卡插入树莓派并启动,系统会自动完成以下操作:

  1. 扩展根文件系统
  2. 完成系统启动
  3. 运行sdm FirstBoot服务(仅一次)
  4. 自动重启

启动完成后,你的树莓派将配置有:

  • 最新的RasPiOS更新
  • 自定义的用户账户和sudo权限
  • 设置的主机名(如mypi1)
  • 正确配置的键盘映射、区域设置和时区
  • 启用的SSH服务

你可以通过以下命令查看FirstBoot脚本的输出:

journalctl -b -1 | grep FirstBoot

sdm高级功能探索

应用安装与管理

使用apps插件可以轻松安装应用程序,如编辑器(emacs、vim等)和浏览器等。详细信息请参考Docs/Plugins.md。

VNC配置

sdm可以帮助你在系统中安装和配置VNC,支持RealVNC(控制台)、TightVNC或TigerVNC(虚拟桌面)。了解更多请查看Docs/Plugins.md。

网络配置

sdm提供多种网络配置选项:

  • WiFi接入点(热点):支持local、routed或bridged模式
  • USB热点:让树莓派通过USB为其他计算机提供网络连接
  • USB gadget模式:使树莓派通过USB从主机计算机访问网络

树莓派设备启用

通过raspiconfig插件可以轻松启用树莓派特定设备,如摄像头、i2c等。详情请见Docs/Plugins.md。

个人定制

使用copyfile插件或个人插件,可以将个人定制(如.bashrc文件)应用到每个系统。查看Docs/Example-Plugin.md获取示例。

磁盘加密

sdm支持自动磁盘加密功能,通过几个简单的命令即可为根文件系统和/或其他数据分区提供加密保护,增强系统安全性。

已烧录SD卡/SSD的更新

使用--explore命令开关可以nspawn到SD卡或SSD中,进行系统管理活动,如更改账户密码、安装额外软件包等。这对于忘记密码的情况特别有用。

sdm插件系统详解

sdm提供了丰富的插件系统,涵盖了各种功能需求:

  • 系统配置:plugins/system
  • 文件操作:plugins/copyfile、plugins/copydir
  • 网络设置:plugins/network、plugins/wificonfig
  • 安全增强:plugins/sshd、plugins/sshkey
  • 应用安装:plugins/pihole、plugins/docker-install

完整的插件文档请参考Docs/Plugins.md。

sdm最佳实践与技巧

使用ezsdm脚本

ezsdm是一个很好的起点,建议将其复制到个人目录并根据需求进行修改,创建适合自己的定制脚本。

定期更新sdm

保持sdm更新可以获得最新功能和bug修复。关注项目更新并定期运行安装脚本进行更新。

备份自定义配置

定期备份你的ezsdm脚本和个人插件,以防止意外丢失定制配置。

测试新配置

在将新配置应用到生产环境前,建议先在测试SD卡上验证,确保一切正常工作。

利用探索模式

熟悉--explore模式,它可以在不启动树莓派的情况下修改SD卡/SSD,是解决问题和进行系统维护的强大工具。

深入学习sdm

要了解更多关于sdm的详细信息,可以查阅以下资源:

  • Docs/Command-Details.md:命令详细说明
  • Docs/Plugins.md:插件完整文档
  • Docs/Example-Commands.md:官方入门脚本
  • Docs/Programming-Plugins-and-Custom-Phase-Scripts.md:插件编程指南

通过本指南,你已经掌握了sdm的基本使用和高级功能。无论是管理单台树莓派还是构建复杂的树莓派集群,sdm都能成为你不可或缺的工具。开始使用sdm,体验更高效、更一致的树莓派系统管理吧!

【免费下载链接】sdmRaspberry Pi SD Card Image Manager项目地址: https://gitcode.com/gh_mirrors/sdm1/sdm

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询