내 라우터에 맞는 OpenWrt 펌웨어가 필요해도 처음부터 로컬 빌드 환경을 구성할 필요는 없습니다. Wei.G 온라인 커스터마이저에서 소스, 타깃, 패키지와 펌웨어 설정을 고른 뒤 GitHub Actions로 보내면, 나머지는 클라우드에서 빌드할 수 있습니다.

JavaScript HTML CSS Node.js Bash YAML

빠른 시작

⚠️ 펌웨어 플래시는 위험할 수 있습니다. 먼저 라우터 모델, 파티션 구성, 플래시 방법을 확인하세요. 확실하지 않다면 플래시하지 마세요.

배경

  • 【시작하기 쉽게】 직접 펌웨어를 빌드해 보고 싶지만 로컬 툴체인을 준비하는 단계부터 막히고 싶지 않은 사람을 위한 진입점입니다.
  • 【패키지와 의존성】 일부 플러그인이나 의존성은 사용하기 전에 펌웨어에 포함해 빌드해야 합니다.
  • 【설정 부담】 OpenWrt 빌드 옵션은 많고, 중국 본토의 네트워크 환경에서는 의존 파일 다운로드가 특히 번거로울 수 있습니다.
  • 【시간】 전체 빌드는 몇 시간이 걸릴 수 있고 그 뒤에도 실패할 수 있어, 원인을 직접 찾는 데도 시간이 많이 듭니다.
  • 【앞으로의 방향】 누구나 프로젝트를 Fork해 GitHub Pages + Actions로 자기만의 OpenWrt 온라인 빌드 사이트를 운영할 수 있게 하는 것이 장기 목표입니다.
  • 【현재 단계】 아직 테스트 단계라 버그가 남아 있을 수 있습니다. 공유 워크플로를 과도하게 사용하면 GitHub 정책이나 사용량 제한에 걸릴 가능성도 있습니다.

지원 대상

현재는 아래 대상만 확인되었습니다. 다른 기기는 아직 검증되지 않았으며 복구 수단이 없다면 사용하지 마세요.

준비

⚠️ 펌웨어 플래시는 위험할 수 있습니다. 먼저 라우터 모델, 파티션 구성, 플래시 방법을 확인하세요. 확실하지 않다면 플래시하지 마세요.

1. 파라미터 선택

  • 소스를 선택한 뒤 검색창에서 해당 기기 모델이나 환경을 검색합니다. 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, 플러그인, 펌웨어 설정을 확인하세요.

2. 빌드 제출

오른쪽 아래의 클라우드 빌드 제출을 클릭합니다.

요청 다운로드 및 GitHub 열기를 선택하면 브라우저가 JSON 파일을 내려받고 GitHub의 새 Issue 페이지를 자동으로 엽니다.

다운로드한 파일을 Issue 입력창으로 이동한 뒤 Create를 클릭합니다.

봇이 Issue에 이번 빌드의 Actions 링크를 답글로 남깁니다.

3. 펌웨어 다운로드

빌드는 보통 2~4시간이 걸립니다. 완료되면 Actions 페이지 하단의 Artifacts에서 다운로드합니다.

  • FIRMWARE-ALL-XXX: 모든 펌웨어와 체크섬 자료. 처음 플래시할 때는 보통 factory 등의 파일을 찾습니다.
  • CONFIG-XXX: 제출한 설정, 최종 설정, 차이점. 보관을 권장합니다.
  • BUILD-LOGS-XXX: 전체 빌드 로그. 문제 해결에 사용합니다.

자주 묻는 질문

  • 빌드가 실패하면? BUILD-LOGS-…를 다운로드해 마지막 Error를 확인하세요. Issue에서 문제를 보고할 수도 있습니다.
  • 취소하려면? 자신의 빌드 Issue에 /cancel이라고 답글을 남기세요.
  • 동시에 몇 개까지 빌드할 수 있나요? 한 계정에서 동시에 2개의 빌드 작업만 허용되며 그 이상은 대기합니다.
  • 다운로드 버튼이 없는 이유는? GitHub Actions의 Artifacts는 일반적으로 로그인해야 다운로드할 수 있습니다.
  • 공개 저장소 대기 시간이 길다면? 앞으로는 이 프로젝트를 Fork하고 페이지 안내에 따라 자신의 저장소에서 빌드를 실행할 수 있도록 할 예정입니다. 그러면 공유 대기열의 영향을 받지 않습니다.

프로젝트: WeiG-OpenWrt-AutoBuild

감사