zhangguanzhang/Actions-OpenWrt

固件说明

支持的设备列表

lede 仓库因为某些原因，会删掉某些 rockchip 设备的支持，这种情况请使用 骷髅头的版本(DHDAXCW) ，op 目前只有官方的 openwrt-21.02 分支看是能用的地步，immortalwrt(天灵) 的编译的话插件很多，最好 action 机器频率要 2700 以上

推荐使用 slim-squashfs 本地源的版本，可以在自行 release 下载，或者点击上面的 设备 栏目下的设备跳转过去：

下载慢可以下面的 gh 代理
# https://github.cooluc.com/

在线升级

在线升级的要求：内存大于等于 1G，容量大于等于 3G，升级步骤为下：

1. tf 卡推荐使用软件 balenaEtcher-Portable ，压缩包里是 img 的话会自动解压刷入，x86_64 在导入成硬盘后，给硬盘扩容，例如添加最少 2G 容量，vmdk 格式必须添加为硬盘之前使用类似 vmware-diskmanager 之类的增加容量
2. 配置好 wan 口（接上级路由做 dhcp 客户端还是 ppoe 拨号都行）或者你的 x86_64 单网口，确保路由器能上网
3. 电脑(不要ttyd上升级) ssh 上去执行 bash -x /update.sh ，如果升级失败，请提 issue 贴日志，arm64 之类的升级死机的话可以试试升级过程物理降温。
4. 默认密码均为 password ，路由器 ip 你可以电脑接它的 lan 后看网关 IP
5. 初次升级的同时会扩容，扩容完只有两个分区，剩余空间所有目录均可享用，升级完后连上去，可以自行安装想要的软件源，例如下面
   1. opkg update
   2. opkg install luci-i18n-dockerman-zh-cn 有 i18n-$pkg_name 的就优先安装它，然后刷新 web 就能看到新服务了
6. 推荐使用 squashfs 格式固件，因为 ext4 格式的断电关机会有几率开机变成根分区只读，我的 r2s 和其他人都遇到过。如果你使用 squashfs 格式出现 I/O Error 请使用 diskgenius 之类扫描看看存在坏道否。
7. 可在线升级和多源码的都是支持切版本，例如当前是 lede-master 的 r2s 想切到 DHDAXCW 的 stable:
   1. SKIP_BACK=1 REPO=DHDAXCW IM_BRANCH=stable bash -x /update.sh
   2. 注意这样切换网卡配置会带过去后，可能web网络那里显示有问题，遇到后可以自行删掉网卡配置 /etc/config/network 重启，然后接 lan 后访问 web 参照 /etc/config/network.bak 配置之前的网络信息重新配置网络

ci 涉及

1. 创建 img 文件，挂载使用 zstd 成目录，整个源码目录都会被 zstd 压缩
2. 然后使用 gh cli 登录和上传 split 文件，后续下载合并后解压再 mount img 成目录，就是缓存了之前的构建结果了
3. fork的话，想用我一样的 cache 和 slim 构建必须阿里云镜像仓库相关token，然后 gh cli 的token设置
4. 貌似一个 target 可以编译出多个，可能后续需要兼容下，例如 r4s 和 r4se

分隔

下面的内容是笔记，没整理，不要照抄执行

构建

机器最好 100G 以上

docker pull openwrtorg/sdk:x86_64-openwrt-21.02


git clone https://github.com/coolsnowwolf/lede.git --depth 1
cd lede

docker run --name openwrt --rm -tid -v $PWD:/home/build/openwrt openwrtorg/sdk:x86_64-openwrt-21.02

docker exec -ti openwrt bash

echo "src-git small https://github.com/kenzok8/small" >> feeds.conf.default
echo "src-git others https://github.com/kenzok8/openwrt-packages" >> feeds.conf.default



./scripts/feeds update -a

./scripts/feeds install -a

rm -rf feeds/small/ipt2socks
rm -rf feeds/small/pdnsd-alt
rm -rf package/lean/kcptun
rm -rf package/lean/trojan
rm -rf feeds/small/v2ray-plugin

make defconfig
./scripts/diffconfig.sh > seed.config

# CONFIG_TARGET_IMAGES_GZIP is not set

CONFIG_TARGET_IMAGES_GZIP=y

CONFIG_TARGET_ROOTFS_PARTSIZE=2048

Target System (x86)  --->   目标系统（x86）
Subtarget (x86_64)  --->   子目标（x86_64）
Target Profile (Generic)  --->目标配置文件（通用）
Target Images  ---> 保存目标镜像的格式
Global build settings  --->      全局构建设置
Advanced configuration options (for developers)  ---- 高级配置选项（适用于开发人员）
Build the OpenWrt Image Builder 构建OpenWrt图像生成器
Build the OpenWrt SDK构建OpenWrt SDK
Package the OpenWrt-based Toolchain打包基于OpenWrt的工具链
Image configuration  ---> 图像配置
Base system  --->     基本系统
Administration  --->     管理
Boot Loaders  --->引导加载程序
Development  --->   开发
Extra packages  --->  额外包
Firmware  --->固件
Fonts  --->字体
Kernel modules  --->  内核模块
Languages  --->语言
Libraries  --->  库
LuCI  --->      LuCI
Mail  --->邮件
Multimedia  --->多媒体
Network  --->网络
Sound  ---> 声音
Utilities  --->实用程序
Xorg  --->Xorg

文件格式区别 1：固件文件名中带有 ext4 字样的文件为搭载 ext4 文件系统固件，ext4 格式的固件更适合熟悉 Linux 系统的用户使用，在 Linux 下可以比较方便地调整 ext4 分区的大小；

2：固件文件名中带有 squashfs 字样的文件为搭载 squashfs 文件系统固件，而 squashfs 格式的固件适用于 “不折腾” 的用户，其优点是可以比较方便地进行系统还原，哪怕你一不小心玩坏固件，只要还能进入控制面板或 SSH，就可以很方便地进行 “系统还原操作”。

3：固件文件名中带有 sysupgrade 字样的文件为升级 OpenWrt 所用的固件，无需解压 gz 文件，可直接在 Luci 面板中升级。

4：rootfs的镜像，不带引导，可自行定义用 grub 或者 syslinux 来引导，存储区为 ext4。（小白不建议）

1：config.buildinfoOpenWrt --------------------------------------------------------------------------------编译配置文件

2：openwrt-rockchip-armv8-friendlyarm_nanopi-r2s-ext4-sysupgrade.img.gz--------------------------Ext4 格式固件

3：openwrt-rockchip-armv8-friendlyarm_nanopi-r2s-rootfs.tar.gz---------------------------------------RootFS 文件

4：openwrt-rockchip-armv8-friendlyarm_nanopi-r2s-squashfs-sysupgrade.img.gz---------------------Squashfs 格式固件

5：openwrt-rockchip-armv8-friendlyarm_nanopi-r2s.manifest------------------------------------------ 固件内已集成软件包列表

6：packages-server.zip-------------------------------------------------------------------------------------IPK 软件包归档

7：sha256sums--------------------------------------------------------------------------------------------------------固件完整性校验文件

8：Source code.zip-----------------------------------------------------------------------------------------源代码.zip

9：Source code(tar.gz)-------------------------------------------------------------------------------------源代码.tar.gz

https://www.right.com.cn/forum/thread-3682029-1-1.html

参考

• https://mlapp.cn/1009.html
• https://www.v2rayssr.com/openwrtimg.html/comment-page-1
• https://mianao.info/2020/05/05/%E7%BC%96%E8%AF%91%E6%9B%B4%E6%96%B0OpenWrt-PassWall%E5%92%8CSSR-plus%E6%8F%92%E4%BB%B6
• 构建一个 op 的包的时候 Makefile 如何编写和讲解
• Makefile 框架分析

缓存和避免包的重复编译

缓存见 cache.sh 。主要是包的重复编译如何避免，先看单个包 ./package/utils/lua 的编译步骤：

1. 在 make 时，make 读取到 package/utils/lua/Makefile 文件内容，包含版本和下载地址。
2. 如果 git 或 svn 源，那么就会在 tmp/dl/ 目录下将源代码 clone 下来。然后，将 clone 下来的源码删除 .git 或 .svn 目录删除，然后压缩成 lua-x.x.x.tar.gz 文件，并复制到 dl/ 目录下。
3. 在编译前段，将 dl/ 目录下的 lua-x.x.x.tar.gz 文件解压到 build_dir/target-<arch>/lua-x.x.x/ 目录下。
4. 进入 build_dir/target-<arch>/lua-x.x.x/ 执行 ./configure，make，make install。
5. make install 会将生成的二进制文件安装到 build_dir/target-<arch>/lua-x.x.x/ipkg-<arch>/ 目录下。
6. 最后将 build_dir/target-<arch>/lua-x.x.x/ipkg-<arch>/ 打包成 lua-x.x.x-1_<arch>.ipk，并复制到 bin/<arch>/packages/base/ 。

可以大概看看 https://github.com/openwrt/openwrt/blob/master/include/package-ipkg.mk ，实际上 build_dir/target-<arch>/lua-x.x.x/ 目录下有一些隐藏文件，.built、.built_check 可能是再次编译的判断文件

一些技巧

dnsmasq 取消 /etc/resolv.conf 里的 nameserver ::1

cat /etc/init.d/dnsmasq 
[ -e /proc/sys/net/ipv6 ] && DNS_SERVERS="$DNS_SERVERS ::1"

/etc/init.d/dnsmasq reload

https://www.youtube.com/watch?v=35ImdukpmyY

https://openwrt.org/zh/docs/guide-user/additional-software/imagebuilder