【教程】编译固件如何加入自定义配置

不望月的狼人

前几天在论坛看到有人问编译固件如何加入自己的自定义的配置，今日闲暇有空就分享一下自己的做法，仅供参考。

第一步：新建一个文件夹：default-settings 。你也可以叫其他名称，但是文件夹名称不能有中文。
第二步：在上述文件夹中新建文件 Makefile 和一个文件夹 files
第三步：在 files 文件夹中新建文件 99-default-settings，同时设置该文件的权限为可执行，比如755；


现在完整的目录结构是这样：

1. default-settings
   
2. |-- Makefile
   
3. |-- files
   
4. |    |   `-- 99-default-settings

复制代码

第四步：修改Makefile文件内容为：

1. include $(TOPDIR)/rules.mk
   
2. 
   
3. PKG_NAME:=default-settings              #定义包名
   
4. PKG_VERSION:=1
   
5. PKG_RELEASE:=1
   
6. PKG_LICENSE:=GPLv3
   
7. PKG_LICENSE_FILES:=LICENSE
   
8. 
   
9. include $(INCLUDE_DIR)/package.mk
   
10. 
    
11. define Package/default-settings         #设置包信息和依赖
    
12.   SECTION:=luci
    
13.   CATEGORY:=LuCI
    
14.   TITLE:=LuCI support for Default Settings
    
15.   PKGARCH:=all
    
16.   DEPENDS:=+luci-base +luci
    
17. endef
    
18. 
    
19. define Package/default-settings/description
    
20.         LuCI support for Default Settings.
    
21. endef
    
22. 
    
23. define Build/Compile
    
24. endef
    
25. 
    
26. define Package/default-settings/install     #把文件 99-default-settings 写入 /etc/uci-defaults/ 目录下，如果是其他文件的话也可以用这种方法把特定文件写入固件中，比如证书
    
27.         $(INSTALL_DIR) $(1)/etc/uci-defaults
    
28.         $(INSTALL_BIN) ./files/99-default-settings $(1)/etc/uci-defaults/99-default-settings
    
29. endef
    
30. 
    
31. $(eval $(call BuildPackage,default-settings))

复制代码

第五步：下面就是修改 99-default-settings 了，主要就是自定义的配置，参考内容如下：

1. #!/bin/sh
   
2. 
   
3. #可以直接通过uci的接口修改配置
   
4. #比如配置系统时区
   
5. uci set system.@system[0].timezone=CST-8
   
6. uci set system.@system[0].zonename=Asia/Shanghai
   
7. uci commit system
   
8. 
   
9. # 比如配置无线相关
   
10. uci set wireless.radio0.cell_density='0'
    
11. uci set wireless.default_radio0.ssid='ax1800'
    
12. uci set wireless.default_radio0.encryption='psk2'
    
13. uci set wireless.default_radio0.key='12345678'
    
14. uci set wireless.radio1.cell_density='0'
    
15. uci set wireless.default_radio1.ssid='ax1800'
    
16. uci set wireless.default_radio1.encryption='psk2'
    
17. uci set wireless.default_radio1.key='12345678'
    
18. uci commit wireless
    
19. 
    
20. 
    
21. #比如配置lan口和wan口
    
22. uci set network.lan.ipaddr="192.168.0.1"
    
23. uci set network.wan.proto="pppoe"
    
24. uci set network.wan.username="账号"
    
25. uci set network.wan.password="密码"
    
26. uci commit network
    
27. 
    
28. 
    
29. #比如配置 uhttpd
    
30. uci del uhttpd.main.listen_http
    
31. uci del uhttpd.main.listen_https
    
32. uci add_list uhttpd.main.listen_http=[::]:1089
    
33. uci add_list uhttpd.main.listen_http=0.0.0.0:1089
    
34. uci add_list uhttpd.main.listen_https=[::]:1443
    
35. uci add_list uhttpd.main.listen_https=0.0.0.0:1443
    
36. uci set uhttpd.main.rfc1918_filter=0
    
37. uci set uhttpd.main.cert=/etc/ssl/certs/certificate.cer
    
38. uci set uhttpd.main.key=/etc/ssl/certs/private.key
    
39. uci set uhttpd.main.redirect_https=1
    
40. uci commit uhttpd
    
41. 
    
42. 
    
43. #也可以通过直接修改配置文件的方式来修改配置
    
44. #比如修改root默认密码和设置证书登陆的公钥
    
45. sed -i '/root/d' /etc/shadow
    
46. sed -i '1i\root:$1$G.elgsxV$IBS8iGDyioldPta4rAH0h0:19065:0:99999:7:::' /etc/shadow
    
47. echo 'ssh-rsa 共钥' > /etc/dropbear/authorized_keys
    
48. 
    
49. ####################
    
50. 
    
51. #### 大量其他配置 ####
    
52. 
    
53. ####################
    
54. 
    
55. #结束一定要返回 0 只有返回0后，该文件在首次执行后才会被删除
    
56. #详见： https://openwrt.org/docs/guide-developer/uci-defaults
    
57. exit 0

复制代码

第六步：上述工作全部做完后就可以把 default-settings 文件夹放到openwrt源码目录中的 package 文件夹下，然后 make menuconfig 时选中 default-settings ，这样编译出来的固件就带有自定义的配置了，非常方便，enjoy it；

宁谢：上述Makefile部分内容借鉴了lean仓库的内容

smith97

这个教程可太行了！

不望月的狼人

smith97 发表于 2022-4-10 10:50
这个教程可太行了！

感谢支持！

giano

这个很实用，感谢分享！

萝卜大侠

支持一下

jzz15

你知道如何加入自定义的VID PID吗？谢谢

不望月的狼人

jzz15 发表于 2022-7-18 13:05
你知道如何加入自定义的VID PID吗？谢谢

这个自定义 VID PID是写的哪个文件呢？

jzz15

不望月的狼人 发表于 2022-7-18 13:37
这个自定义 VID PID是写的哪个文件呢？

就是option.c，加入更多的模组VID和PID，但是我看官方都是用过patch文件加的，我不清楚我自己要加怎么加

不望月的狼人

jzz15 发表于 2022-7-18 13:59
就是option.c，加入更多的模组VID和PID，但是我看官方都是用过patch文件加的，我不清楚我自己要加怎么加 ...

这个帖子只是教大家如何自定义的openwrt配置的，感觉你说的需要给源码打patch，不一样的！

jzz15

不望月的狼人 发表于 2022-7-18 15:50
这个帖子只是教大家如何自定义的openwrt配置的，感觉你说的需要给源码打patch，不一样的！
...

是的，就是要改源码，哎

不望月的狼人

jzz15 发表于 2022-7-18 16:19
是的，就是要改源码，哎

下载源码自己修改生成patch不就好了么

jzz15

不望月的狼人 发表于 2022-7-18 16:24
下载源码自己修改生成patch不就好了么

我在WSL里编译固件总是EXIT 1，也没错误提示

不望月的狼人

jzz15 发表于 2022-7-18 16:26
我在WSL里编译固件总是EXIT 1，也没错误提示

提供截图呢，让 @萝卜大侠 帮你看看！

H3MKL

感谢分享。

WittyHare

可不可以先设置好，然后把设置导出来，编译时加进去？

不望月的狼人

WittyHare 发表于 2022-11-12 15:22
可不可以先设置好，然后把设置导出来，编译时加进去？

当然可以

WittyHare

不望月的狼人 发表于 2022-11-12 19:15
当然可以

谢谢，慢慢折腾。一时半会还搞不会。

lszjyj

谢谢分享！

nihaolai

好好好好好好好好好好好好好好好好好顶

特异个体

这个方法可行，补充一下，这个实现的本质是root下面etc/uci-defaults文件夹下的文件会在初次启动时被识别为sh脚本，并按照文件名排序进行依次执行，执行后删除。
因此，99开头的文件名很重要，而99-后面的default-settings不重要。实际上，可以在这个文件夹里添加多个脚本按顺序执行都可以。
源码中，文件放置在openwrt/package/base-files/files/etc/uci-defaults文件夹下即可，makefile的部分和menuconfig的部分可以省略。