基于 coolsnowwolf/lede 的 OpenWRT 多 target 编译项目，支持 Rockchip（H28K）和 x86_64（PVE）设备。
| 分支 | 用途 |
|---|---|
main |
编译脚本、配置、补丁 |
.
├── configs/
│ ├── feeds.conf # 通用 feeds 配置（两个防火墙世代共用）
│ ├── fw3.config # fw3（iptables）世代叠加，有意留空
│ ├── fw4.config # fw4（nftables）世代叠加
│ ├── rockchip.config # Rockchip 编译配置（fw 世代中立）
│ └── x86.config # x86_64 编译配置（fw 世代中立）
├── patches/
│ ├── common/ # 所有 target 通用
│ ├── base-files/ # 默认 IP 等基础配置（可被 target 专属 patch 覆盖）
│ ├── rockchip/ # Rockchip 专属
│ └── x86/ # x86_64 专属
├── scripts/
│ ├── lib.sh # 公共函数库
│ ├── build-rockchip.sh # Rockchip 编译脚本
│ └── build-x86.sh # x86_64 编译脚本
└── .github/
└── workflows/
├── rockchip.yaml # Rockchip 每周自动构建（fw3 + fw4 matrix）
└── x86.yaml # x86_64 每周自动构建（fw3 + fw4 matrix）
以下目录由编译机运行时自动创建，不进 git：
lede-src/ # upstream 源码
build/ # 各 target 的 git worktree（含各自的 .ccache）
output/ # 编译产物
shared/ # dl / feeds 共享缓存
注意：ccache 由 OpenWrt 编译系统硬编码在各 worktree 的
.ccache/目录下，不在shared/里共享。
- Ubuntu 22.04 / 24.04
- 磁盘空间 50GB+
安装编译依赖：
sudo apt-get update
sudo apt-get install -y \
ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
bzip2 ccache clang cmake cpio curl device-tree-compiler flex gawk gcc-multilib g++-multilib gettext \
genisoimage git gperf haveged help2man intltool libc6-dev-i386 libelf-dev libfuse-dev libglib2.0-dev \
libgmp3-dev libltdl-dev libmpc-dev libmpfr-dev libncurses5-dev libncursesw5-dev libpython3-dev \
libreadline-dev libssl-dev libtool llvm lrzsz libnsl-dev ninja-build p7zip p7zip-full patch pkgconf \
python3 python3-pyelftools python3-setuptools qemu-utils rsync scons squashfs-tools subversion \
swig texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-devgit clone https://github.com/leochien0102/openwrt-actions
cd openwrt-actions
# 初始化 upstream 源码
git clone --depth=1 https://github.com/coolsnowwolf/lede lede-src
# 创建共享缓存目录
mkdir -p shared/dl shared/feeds每个 target 对应一个独立的 git worktree，首次使用需手动创建：
git -C lede-src worktree add --detach ../build/rockchip origin/master
git -C lede-src worktree add --detach ../build/x86 origin/master创建完成后为各 worktree 建立共享目录的 symlink：
for target in rockchip x86; do
ln -snf ../../shared/dl build/$target/dl
ln -snf ../../shared/feeds build/$target/feeds
done各 worktree 下的
.ccache/由编译系统自动创建，无需手动处理。
worktree 建好后，直接运行对应脚本即可，脚本会自动完成 source 更新、patch、feeds、config 加载和编译：
# Rockchip H28K（不传 -fw 默认 fw4）
bash scripts/build-rockchip.sh # fw4
bash scripts/build-rockchip.sh -fw 3 # fw3（iptables）
# x86_64（同样默认 fw4）
bash scripts/build-x86.sh产物输出目录：
| Target | 固件 | Packages |
|---|---|---|
| rockchip | output/rockchip/firmware/ |
output/rockchip/packages/ |
| x86 | output/x86/firmware/ |
output/x86/packages/ |
仓库提供的 configs/*.config 是 diffconfig 格式的精简配置，make defconfig 会自动补全其余选项为默认值。如需根据自己的需求调整包选择：
# 1. 初始化 worktree 环境（更新源码、打 patch、更新 feeds、加载 config）
bash scripts/init-worktree.sh <target>
# 2. 进入 worktree，打开 menuconfig 调整
cd build/<target>
make menuconfig
# 3. 导出新的 diffconfig，覆盖仓库中的配置文件
cd ../..
./build/<target>/scripts/diffconfig.sh > configs/<target>.config此后每次运行编译脚本都会自动加载更新后的配置，无需重复操作。
每周日 UTC 16:00（北京时间周一 00:00）自动触发，也可在 Actions 页面手动触发——手动触发可通过 fw 输入只编一个世代（all / 3 / 4，默认两个都编）。
每个 workflow 用 matrix 同时编译 fw3（iptables）与 fw4（nftables）两个世代，fail-fast: false，一条腿失败不连累另一条。两代由同一份源码构建：luci-app-ssr-plus 的 Makefile 按 PACKAGE_firewall4 自动选择透明代理后端，ssr-rules 运行时再探测 USE_TABLES；世代差异只在 configs/fw3.config（有意留空）与 configs/fw4.config。
| Workflow | Target | Release tag |
|---|---|---|
| rockchip.yaml | H28K | rockchip-YYYYMMDD |
| x86.yaml | x86_64 | x86-YYYYMMDD |
release 用 if: !cancelled() 把编成的世代都发出去：一次 release 收齐当次所有固件，世代写在文件名里（<ts>-fw<N>-<原名>），表格按实际产物生成、失败的腿标 ❌。各保留最近 4 次 Release。