从零到一云编译自己的 OpenWrt 固件
想要一份适合自己的 OpenWrt 固件,不必在本地安装编译环境。打开 Wei.G 在线定制,选择参数后提交到 GitHub Actions,等待云端编译即可。
快速开始
⚠️ 刷机有风险。请先确认路由器型号、分区与刷写方式;不确定时不要刷写。
- 登录 Github
- 打开 Wei.G 在线定制
- 新人请看下方教程👇
背景
- 【起点】 如果你想自己编译固件,体验“手搓固件”的乐趣,这个项目会是一个不错的起点。
- 【依赖】 某些插件或依赖需要编译到固件里才可使用。
- 【配置】 配置过程相当复杂及繁琐,国内网络环境很难满足要求。
- 【耗时】 编译数小时,最终仍可能失败,排查成本也比较高。
- 【未来】 每个人都可一键 folk 复制,即可拥有自己的 Openwrt 在线编译网站 Github(Page + Actions)。
- 【阶段】 项目目前仍处于测试阶段,难免还存在不少 bug,因此暂时不做大规模推广。使用过多,还可能违法 GitHub 政策。
适用
当前仅适用以下机型,其它机型尚未验证,如您没有救砖工具,请勿使用,
- 源: OpenWrt · ImmortalWrt · LEDE · hanwckf
- x86 / 64
- 支持电脑、手机端访问
准备
⚠️ 刷机有风险。请先确认路由器型号、分区与刷写方式;不确定时不要刷写。
- 登录 Github 账号 (如果没有无法构建)
- 打开 Wei.G 在线定制 网站
- Cloudflare dev 页 (实验功能,体验最新功能,可能有bug)
选择参数
选择源后,在搜索框搜索相应机型或环境。也可加载config
Source → Branch → Target System → Subtarget → Target Profile。
- 例 X86/64: ImmortalWrt → openwrt-24.10 → x86 → 64 → Generic x86/64
Advanced menuconfig › LuCI › 3. Applications 勾选你想要的应用
Advanced menuconfig 其它高级设置自己摸索
然后按需;时区、固件主题、NTP 服务器和软件源镜像 一并设置。
已有配置
已有 .config、config.buildinfo 或以前下载的请求文件,可点底部“加载配置”,在确认框核对源码、分支、Target Profile、插件和固件设置。
提交构建
点击右下角 提交云编译
选择 下载请求并打开 GitHub:浏览器会下载一个 JSON 文件,并自动打开 GitHub 的新 Issue 页面。
将文件移动到 Issue 的对话框,直接点击 Create。
机器人会在 Issue 中回复本次构建的 Actions 链接。
下载固件
编译通常需要2~4小时。完成后进入 Actions 页面,在底部 Artifacts 下载:
FIRMWARE-ALL-XXX:全部固件与校验资料;首次刷机通常找factory等文件。CONFIG-XXX:本次提交配置、最终配置和差异,建议留存。BUILD-LOGS-XXX:完整构建日志;用于排查原因。
在自己仓库进行编译
Fork 本项目,按页面提示提交到自己的仓库运行。就不会受到排队限制。
查看详细步骤
图文教程(主要步骤)
- 登录 Github,克隆仓库
- 启用 Issues 和 Actions
- 上传配置
Flok 仓库(克隆仓库)
- 打开 Wei.G 在线定制
- 网页底部 → 【我自己的 flok】 → 输入自己的 【Github 用户名】 → 单击 下方的 【Fork 本项目】
- 然后取消勾选 【☐ Copy the main branch only】,以后如果用开发版 dev,也能正常运行
启用 Issues 和 Actions
- 进入刚刚克隆好的仓库 (例如: Github 用户名/weigefenxiaWeiG-OpenWrt-AutoBuild )
- 点击 Settings→ 勾选 ☑ Issues
- 点击 Actions→ 点击绿色按钮 I understand my workflows, go ahead and enable them
上传配置
- 回到刚刚打开的 Wei.G 在线定制
- 点击 提交云编辑 → 点击 下载请求并打开 Github → 将下载的 json 拖拽到 对话框(只能从刚刚打开的网页提交)
常见问题
- 构建失败怎么办? 下载
BUILD-LOGS-…,查看最后出现的Error;也可在 Issue 反馈。 - 如何取消? 在自己的构建 Issue 回复
/cancel。 - 同时构建数量 一个账号只允许同时2个构建任务,否则得排队。
- 为什么没有下载按钮? GitHub 的 Artifacts 下载通常需要先登录账号。
- 公共仓库排队较久? 未来做到 Fork 本项目,按页面提示提交到自己的仓库运行。就不会受到排队限制。
鸣谢
源码: OpenWrt · ImmortalWrt · LEDE · hanwckf
参考: P3TERX
LuCI 插件的作者们
每一位参与的小伙伴



