5分钟搞定开机自启脚本，Ubuntu部署自动化就这么简单
1. 引言：为什么需要开机自启脚本？
在实际的服务器运维、嵌入式设备部署或本地开发环境中，我们常常希望某些服务或脚本能够在系统启动时自动运行，而无需手动登录执行。例如：
- 自动启动Web服务（如Flask、Node.js应用）
- 启动数据采集程序
- 挂载特定目录或配置网络环境
传统的做法是每次重启后手动执行命令，效率低且容易遗漏。通过配置开机自启脚本，我们可以实现系统的自动化初始化流程，大幅提升部署效率和稳定性。
本文将带你使用最简洁的方式，在Ubuntu系统中快速配置一个开机自动执行的Shell脚本，全程不超过5分钟，适用于Ubuntu 18.04及以上版本（包括使用systemd的新版系统）。
2. 方案选型：rc.local 还是 systemd？
2.1 两种主流方式对比
| 对比维度 | rc.local 方式 | systemd 服务方式 |
|---|---|---|
| 配置复杂度 | 简单，适合初学者 | 稍复杂，需编写服务单元文件 |
| 执行时机 | 多用户模式末尾 | 可精细控制（网络就绪后等） |
| 兼容性 | Ubuntu 16.04~20.04 支持 | 所有现代Linux发行版通用 |
| 日志追踪 | 不易排查错误 | 支持journalctl查看详细日志 |
| 推荐程度 | ⭐⭐☆ | ⭐⭐⭐⭐☆ |
结论：虽然
rc.local方法简单直观，但systemd 是当前推荐的标准方式，具备更好的可控性和可维护性。
但由于部分用户仍习惯使用rc.local，本文将先介绍其配置方法，再重点讲解更优的systemd实现方案。
3. 方法一：使用 rc.local 实现开机启动（兼容旧版本）
3.1 创建自定义启动脚本
首先创建一个用于测试的Shell脚本，路径可自定义，例如：
mkdir -p /home/user/scripts nano /home/user/scripts/auto_run_test.sh写入以下内容：
#!/bin/bash # 输出时间戳到日志文件 echo "Script started at $(date)" > /home/user/scripts/output.txt # 进入目标项目目录 cd /home/user/mywbc_v5_usb/build || exit 1 # 记录进入目录状态 echo "Entered build directory" >> /home/user/scripts/output.txt # 启动模拟程序（示例） ./sim/sim & # 标记完成 echo "Simulation launched" >> /home/user/scripts/output.txt3.2 赋予脚本可执行权限
sudo chmod +x /home/user/scripts/auto_run_test.sh建议使用
+x而非777，避免过度开放权限，符合最小权限原则。
3.3 启用 rc.local（如未启用）
Ubuntu 20.04+ 默认可能未启用rc.local，需手动激活：
- 编辑
/etc/rc.local文件：
sudo nano /etc/rc.local确保内容如下（若不存在则新建）：
#!/bin/sh -e # # rc.local # # This script is executed at the end of each multiuser runlevel. # Make sure that the script will "exit 0" on success or any other # value on error. # Your commands here /home/user/scripts/auto_run_test.sh exit 0- 设置
rc.local可执行：
sudo chmod +x /etc/rc.local- 启用
rc-local服务：
sudo systemctl enable rc-local sudo systemctl start rc-local- 检查状态：
sudo systemctl status rc-local如果看到active (exited)表示已成功加载。
4. 方法二：使用 systemd 服务（推荐方案）
4.1 为什么选择 systemd？
- 更标准的 Linux 初始化系统
- 支持依赖管理（如等待网络就绪）
- 提供日志记录与进程监控
- 支持失败重试、超时控制等高级功能
4.2 创建 systemd 服务单元文件
创建服务配置文件：
sudo nano /etc/systemd/system/auto-startup.service写入以下内容：
[Unit] Description=Auto Run Startup Script After=multi-user.target network-online.target Wants=network-online.target [Service] Type=simple User=user WorkingDirectory=/home/user/mywbc_v5_usb/build ExecStart=/home/user/scripts/auto_run_test.sh Restart=no StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target参数说明：
After=...: 确保在网络就绪后再执行User=user: 替换为实际用户名，避免以 root 身份运行WorkingDirectory: 指定工作目录ExecStart: 脚本完整路径Restart=no: 不自动重启（根据需求可设为on-failure）StandardOutput/Error=journal: 输出日志可通过journalctl查看
4.3 启用并测试服务
- 重新加载 systemd 配置：
sudo systemctl daemon-reexec sudo systemctl daemon-reload- 启用开机自启：
sudo systemctl enable auto-startup.service- 手动启动测试：
sudo systemctl start auto-startup.service- 查看执行结果：
sudo journalctl -u auto-startup.service --since "5 minutes ago"你应该能看到类似输出：
May 10 10:00:01 ubuntu systemd[1]: Started Auto Run Startup Script. May 10 10:00:01 ubuntu auto_run_test.sh[1234]: Script started at Fri May 10 10:00:01 UTC 2025- 重启验证：
sudo reboot重启后检查/home/user/scripts/output.txt是否生成，确认脚本正常执行。
5. 常见问题与避坑指南
5.1 脚本不执行？检查这些点！
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 脚本无输出 | 权限不足或路径错误 | 使用绝对路径，检查chmod +x |
| cd 失败 | 工作目录不存在或拼写错误 | 添加 ` |
| 程序启动后立即退出 | 缺少后台运行符号& | 在长时任务后加& |
| 依赖服务未就绪（如数据库） | 启动过早 | 在[Unit]中添加After=... |
| 日志显示 Permission denied | 用户权限不匹配 | 确保User=字段正确 |
5.2 安全建议
- ❌ 避免使用
chmod 777，应使用chmod +x - ❌ 不要以
root身份运行普通脚本（除非必要） - ✅ 使用
journalctl替代日志文件调试 - ✅ 在脚本开头添加
set -e，出错即终止：
#!/bin/bash set -e # 出错立即退出6. 总结
6.1 核心要点回顾
- rc.local 方式：适用于老版本Ubuntu，操作简单但功能有限，适合快速验证。
- systemd 服务方式：现代Linux标准，支持精细化控制，推荐用于生产环境。
- 权限管理：始终遵循最小权限原则，避免使用
777。 - 日志排查：善用
journalctl -u <service>快速定位问题。 - 路径规范：脚本中尽量使用绝对路径，防止因工作目录不同导致失败。
6.2 最佳实践建议
- 📌优先使用 systemd：它是未来趋势，功能强大且稳定。
- 📌命名清晰：服务名和脚本名保持一致，便于维护。
- 📌日志跟踪：开启
StandardOutput=journal，方便后期调试。 - 📌自动化测试：每次修改后通过
reboot验证是否真正生效。
掌握这两种方法后，你可以在不同场景下灵活选择最适合的开机启动方案，无论是个人项目还是企业级部署，都能轻松应对。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
