OpenWrt One – 오픈 하드웨어 라우터

 (openwrt.org)
2P by GN⁺ | ★ favorite | 댓글 1개
  • OpenWrt One은 OpenWrt 생태계에 맞춘 오픈 하드웨어 라우터로, MediaTek Filogic 820 SoC와 WiFi 6, 2.5Gbit WAN을 갖춰 실사용 라우터와 개발·복구 장비 역할을 함께 노림
  • 기본 출고 상태에는 OpenWrt 릴리스 펌웨어와 LuCI GUI가 포함되며, NAND 부팅 후 192.168.1.1에서 웹 UI나 SSH로 바로 접근 가능함
  • 펌웨어 업그레이드는 USB, NAND 복구, NOR 전체 복구로 나뉘며, 부팅 스위치와 버튼 조합에 따라 복구 경로가 달라짐
  • NAND가 망가져도 NOR 복구 모드로 다시 플래시할 수 있고, NOR 자체 복구에는 UART 부팅, TFTP 서버, NOR WP 점퍼 작업이 필요함
  • 내장 USB-C 시리얼 콘솔과 복구용 NOR가 있어 펌웨어 실험 중 부트로더나 NAND가 손상돼도 복원할 수 있는 여지를 남김

하드웨어 구성과 출고 펌웨어

  • OpenWrt One은 MediaTek Filogic 820 SoC 기반 장치임
  • 주요 하드웨어 사양은 다음과 같음
    • WiFi 6
    • 듀얼밴드
    • 3×3/2×2 무선 구성
    • 1× 2.5Gbit WAN
    • 1× 1Gbit LAN
    • 1GB DDR4 RAM
    • 256MiB NAND
    • 복구용 16MiB NOR
    • M.2 SSD
    • USB-C 시리얼 콘솔
    • USB 2.0
  • Power Over Ethernet은 IEEE 802.3af/at 호환 장치가 RJ-45 2.5Gbps WAN 커넥터를 통해 전원을 공급하는 방식으로 동작함
  • 각 장치는 제조 배치 날짜 기준으로 사용 가능한 최신 OpenWrt 릴리스 펌웨어가 플래시된 상태로 출고됨
  • LuCI GUI가 설치되어 있으며, 표준 기본 설정으로 바로 실행 가능한 상태임

첫 부팅과 기본 접속

  • 전원을 넣기 전에 NAND/NOR 스위치가 NAND로 설정되어 있어야 함
  • Ethernet 케이블을 장치의 1G 포트에 연결하고 192.168.1.1을 사용함
  • 장치 전원을 켠 뒤 녹색 LED가 계속 켜지면 부팅이 완료된 상태임
  • 브라우저에서는 192.168.1.1로 LuCI GUI에 접속하고, 터미널에서는 ssh root@192.168.1.1을 사용할 수 있음
  • 출고 기본 상태에서 SNAPSHOT Branch로 업그레이드하면 LuCI GUI는 기본 설치되지 않음
  • 초기 설정은 Quick Start Guide를 따르면 됨

USB 기반 펌웨어 업그레이드

  • USB 업그레이드는 FAT32로 포맷된 USB 드라이브에 openwrt-mediatek-filogic-openwrt_one-squashfs-sysupgrade.itb 파일을 준비하는 방식임
    • SNAPSHOT 또는 Release 저장소의 전체 버전명이 붙은 파일을 해당 이름으로 바꿔 사용함
  • 절차는 전원 제거, USB-A 포트에 USB 삽입, NAND boot switch 선택, 후면 Reset 버튼 유지, 전원 인가, 모든 LED가 꺼지면 버튼 해제, 가운데 LED가 녹색이 될 때까지 대기 순서임
  • 장치는 NAND에서 부팅하고, 부트로더가 NAND의 커널과 루트 파일시스템을 다시 플래시함
  • 일부 USB 드라이브에서는 호환성 문제가 관찰됐으며, FAT32 포맷과 MBR 파티션 테이블 사용을 시도할 수 있음
  • U-Boot에서 Bad device specification usb 0 오류가 발생하면 usb_pgood_delay 값을 늘리는 방식이 도움이 될 수 있음
  • 24.10.0 릴리스 이전 SNAPSHOT이 탑재된 초기 OpenWrt One은 USB 기반 sysupgrade 종료 시 녹색 LED가 켜지지 않는 문제가 있었음

NAND 복구 모드와 설치 이미지

  • initramfs NAND Recovery Mode 업그레이드는 USB 기반 펌웨어 업그레이드와 비슷하지만, 후면 Reset 대신 전면 버튼을 누르며 USB 드라이브 준비가 필요 없음
  • 절차는 전원 제거, NAND boot 선택, 전면 버튼 유지, 전원 인가, 모든 전면 LED가 꺼지면 버튼 해제, 가운데 LED가 녹색이 될 때까지 대기 순서임
  • 장치는 복구용 initramfs 이미지를 부팅하며, 이후 다른 업그레이드 옵션을 사용할 수 있음
  • 설치용으로 factory.ubi, sysupgrade, raw kernel 이미지가 제공됨
  • 복구 목적의 플래싱을 위해 uboot bl31-uboot.fip FIP, factory.bin, preloader.bin도 NAND 및 축소된 복구용 NOR 변형으로 제공됨

NOR 전체 복구로 NAND 재플래시

  • NAND에서 더 이상 부팅되지 않으면 NOR/full recovery mode로 부팅해 NAND를 복구할 수 있음
  • NAND의 TF-A 또는 부트로더가 손상된 경우에도 이 방식을 사용할 수 있음
  • FAT32 USB 드라이브에 NAND preloader와 factory image를 준비한 뒤, 전원 제거, USB 삽입, NOR boot 선택, 전면 버튼 유지, 전원 인가, 전면 LED가 모두 꺼지면 버튼 해제, LED가 녹색이 될 때까지 대기함
  • NOR 복구 시스템은 NAND 메모리 전체를 factory 상태로 다시 플래시함
  • 필요한 파일은 SNAPSHOT 또는 Current Stable Release Download Pages에서 받을 수 있음

NOR 메모리 자체 복구

  • NOR recovery memory도 다시 플래시할 수 있으며, 과정은 두 단계로 나뉨
    • UART boot: mtk_uartboot를 사용해 DDR4 초기화 이미지와 NOR 부트로더 이미지를 UART/시리얼 콘솔 연결로 RAM에 복사하고 RAM에서 부팅함
    • NOR flash: 부트 메뉴 복구 기능으로 TFTP 서버에서 NOR로 이미지를 다시 플래시함
  • 두 번째 단계에는 SPI NOR WP 점퍼가 공장 기본 위치에 있어야 하고, TFTP 서버가 OpenWrt One의 LAN 포트에 연결되어 새 이미지를 제공해야 함
  • mtk_uartboot 바이너리는 mtk_uartboot Releases의 assets에서 운영체제에 맞는 아카이브를 받아 압축을 풀어 사용함
  • macOS에서는 xattr -d com.apple.quarantine mtk_uartboot로 격리 속성을 제거해야 할 수 있음
  • DDR4 초기화 파일과 NOR BL31/uboot 이미지는 SNAPSHOT 또는 Current Stable Release Download Pages의 <release-version>/targets/mediatek/filogic 하위 디렉터리에서 받음
  • TFTP 준비 시 컴퓨터 Ethernet 인터페이스는 다음 수동 설정을 사용함
    • IP: 192.168.11.23
    • Mask: 255.255.255.0
    • Gateway: 192.168.11.11
  • TFTP 서버는 192.168.11.23에서 수신해야 하며, OpenWrt One은 192.168.11.11 IP를 사용함
  • 다운로드한 파일명에는 릴리스 버전이 포함되어 있으므로, 라우터가 요청하는 버전 없는 파일명으로 바꿔야 함
    • 예: openwrt-25.12.2-mediatek-filogic-openwrt_one-nor-bl31-uboot.fip → openwrt-mediatek-filogic-openwrt_one-nor-bl31-uboot.fip

UART 부팅과 TFTP 플래싱 절차

  • mtk_uartboot 명령은 USB-C로 연결된 상태에서 부트 파일을 복사하고, 이후 GNU Screen으로 시리얼 콘솔 연결을 열 수 있음
  • 명령 실행 시 다운로드한 파일 경로와 호스트 시스템의 시리얼 장치 경로를 실제 값으로 바꿔야 함
  • Linux 호스트에서 /dev/ttyS*, /dev/ttyUSB* 같은 시리얼 장치 접근 권한이 필요하면 사용자를 dialout 및 uucp 그룹에 추가하고 다시 로그인해야 함
  • mtk_uartboot가 Handshake...를 표시한 뒤 라우터 전원을 켜면 hw code: 0x7981 로그와 함께 BL2 및 FIP 업로드가 진행됨
  • 업로드가 성공하면 GNU Screen이 시작되고 부트 메뉴가 표시됨
  • NOR 업데이트 전에는 장치를 열어 NOR WP에 점퍼를 장착해야 함
  • 장치 후면 스위치를 NOR 위치로 설정하고 UART 시리얼 포트에 연결한 상태에서 전원을 켬
  • 부트 메뉴가 나타나면 아래 방향키로 부팅 과정을 중단하고 3. Unlock NOR. (Make sure the NOR/WP jumper is populated)를 선택함
  • 이후 TFTP에서 필요한 파일을 요청해 플래시하는 부트 메뉴 항목을 선택함
  • 플래시 후에는 다시 부트 메뉴에서 7. Lock NOR. (Remove jumper afterwards)를 선택함
  • 성공적인 NOR 플래싱은 실제로 플래싱이 일어나지 않는 경우보다 느림
  • 펌웨어를 다시 플래시한 뒤 라우터를 재부팅하고 점퍼를 제거할 수 있음

시리얼 콘솔과 물리 크기

  • OpenWrt One은 전면 패널의 USB-A 호스트 포트 옆에 내장 USB-C 시리얼 콘솔 포트를 갖춤
  • 이 포트는 통합 USB-to-serial 변환기를 사용하며, 일반적으로 PC에서 추가 드라이버 없이 가상 COM 포트로 나타남
  • 콘솔 또는 시리얼 접근은 펌웨어 환경의 유지보수, 복구, 복원 확인에 필요함
  • 장치 크기는 148 x 100.5mm임
  • Banana Pi BPI-R4 케이스 설계와 호환됨

함께 보면 좋은 글 β

GN⁺   [-]
Hacker News 의견들

  • 지금 OpenWRT Two를 개발 중이고, 이 모델은 Wi‑Fi 7을 지원할 예정임
    OpenWRT는 많은 하드웨어에서 돌아가고, 제조사 패치가 끊긴 뒤에도 라우터 수명을 늘리면서 기능을 크게 확장할 수 있는 좋은 방법임
    이제는 OpenWRT를 지원하지 않는 상용 라우터는 사지 않을 생각임

    • 예정 사양은 여기 있고, GL.iNet이 제조한다고 되어 있음: https://openwrt.org/voting/2025-02-12-openwrt-two
      그 외에도 GL.iNet의 이 라우터는 OpenWRT가 미리 설치되어 있고, Wi‑Fi 7과 5개의 2.5G 포트를 지원함: http://www.gl-inet.com/en-gb/products/gl-be9300
    • 적어도 Two는 몇 가지 특징이 있어 보임. 다만 가정용 이더넷 애호가 쪽을 겨냥한 제품 같음
      10개의 SFP 슬롯만 있고 스위칭 없이 전부 라우팅 인터페이스인 제품이 나오면 정말 좋겠음
      MikroTik의 진짜 오픈소스 대안이 될 수 있을 듯함
    • 듀얼 2.5GbE도 들어가면 좋겠음
    • 네트워킹을 깊게 하는 편은 아니고 홈랩 정도만 다루는데, OpenWRT를 익히는 데 시간이 좀 걸렸음
      하지만 가능한 것들을 알고 나니 이제 OpenWRT용이 아닌 라우터는 살 생각이 안 듦
      예를 들어 내 ISP는 PPPoE 연결 옵션이 두 가지인데, 하나는 구식 IPv4 전용이라 IPv6가 없고, 다른 하나는 IPv4가 CGNAT 뒤에 있지만 현대적인 IPv6가 있음
      OpenWRT로는 같은 회선 위에 PPPoE 연결을 두 개 만들 수 있어서 둘의 장점을 모두 가져갈 수 있었음

  • 주제에서 조금 벗어나지만, Wrt라는 이름이 재미있는 건 원래 25년 전 Linksys WRT54G 라우터용 대체 펌웨어에서 나온 이름이라는 점임
    왜인지 이름이 계속 남았는데, 아마 쓰는 사람들이 대부분 긱이고 그게 뭔지 알기 때문일 듯함

    • 프로젝트의 소프트웨어 쪽은 WRT54G 스택의 직접적인 후손이 맞을 가능성이 큼
      Linksys는 GPL로 연결된 펌웨어를 공개하라는 소송을 당했고, 그 덤프를 수정해 WRT54G를 Linksys가 계획했던 것보다 훨씬 강력하게 만들었음
      결과적으로 Linksys도 당시 예상보다 훨씬 오래 하드웨어를 팔 수 있었음
    • 몇 년 전에 2000년대 초반 친구들의 소규모 사업장과 집에서 Tomato를 올려 쓰던 WRT54G 변종 4대쯤을 재활용 처리했음
    • 적어도 한동안은 XBMC와 비슷한 경우였음
    • 아직도 어딘가 상자 안에 WRT54GL이 하나 있음

  • 이게 첫 페이지에 올라온 걸 보니 우연이 신기함
    대부분의 라우터 품질이 못 미더워서 막 OpenWrt One을 받았음
    예전에 라우터로 쓰던 낡은 PC를 되살리고 싶지는 않음. 한동안 그렇게 썼지만 너무 시끄러워서 그만뒀고, 전원공급장치 팬이 곧 날아갈 것 같음
    그래도 큰 안테나가 달린 Qualcomm Wi‑Fi PCI 카드, 아주 싼 PC, 오래된 Ubuntu, 단순한 hostapd 설정 조합이 지금까지 써본 것 중 가장 안정적인 Wi‑Fi 라우터였음
    OpenWrt One이 그보다 더 좋길 바람 :-)

    • 혹시 그렇지 않다면, 듀얼 포트 Intel NIC가 달린 오래된 PC에 OPNSense를 올린 조합이 지금까지 써본 최고의 라우터였음
      지난 5년 동안 VLAN 조정과 6in4 터널 설정 외에는 거의 손댈 일이 없었고, 성능도 정말 안정적이었음
      내 홈 네트워크는 기기 수가 수백 대에 이르고, 아마 대부분의 집보다 더 크고 다양하며 복잡한데도 OPNSense UI에는 1년에 두 번쯤, 보통은 호기심으로만 들어감
      소비자용 제품보다 학습 곡선은 조금 더 가파르지만, OpenWRT를 쓸 수 있는 사람에게는 전혀 무리한 수준이 아님
      문서와 포럼 지원도 지난 25년 동안 본 오픈소스 프로젝트 중 99.9%보다 나았음
    • 최근 집 라우터 3대는 MikroTik, MikroTik, Juniper였음
      Juniper는 아직도 스위치로 쓰고 있음. 오래된 Juniper SRX는 uPNP는 별로지만, 다시 라우터로 돌리고 싶다면 그 외에는 여전히 훌륭함
      중간급 MikroTik은 전원 서지를 맞고 포트 절반을 잃었지만, 교체품을 구할 때까지 필요한 만큼은 라우팅해 줬음
      최신 MikroTik도 잘 동작 중임
      솔직히 OpenWrt One이 내게 뭘 제공하는지는 잘 모르겠음
    • 10년 전의 엔터프라이즈급 Wi‑Fi 라우터는 eBay에서 가격이 5분의 1 정도이고, 대부분의 가정이나 소규모 사업장 용도에는 똑같이 잘 동작함

  • 원하는 오픈 하드웨어에 OPNSense를 올리고, 복잡한 무선 쪽은 별도 AP로 넘기는 건 어떨까 싶음
    OpenWRT는 아주 좋지만 설치와 업그레이드가 쉽지는 않음. 하드웨어별 이미지, 설치 옵션, 도구가 너무 많음
    작은 기기에서 돌아가야 하니 제약도 있고, 위키 문서도 흩어져 있어서 개선될 여지가 큼
    내 라우터에 맞는 커스텀 패키지 설치 방법을 찾느라 포럼을 몇 주 뒤져야 했음
    지금도 LUCI로 최신 버전 업그레이드를 시도 중인데 멈춰 있음. 아마 몇 주 기다렸다가 CLI로 진행하고, 다시 포럼을 뒤져야 할 것 같음
    조금 더 비싼 x86 미니 PC와 AP를 쓰지 않는 대가로 꽤 큰 시간을 지불하고 있다는 생각이 들었음

    • OpenWrt 생태계에 대한 지식이 좀 오래된 것 같음. Attended Sysupgrade가 나온 뒤로 업그레이드는 해결된 문제임: https://openwrt.org/docs/guide-user/installation/attended.sy...
      OpenWrt 25.12부터는 적합한 기본 이미지 구성에 모두 포함되어 있음
      나는 x86 기반 라우터, AP, 관리형 스위치까지 전부 OpenWrt로 돌리고 있고 후회 없음
    • 이미지 빌더를 써서 설정을 이미지에 구워 넣는 게 해결책임
    • 요즘 업그레이드는 owut upgrade로 함. 꽤 간단함
    • 가능은 하지만, 직접 만지작거리고 싶다면 OPNSense보다 Debian 같은 일반 Linux 배포판이 더 낫다고 봄
      라우터로 만드는 건 말 그대로 커널 매개변수 몇 개와 NAT용 iptables 규칙 몇 개면 됨. 요즘은 Claude로 5분도 안 걸리는 작업임
      이렇게 하면 BSD 시스템보다 성능과 하드웨어 호환성이 훨씬 좋고, 자원 사용량과 공격 표면도 줄어듦. GUI나 불필요한 구성요소도 없음
      BSD의 Wi‑Fi 지원은 좋지 않지만, Linux에서는 hostapd로 거의 바로 AP를 만들 수 있음
      같은 하드웨어에서 다른 서비스도 돌릴 계획이라면 당연히 Linux가 더 나음
    • 이 장치가 하드웨어나 소프트웨어 측면에서 가장 뛰어난 것도 아니고, 일반 사용자에게 가장 친절한 것도 아니라는 점이 흥미로움
      충성 사용자 말고는 어떤 세그먼트를 노리는지 분류하기 어렵지만, 가격 대비 좋은 하드웨어와 소프트웨어라는 쪽일지도 모르겠음

  • 메인 라우터로 OpenWrt One을 쓰고 있고 아주 만족함
    하나가 죽었을 때 바로 바꿀 수 있게 두 대를 갖고 있음
    완전히 지원되는 하드웨어라 이미지와 패키지가 잘 갖춰져 있고, OpenWrt를 돌리기에 가장 좋은 장치임
    라우팅 속도, 버퍼, 지연시간이 좋고 모든 게 그냥 잘 동작하며 가격도 매우 합리적임
    AP로는 쓰지 않는데, 이미 OpenWrt를 올린 TP-Link 라우터 3대를 더미 AP로 잘 쓰고 있었기 때문임
    다시 구성한다면 OpenWrt One을 살 것 같음
    다만 Deco 메시 키트도 써보니 매우 잘 동작했고, 라우터나 AP에서 임의 패키지를 돌릴 생각이 없는 친구나 가족에게는 이제 그쪽을 추천함

    • OpenWRT One 4대를 쓰고 있는데 좋음
      그냥 좋은 Wi‑Fi 라우터나 AP를 원하고, Wi‑Fi 7이나 10Gbit/s 이더넷처럼 이 제품이 못 하는 기능이 필요 없으며, 지금도 앞으로도 라우터에 최소한의 시간만 쓰고 싶다면 이걸 사면 됨
      이걸 산 뒤로는 다시는 폐쇄형 라우터를 살 이유가 없어 보임
      다른 라우터 설정법을 배우거나 기억할 필요도 없음. 전부 OpenWRT라 항상 같은 모습이고 항상 같은 방식으로 동작함. 새 장치 설정도 최대 2분이면 끝남
      최근 OpenWRT 업데이트로 프로젝트에 가장 부족했던 기능인 장치 UI의 단순한 “최신 펌웨어 다운로드 및 설치” 버튼도 생김
      이제 무인 업그레이드 옵션만 추가되면 초기 설정 후 다시 로그인할 일이 없을 듯함
    • 나도 만족하는 사용자임. 참조 대상이라 OpenWRT의 모든 기능이 별도 손보기 없이 처음부터 동작하는 건 꿈같음
      여기에 오픈소스를 산다는 따뜻한 만족감까지 더해져서, 1Gbps 제한과 오래된 Wi‑Fi가 있어도 내게는 가치가 있음. 나도 별도 AP를 쓰고 있음
      소프트웨어에서 포트를 바꿔 1Gb WAN과 2.5Gb LAN으로 만들었고, 덕분에 LAN 포트로 들어오는 PoE로 라우터 전원도 공급할 수 있음
    • LAN 이더넷 포트가 하나뿐임. Wi‑Fi만 쓰는 건지, 아니면 라우터와 장치들 사이에 스위치를 추가했는지 궁금함

  • 케이스와 안테나 포함 106달러, 제외하면 84달러라니 가격이 괜찮음
    램이 1GB보다 많았으면 좋겠지만, 데이터센터들 때문에 어쩔 수 없나 봄

    • 램 사용량 최적화를 전혀 하지 않아도, 내가 만든 온갖 기능이 들어간 OpenWRT 라우터 프로젝트들은 항상 100MB 미만의 램을 썼음
      요즘은 보통 64MB도 안 씀
      이런 용도에서 1GB는 엄청 많은 램임 :) 더 필요할 거라고 예상하는 이유가 뭔지 궁금함

  • Wi‑Fi 얘기가 나온 김에 https://www.wiisfi.com/를 언급하고 싶음
    지금까지 찾은 것 중 최고의 Wi‑Fi 참고자료임

  • Google Wifi에서 이걸로 바꿨는데 안정성은 비슷하고, 범위와 신호 세기는 더 좋았으며, 원하는 자녀 보호 설정을 적용하기도 더 쉬웠음

    • 기본으로 자녀 보호 기능이 있는지, 아니면 뭔가를 추가로 설치해야 했는지 궁금함
      야간 시간대에 인터넷 접속을 허용할 장치를 화이트리스트로 지정할 수 있으면 정말 좋겠음

  • AliExpress N100 라우터에 OPNSense를 올려 쓰고 있음. 아주 잘 동작하고 만족함
    하지만 업그레이드는 정말 무서움. 딱 한 번 업그레이드가 잘못된 적이 있었음
    ZFS 스냅샷도 다 갖춰놨지만, 헤드리스 장치라 시스템이 다시 올라왔다는 삐 소리를 기다릴 때마다 업그레이드가 너무 불안함

    • 얼마에 샀는지 궁금함

  • 최근 SPR[1]을 시험해 보고 있음. Wi‑Fi 라우터용 보안 중심 배포판임
    이 팀은 Wi‑Fi 보안에 진지하고, Apple 네트워크 스택 같은 곳의 여러 CVE로 인정받은 연구소[2]도 운영함
    핵심 기능은 반신뢰 상태의 게스트와 홈 자동화 기기를 강하게 격리하는 것이고, 소프트웨어 스택은 컨테이너화되고 감사를 거친 Go 데몬을 중심으로 구성되어 있음
    단기 임대 숙소에서 인프라 네트워크를 다른 세대와 공유해야 했을 때, Raspberry Pi와 Netgear A7500 USB 동글로 급조한 여행용 라우터로 꽤 잘 동작했음
    최근에는 주 홈 Wi‑Fi로 쓰기 위해 Wi‑Fi 7과 2.5GbE PoE를 지원하는 CM5 기반 모델도 시험 중임
    1: https://www.supernetworks.org
    2: https://www.supernetworks.org/security-labs.html

답변달기