树莓派+测试脚本=完美自启，实际效果分享-育师

树莓派+测试脚本=完美自启，实际效果分享

1. 引言：为什么我们需要开机自启动？

你有没有遇到过这样的情况：每次给树莓派断电重启后，都得手动运行一堆脚本？比如启动一个监控程序、开启语音播报、或者拉起一个Web服务。重复操作不仅麻烦，还容易遗漏。

其实，Linux系统早就为我们准备了“自启动”这个功能。只要设置一次，以后每次开机它都会自动执行指定任务——就像手机的闹钟，设定好时间，每天准时响铃，根本不用你操心。

本文要分享的就是：如何在树莓派上配置开机自启动脚本，并结合真实测试镜像进行验证。我会用最直白的方式讲清楚原理、步骤和避坑点，哪怕你是第一次接触Linux也能轻松搞定。

我们使用的环境是：

设备：树莓派（Raspberry Pi）
镜像名称：测试开机启动脚本
实际用途：验证脚本是否能在系统启动时正确运行

目标很简单：让一段测试脚本在开机时自动执行，输出日志或完成特定动作，确保整个流程稳定可靠。

2. 开机自启动的三种常见方式

在Linux中，实现开机自启动的方法不止一种。不同的系统版本、初始化机制会影响选择。以下是目前主流的三种方案：

2.1 rc.local 方式：简单直接，适合初学者

/etc/rc.local是一个传统的启动脚本文件，在系统完成基本服务初始化后自动运行。它的优势在于语法简单、逻辑清晰，特别适合只跑一两个命令的小项目。

工作原理：

系统启动完成后，会自动调用/etc/rc.local
该文件中的所有命令将按顺序执行
只需把你要运行的脚本路径写进去即可

注意事项：

必须保证/etc/rc.local文件具有可执行权限
如果执行的是长时间运行的程序（如后台服务），记得加&放入后台，否则系统会卡住无法进入桌面

#!/bin/bash # 示例：在rc.local中添加以下内容 python3 /home/pi/test_startup.py & exit 0

提示：exit 0不要删除，它是告诉系统这个脚本正常结束。

2.2 systemd 服务方式：现代标准，功能强大

systemd 是当前大多数Linux发行版默认的初始化系统。相比rc.local，它更灵活、可控性更强，支持服务状态管理、失败重试、依赖控制等高级功能。

优点：

可以精确控制服务启动时机（例如等网络就绪后再运行）
支持开机自启、手动启停、查看日志
更适合长期运行的服务类应用

缺点：

配置稍复杂，需要编写.service文件
对新手有一定门槛

# 示例：/etc/systemd/system/mystartup.service [Unit] Description=My Startup Script After=network.target [Service] ExecStart=/usr/bin/python3 /home/pi/test_startup.py WorkingDirectory=/home/pi User=pi Restart=always [Install] WantedBy=multi-user.target

启用方式：

sudo systemctl daemon-reload sudo systemctl enable mystartup.service

2.3 init.d 脚本方式：老旧但兼容性强

init.d 是更早一代的启动管理系统，现在已逐渐被 systemd 取代。不过在一些旧系统或特殊场景下仍可能用到。

特点：

手动创建脚本并注册到系统启动项
使用update-rc.d命令管理启动级别
操作繁琐，不推荐新项目使用

由于树莓派主流系统已全面转向 systemd，这里不做重点介绍，仅作了解。

3. 动手实践：在树莓派上部署自启动测试脚本

我们现在进入实操环节。假设你已经刷好了名为“测试开机启动脚本”的镜像，系统可以正常启动，接下来我们要让它自动运行一个测试脚本。

3.1 准备测试脚本

首先，创建一个简单的Python脚本，用于验证是否成功自启。

# 文件路径：/home/pi/test_startup.py import datetime import os # 记录启动时间到日志文件 log_path = "/home/pi/startup.log" with open(log_path, "a") as f: f.write(f"System booted at: {datetime.datetime.now()}\n") f.write("Startup script executed successfully!\n\n")

赋予执行权限：

chmod +x /home/pi/test_startup.py

这个脚本的作用是：每次运行时，在startup.log中追加一条记录，包含时间和成功提示。

3.2 方法一：使用 rc.local 实现自启（推荐新手）

这是最直观的方式，适合快速验证。

步骤如下：

编辑/etc/rc.local文件：
```
sudo nano /etc/rc.local
```
在exit 0之前插入以下命令：
```
python3 /home/pi/test_startup.py >> /home/pi/rc_local.log 2>&1 &
```
解释：
- >> /home/pi/rc_local.log：把输出写入日志
- 2>&1：同时捕获错误信息
- &：放入后台运行，防止阻塞系统启动
保存并退出（Ctrl+X → Y → Enter）
确保rc.local有执行权限：
```
sudo chmod +x /etc/rc.local
```
重启树莓派：
```
sudo reboot
```
重启后检查日志：
```
cat /home/pi/startup.log
```

如果看到类似下面的内容，说明成功了：

System booted at: 2025-04-05 10:23:45.123456 Startup script executed successfully!

3.3 方法二：使用 systemd 创建自定义服务（推荐生产环境）

如果你希望更规范地管理启动任务，建议使用 systemd。

步骤如下：

创建服务文件：

sudo nano /etc/systemd/system/test-startup.service

写入以下内容：

[Unit] Description=Test Startup Script After=network.target [Service] Type=simple ExecStart=/usr/bin/python3 /home/pi/test_startup.py WorkingDirectory=/home/pi User=pi StandardOutput=append:/home/pi/systemd.log StandardError=append:/home/pi/systemd.log Restart=no [Install] WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload sudo systemctl enable test-startup.service

重启系统：
```
sudo reboot
```
查看结果：
```
cat /home/pi/systemd.log
```

你会发现日志里多了一条记录，证明服务已成功运行。

4. 实际效果对比与经验总结

为了验证两种方法的实际表现，我在同一台树莓派上分别测试了rc.local和systemd的行为，并记录了关键指标。

项目	rc.local	systemd
设置难度	☆☆☆（非常简单）	☆☆（中等）
日志管理	需手动重定向	支持自动记录
启动时机	较早，网络可能未就绪	可设置依赖（如 After=network.target）
错误处理	无自动恢复机制	支持 Restart=always
兼容性	所有树莓派系统通用	仅限支持 systemd 的系统
是否推荐用于生产	❌ 不推荐	推荐

我的真实体验：

rc.local 更适合调试阶段：刚拿到设备时，我想快速确认脚本能跑起来，用rc.local几分钟就搞定了。
systemd 更适合长期运行：当我把脚本换成一个需要联网上传数据的任务时，发现rc.local经常因为网络还没准备好而失败。改用systemd并加上After=network.target后，稳定性大幅提升。

5. 常见问题与解决方案

5.1 脚本没执行？检查这些地方！

权限问题
确保脚本本身可执行：
```
chmod +x /home/pi/test_startup.py
```
路径问题
使用绝对路径！不要写python test_startup.py，要写：
```
/usr/bin/python3 /home/pi/test_startup.py
```
环境变量缺失
某些脚本依赖PATH或其他环境变量，可在.service文件中显式声明：
```
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"
```
阻塞系统启动
长时间运行的脚本一定要加&放入后台，否则系统会卡在启动界面。

5.2 如何查看启动过程发生了什么？

有时候脚本看似没运行，其实是出错了。可以通过以下方式排查：

查看rc.local的执行日志：
```
tail /var/log/syslog | grep rc.local
```
查看 systemd 服务状态：
```
systemctl status test-startup.service
```
直接看服务日志（如果用了 Journal）：
```
journalctl -u test-startup.service --since today
```

6. 总结：选择最适合你的方案

通过这次“测试开机启动脚本”镜像的实际部署，我得出几个实用结论：

对于新手或临时测试，优先使用rc.local
它简单、直观、见效快，非常适合快速验证想法。
对于正式项目或需要稳定运行的服务，务必使用systemd
它提供了完整的生命周期管理能力，能有效应对异常情况。
无论哪种方式，都要做好日志记录
没有日志的自动化等于“黑箱”，出了问题无从查起。
注意启动顺序
如果你的脚本依赖网络、USB设备或SD卡挂载，请合理设置启动时机，避免因资源未就绪而导致失败。

获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。

树莓派+测试脚本=完美自启，实际效果分享