创建自定义init.d脚本：测试镜像辅助教程
在嵌入式Linux系统或轻量级发行版（如OpenWrt）中，让程序随系统启动自动运行是一项基础但关键的运维能力。很多开发者在调试服务、部署工具或验证系统行为时，需要快速确认某个脚本能否在开机阶段可靠执行。本教程不讲抽象原理，只聚焦一件事：如何为“测试开机启动脚本”这个镜像，亲手写一个可验证、可管理、符合标准的/etc/init.d启动脚本，并完成全流程测试。你不需要提前了解SysV init细节，也不用翻手册查参数——所有操作都基于实际可运行的命令和清晰反馈。
本教程面向刚接触嵌入式Linux启动机制的开发者，尤其适合正在使用该镜像进行功能验证的场景。我们将跳过冗长背景，直接从创建文件开始，每一步都附带说明“为什么这么写”和“不这么做会怎样”，帮你避开常见坑点，比如权限缺失、启动顺序错乱、enable失败却无提示等。
1. 理解目标：这个镜像要测什么
“测试开机启动脚本”镜像的核心目的很明确：提供一个干净、可控的环境，用于验证自定义init.d脚本是否能被系统正确识别、启用并执行。它不是用来跑业务服务的，而是你的“启动行为沙盒”。
这意味着我们关注的不是脚本功能多复杂，而是它的生命周期是否完整可控：
- 脚本能被
ls /etc/init.d/列出； - 执行
/etc/init.d/myscript enable后，能在/etc/rc.d/下生成对应软链接； - 重启后，脚本能按预期执行（比如生成一个标记文件）；
- 手动调用
start/stop/restart命令有合理响应； - 脚本退出状态码正确，不影响其他服务启动。
所以，我们的自定义脚本设计原则是：极简、可观察、无副作用。不依赖网络、不修改系统关键配置、所有输出都落盘可查。
2. 创建标准init.d脚本文件
2.1 选择文件路径与名称
在OpenWrt及多数嵌入式Linux中，自定义init.d脚本必须放在/etc/init.d/目录下，且文件名将作为服务名被系统识别。我们命名为testboot，语义清晰，不易与系统脚本冲突。
vi /etc/init.d/testboot为什么不用
myscript？
参考博文中的myscript是通用示例名。但在真实测试中，用testboot更能体现用途，也避免与他人调试脚本重名导致误操作。命名即文档。
2.2 编写脚本内容（含关键注释）
将以下内容完整写入文件：
#!/bin/sh /etc/rc.common # SPDX-License-Identifier: GPL-2.0-or-later # Copyright (C) 2024 YourName START=99 STOP=10 USE_PROCD=1 start_service() { echo "$(date): testboot started" >> /tmp/testboot.log echo "INITD_TEST_OK" > /tmp/initd_test_flag } stop_service() { echo "$(date): testboot stopped" >> /tmp/testboot.log rm -f /tmp/initd_test_flag } reload_service() { echo "$(date): testboot reloaded" >> /tmp/testboot.log }逐行说明为什么这样写：
#!/bin/sh /etc/rc.common：这是OpenWrt专用的启动脚本框架入口，不是普通shell shebang。它加载了/lib/functions.sh等核心函数库，省去手动实现start/stop逻辑。START=99：数字越大，启动越晚。设为99确保它在绝大多数基础服务（如network、log）之后运行，避免因依赖未就绪而失败。STOP=10：停止顺序与启动相反，数值越小越早停。设为10保证它在关键服务（如syslog）之前停止，防止日志写入失败。USE_PROCD=1：启用procd进程管理器。它能自动监控进程、重启崩溃服务、统一管理PID。即使我们没启动后台进程，开启它也是最佳实践，否则restart命令会报错。start_service()函数：实际执行逻辑。写日志+写标记文件，两步都可立即验证。/tmp/在内存中，速度快且重启后自动清空，符合“测试”定位。stop_service()和reload_service()：提供完整生命周期支持。哪怕当前不调用，留着能让service --help显示全部命令，体现脚本规范性。
2.3 保存并设置执行权限
- 在
vi中：按ESC，输入:wq回车； - 赋予可执行权限（这步绝不能跳过）：
chmod +x /etc/init.d/testboot为什么必须
chmod +x？/etc/init.d/下的文件必须有执行权限，系统才会将其视为有效服务。没有权限时，/etc/init.d/testboot enable会静默失败，不报错也不建链接——这是新手最常踩的坑。
3. 注册并启用脚本
3.1 启用服务（生成启动链接）
执行启用命令：
/etc/init.d/testboot enable成功标志是什么？
运行后无任何输出即为成功（OpenWrt默认静默）。验证方式：ls -l /etc/rc.d/S99testboot应看到类似输出：
lrwxrwxrwx 1 root root 18 Jan 1 00:00 /etc/rc.d/S99testboot -> ../init.d/testboot
这表示已创建软链接，S99表示启动（Start），99对应脚本中START=99。
3.2 验证启用状态
检查服务是否已注册：
/etc/init.d/testboot enabled返回
1表示未启用，0表示已启用。这是Shell中标准的布尔返回值（0为真）。如果返回1，请回头检查权限和文件路径。
4. 手动测试：验证脚本可执行性
在重启前，务必先手动测试。这能快速暴露语法错误、路径问题或权限不足。
4.1 启动服务
/etc/init.d/testboot start预期结果：
- 命令无报错退出；
- 查看日志：
cat /tmp/testboot.log→ 应有时间戳和“started”记录；- 检查标记：
cat /tmp/initd_test_flag→ 应输出INITD_TEST_OK。
4.2 停止服务
/etc/init.d/testboot stop预期结果：
- 日志追加“stopped”记录；
- 标记文件被删除：
ls /tmp/initd_test_flag应提示No such file。
4.3 重启服务（验证procd有效性）
/etc/init.d/testboot restart预期结果：
- 日志中出现“restarted”或连续的“stopped”+“started”；
- 标记文件被重建。
如果报错procd not found或no pidfile，说明USE_PROCD=1未生效或procd未运行（但OpenWrt默认启用，此情况极少）。
5. 模拟真实启动：重启验证
手动测试通过后，进行最终验证：模拟真实开机流程。
5.1 执行重启
reboot注意：此操作会使设备断开SSH连接。等待约30秒后重新连接。
5.2 登录后立即验证
连接成功后，第一时间检查：
# 检查标记文件是否存在（证明启动时执行了） ls /tmp/initd_test_flag # 查看日志最后几行（确认启动时写入） tail -n 5 /tmp/testboot.log # 检查服务状态（procd会记录） /etc/init.d/testboot status成功判定标准（三者必须同时满足）：
/tmp/initd_test_flag文件存在且内容为INITD_TEST_OK；/tmp/testboot.log中有启动时间戳，且时间在本次登录之前；status命令返回running或显示有效PID（如pid 1234）。
如果任一条件不满足，说明脚本未在开机时执行。常见原因：
enable未成功（检查/etc/rc.d/下链接）；START数值过大，导致在系统初始化完成前就被跳过（尝试改为START=50）；- 脚本中有语法错误，
/etc/init.d/testboot start手动执行时已失败但被忽略。
6. 故障排查与实用技巧
6.1 快速诊断：查看系统启动日志
OpenWrt将init.d脚本执行日志写入内核环形缓冲区。重启后立即运行：
dmesg | grep -i "testboot\|init.d"如果看到
testboot: not found或Permission denied，说明文件路径错误或权限缺失；
如果无任何输出，说明脚本根本未被系统扫描到（检查文件名、路径、enable结果）。
6.2 安全调试：避免影响其他服务
测试期间，建议临时降低START值（如START=10），让它尽早运行。这样即使出错，也不会阻塞后续服务。验证无误后再调回99。
6.3 批量清理：重置测试环境
若需多次测试，一键清理残留：
# 停止服务、禁用、删除链接、清除日志和标记 /etc/init.d/testboot stop 2>/dev/null /etc/init.d/testboot disable 2>/dev/null rm -f /etc/rc.d/S99testboot /tmp/testboot.log /tmp/initd_test_flag为什么加
2>/dev/null？
防止服务未启用时disable报错中断脚本，保持清理操作鲁棒性。
7. 总结：你已掌握的核心能力
通过本教程，你已亲手完成一个符合OpenWrt标准的init.d脚本的全生命周期实践：从创建、编写、启用、手动测试到真实重启验证。这不是纸上谈兵，而是可立即复用于任何嵌入式Linux环境的硬技能。
你明确知道：
- 一个最小可行init.d脚本必须包含哪些要素（shebang、START、start_service）；
enable的本质是创建/etc/rc.d/下的软链接，而非修改配置文件；- 手动
start成功 ≠ 开机自动执行成功，必须通过reboot验证； /tmp/是测试黄金路径——快、安全、易清理；dmesg和status是诊断启动问题的第一工具。
下一步，你可以将此脚本模板稍作修改，用于启动你的实际服务（如自定义HTTP服务器、传感器采集程序），只需替换start_service()中的命令即可。真正的自动化，就从这一个可验证的脚本开始。
--- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
