OpenWrt 완벽 가이드 2026: 구형 라우터를 소프트웨어 라우터로 변신시키는 오픈소스 시스템

# 라우터에 SSH 로그인
ssh root@192.168.1.1

# 전체 펌웨어 백업(TFTP로 로컬 컴퓨터에 전송)
cat /dev/mtd0 > /tmp/original_firmware.bin
# 라우터에서 이 파일을 다운로드

# USB-TTL 모듈 필요(CH340/CP2102, 약 ¥10)
# 연결 후 컴퓨터에서 실행
minicom -D /dev/ttyUSB0 -b 115200

# U-Boot 진입 후 백업 명령 실행

# 1. 먼저 Breed 플래싱(라우터에 SSH가 활성화되어 있거나 TTL을 통해)
# breed 파일은 일반적으로 .bin 포맷

# 2. 라우터 Reset 버튼을 누른 채 전원을 켜면 Breed Web 인터페이스로 진입
# 브라우저에서 192.168.1.1 접속

# 3. Breed 인터페이스에서 OpenWrt 펌웨어 선택 후 플래싱
# Breed는 복구를 지원하므로 잘못 플래싱해도 다시 플래싱 가능

# 1. x86 버전 OpenWrt 이미지 다운로드(combined-ext4.img.gz)
wget https://downloads.openwrt.org/releases/23.05.3/targets/x86/64/openwrt-23.05.3-x86-64-generic-ext4-combined.img.gz

# 2. 압축 해제
gunzip openwrt-23.05.3-x86-64-generic-ext4-combined.img.gz

# 3. USB에 기록(USB가 /dev/sdb라고 가정, 반드시 확인하세요!)
sudo dd if=openwrt-23.05.3-x86-64-generic-ext4-combined.img of=/dev/sdb bs=4M status=progress

# 4. USB에서 소프트웨어 라우터 부팅, OpenWrt가 내장 저장소에 자동 기록

# SSH 로그인(최초 비밀번호 없이 엔터)
ssh root@192.168.1.1

# root 비밀번호 설정
passwd

# 패키지 목록 업데이트
opkg update

# 중국어 언어 팩 설치
opkg install luci-i18n-base-zh-cn

# 웹 인터페이스 새로고침하면 중국어로 변경

# 네트워크 설정 파일 편집
vi /etc/config/network

# 일반적인 LAN 설정 예시:
# config interface 'lan'
#     option type 'bridge'
#     option ifname 'eth0'
#     option proto 'static'
#     option ipaddr '192.168.2.1'
#     option netmask '255.255.255.0'

# 네트워크 서비스 재시작
/etc/init.d/network restart

# DHCP 설정 편집
vi /etc/config/dhcp

# 주요 설정 항목:
# config dhcp 'lan'
#     option interface 'lan'
#     option start '100'          # 시작 주소
#     option limit '150'          # 주소 풀 크기
#     option leasetime '12h'      # 임대 기간
#     option ra 'server'          # IPv6 RA 모드
#     option dhcpv6 'server'      # IPv6 DHCP

# DHCP 서비스 재시작
/etc/init.d/dnsmasq restart

# /etc/config/dhcp에 추가:
# config host
#     option name 'nas'
#     option mac 'AA:BB:CC:DD:EE:FF'
#     option ip '192.168.2.100'

# LuCI 웹 인터페이스: 네트워크 → 방화벽 → 포트 포워딩

# 또는 명령줄:
uci add firewall rule
uci set firewall.@rule[-1].name='Allow-NAS'
uci set firewall.@rule[-1].src='wan'
uci set firewall.@rule[-1].dest_port='8080'
uci set firewall.@rule[-1].target='ACCEPT'
uci set firewall.@rule[-1].proto='tcp'
uci commit firewall
/etc/init.d/firewall restart

# SmartDNS 설치
opkg install smartdns

# SmartDNS가 여러 DNS 업스트림 서버를 사용하도록 설정
vi /etc/smartdns/smartdns.conf

# 업스트림 DNS 추가:
# server 223.5.5.5 -group alidns
# server 119.29.29.29 -group dnspod
# server 8.8.8.8 -group google

# 리스닝 포트 설정
# bind :6053

# DNS 캐시 설정
# cache-size 512

# 서비스 재시작
/etc/init.d/smartdns enable
/etc/init.d/smartdns restart

# opkg로 설치
opkg install adguardhome

# 또는 최신 버전 수동 설치:
wget https://github.com/AdguardTeam/AdGuardHome/releases/latest/download/AdGuardHome_linux_armv7.tar.gz
tar -xzf AdGuardHome_linux_armv7.tar.gz
./AdGuardHome -s install

# 브라우저에서 http://192.168.2.1:3000 접속하여 초기화 완료

opkg install adbyby
/etc/init.d/adbyby enable
/etc/init.d/adbyby start

# WireGuard 설치
opkg install wireguard-tools luci-app-wireguard

# WAN 인터페이스에서 WireGuard 설정 생성
wg genkey > /etc/wireguard/server_private.key
wg pubkey < /etc/wireguard/server_private.key > /etc/wireguard/server_public.key

# 설정 편집
vi /etc/wireguard/wg0.conf

[Interface]
PrivateKey = <서버 개인키>
Address = 10.8.0.1/24
ListenPort = 51820

# 클라이언트 1
[Peer]
PublicKey = <클라이언트 공개키>
AllowedIPs = 10.8.0.2/32

# WireGuard 시작
wg-quick up wg0

# 부팅 시 자동 시작 설정
/etc/init.d/wireguard enable

# Docker 설치
opkg install docker docker-compose luci-app-dockerman

# Docker 서비스 시작
/etc/init.d/dockerd enable
/etc/init.d/dockerd start

# 설치 확인
docker --version
docker info

# 영구 저장 디렉터리 생성
mkdir -p /srv/homeassistant

# 이미지 받아서 실행
docker run -d \
  --name homeassistant \
  --restart=unless-stopped \
  --network=host \
  -v /srv/homeassistant:/config \
  homeassistant/home-assistant:stable

# 브라우저에서 http://192.168.2.1:8123 접속

docker run -d \
  --name adguardhome \
  --restart=unless-stopped \
  --network=host \
  -v /srv/adguard/work:/opt/adguardhome/work \
  -v /srv/adguard/conf:/opt/adguardhome/conf \
  adguard/adguardhome:latest

# frp 클라이언트 설치
opkg install frp

# frpc 설정
vi /etc/frpc/frpc.toml

serverAddr = "frp 서버 IP"
serverPort = 7000

[[proxies]]
name = "web"
type = "tcp"
localIP = "127.0.0.1"
localPort = 80
remotePort = 8080

# frp 시작
/etc/init.d/frpc enable
/etc/init.d/frpc start

# nlbwmon 설치(경량 트래픽 통계)
opkg install nlbwmon luci-app-nlbwmon

# 또는 더 강력한 BanDaWidth 설치
opkg install bandwidth

# 실시간 트래픽 모니터링 설치(iftop의 OpenWrt 버전)
opkg install iftop

# 어떤 IP가 대역폭을 가장 많이 쓰는지 실시간 확인
iftop -i br-lan

# IPv6 활성화(보통 LuCI에서 조작하는 것이 직관적입니다)
# 네트워크 → 인터페이스 → LAN → 편집 → DHCP 서버 → IPv6 설정

# 명령줄 방식:
uci set network.lan6='interface'
uci set network.lan6.device='@device'
uci set network.lan6.proto='dhcpv6'
uci commit network
/etc/init.d/network restart

# 방식 1: LuCI 웹 인터페이스
# 시스템 → 백업/업그레이드 → 새 펌웨어 다운로드 → 플래싱

# 방식 2: 명령줄 업데이트
sysupgrade -v /tmp/openwrt-xxx-squashfs-sysupgrade.bin

# 설정 유지하며 업데이트(추천):
sysupgrade -c /tmp/openwrt-xxx-squashfs-sysupgrade.bin

# 설정 유지 없이 업데이트(클린 설치):
sysupgrade -n /tmp/openwrt-xxx-squashfs-sysupgrade.bin

# 현재 설정 백업
sysupgrade -b /tmp/config-backup.tar.gz

# 백업에서 복구
sysupgrade -r /tmp/config-backup.tar.gz

# 백업 내용 확인
tar tzf /tmp/config-backup.tar.gz

# 소프트웨어 소스 업데이트
opkg update

# 패키지 검색
opkg find luci-app-*

# 패키지 설치
opkg install <패키지명>

# 설치된 패키지 목록
opkg list-installed

# 패키지 제거
opkg remove <패키지명>

# 캐시 정리
opkg clean

# WAN 포트가 IP를 받았는지 확인
ifconfig eth1

# 기본 게이트웨이 확인
route -n

# DNS 테스트
nslookup baidu.com

# DNS 수동 설정
vi /etc/resolv.conf
# 추가: nameserver 223.5.5.5

# 네트워크 재시작
/etc/init.d/network restart

# uhttpd 서비스 상태 확인
/etc/init.d/uhttpd status

# 웹 서비스 재시작
/etc/init.d/uhttpd restart

# 방화벽 규칙 확인
iptables -L -n

# WiFi 설정 확인
wifi status

# 기본 설정 재생성
wifi config

# WiFi 설정 편집
vi /etc/config/wireless

# WiFi 활성화
uci set wireless.@wifi-device[0].disabled=0
uci commit wireless
wifi reload