OpenWrt 25.12
Ostatnia zmiana: 2026-05-05 17:34
Zmieniając oprogramowanie w routerze w większości przypadków tracisz gwarancję producenta. Robisz to na własną odpowiedzialność, mając świadomość że może to spowodować uszkodzenie routera. Nie biorę żadnej odpowiedzialności za to, co się stanie z routerem po wgraniu tego oprogramowania.
Moje obrazy budowane są z bieżącej gałęzi wydania stabilnego OpenWrt 25.12, zawierają modyfikacje które uważam za niezbędne lub wartościowe i powinny być domyślnie włączone do budowanych obrazów a z różnych powodów nie zostały włączone do oficjalnych wydań. Moje obrazy różnią się od oryginalnych wydawanych przez zespół OpenWrt innym doborem pakietów i opcjami kompilacji, choć są w pełni kompatybilne jeżeli chodzi o ustawienia i pakiety z programami. Poza nielicznymi zmianami w systemie (np. dodającymi moje własne repozytoria), obrazy standardowo zawierają moje następujące pakiety:- ekooneplconfigs: pliki i ustawienia specyficzne dla moich obrazów (np. prompt, strefa czasowa)
- ekooneplstat: pakiet do zgłaszania statystyki
- sysinfo: wyświetlanie informacji o systemie po zalogowaniu się użytkownika przez ssh
Czym się różni 25.12-SNAPSHOT od wydania 25.12.x? Źródła OpenWrt podzielone są na tzw. branche, czyli różne gałęzie rozwojowe. Jedna z nich o nazwie openwrt-25.12 zawiera źródła wydania stabilnego linii 25.12 i ma ona określenie wersji właśnie jako 25.12-SNAPSHOT. Wydanie 25.12.x to nic innego jak źródła wersji stabilnej pobrane określonego dnia z gałęzi openwrt-25.12 i oznaczone jako 25.12.x. Gałąź 25.12-SNAPSHOT zawiera się nowsze aktualizacje i poprawki niż wydanie 25.12.x.
Wydanie 25.12 nie posiada domyślnie opkg. Nowe wydanie posiada apk. Nie można używać pakietów ipk na tym systemie, muszą być z rozszerzeniem apk.
Mała "ściąga" z poleceniami dla apk:
opkg install <pkg> apk add <pkg> Instalacja pakietu
opkg remove <pkg> apk del <pkg> Usunięcie pakietu
opkg files <pkg> apk info -L <pkg> Wyświetlenie zawartości pakietu
opkg list-installed apk info Lista zainstalowanych pakietów
opkg update apk update Aktualizacja listy pakietów
opkg search <pkg> apk search <pkg> Wyszukiwanie pakietu
Parametry domyślne dla wszystkich obrazów:
- adres IP: 192.168.1.1 (oprócz urządzeń typu NAS dla architektury kirkwood - tam jest klient dhcp i należy podłączyć je do sieci lokalnej żeby dostały adres IP)
- użytkownik: root
- hasło: puste (do ustawienia poleceniem passwd)
- Wi-Fi domyślnie wyłączone
Moduły kernela muszą być instalowane z tego samego źródła skąd pochodzą obrazy, czyli wymienionego poniżej repozytorium. Z innych źródeł mogą nie działać. Muszą być także w takiej samej wersji co zainstalowany kernel.
W nazwie pliku jest oznaczenie modelu routera do którego jest on przeznaczony.
OpenWrt 25.12 nie powinno być używane na routerach z 32MB lub mniej pamięci RAM.
To wersja pozbawiona GUI (środowiska graficznego) - czysta konsola. Potrzebujesz GUI to używaj obrazów z LuCI.
Obrazy z factory w nazwie służy do instalacji z oryginalnego oprogramowania.Obrazy z sysupgrade w nazwie służy do aktualizacji z poziomu OpenWrt, LEDE, MiFi lub Gargoyle.
Obrazy z sysupgrade-v7 w nazwie przeznaczone są dla routerów firmy MikroTik które mają bootloader z wersji 7.x.
Obrazy -us służą do aktualizacji routerów sprzedawanych na terenie USA.
Obrazy -eu służą do aktualizacji routerów sprzedawanych na terenie Unii Europejskiej (czyli np. zakupionych w dystrybucji w Polsce).
Obrazy -il- przeznaczone są dla routerów sprzedawanych w Izraelu.
Inne obrazy które mają w nazwie initramfs, tftp, kernel itp. przeznaczone są dla niektórych routerów do przejścia z oryginalnego oprogramowania producenta na OpenWrt i nie stosuje się ich później do aktualizacji działającego OpenWrt.
Dla niektórych modeli routerów nie będzie można wykonać aktualizacji przez sysupgrade z powodu zmiany podziału flash; w takich przypadkach trzeba będzie wykonać instalację obrazu factory wykorzystując metodę dostępną dla danego modelu (np. przez tftp czy tryb awaryjny bootloadera). W takim przypadku nie będzie można też odtworzyć backupu z poprzedniej wersji.
Dla niektórych modeli routerów nie będzie można wykonać aktualizacji przez sysupgrade z zachowaniem konfiguracji z powodu przejścia na inny sposób konfiguracji switcha; w takich przypadkach trzeba będzie aktualizację z opcją "-n" (bez zachowania konfiguracji) lib/i z opcją "-F" (wymuszenie aktualizacji). W takim przypadku nie będzie można też odtworzyć backupu z poprzedniej wersji.
Narzędzie owut działa z serwerem aktualizacji sysupgrade.eko.one.pl, więcej informacji o tym projekcie w tym linku.
Adres serwera dla interaktywnej aktualizacji: https://sysupgrade.eko.one.pl
Link do wyszukiwarki obrazów: https://dl.eko.one.pl/firmware/
Link do dyskusji na forum o tym wydaniu: https://eko.one.pl/forum/viewtopic.php?pid=326975
Historia zmian
- data wydania - numer/lista zmian w OpenWrt
- 2026-05-05 - r32909-7014bb7ee2
- dodanie obrazów dla Zbtlink ZBT-Z8105AX
- dodanie obrazów dla D-Link M30/CP ubootmod
- dodanie obrazów dla targetu mvebu/cortexa72
- umieszczenie pakietu luci-app-mini-diskmanager dla urządzeń typu NAS oraz targetu x86
- 2026-03-29 - r32806-b2685cef6a
- dodanie pakietów AmneziaWG for OpenWRT
- dodanie obrazów dla RaspberryPi RPI-4, RPI-5 (CM4/CM5)
- dodanie pakietów luci-app-modemdata oraz luci-app-sms-tool-js do obrazów routerów z modemami komórkowymi
- dodanie repozytorium gotowych pakietów Nikki do ASU
- 2026-03-02 - r32702-5b66b10095
- dodanie pakietu kmod-phy-aquantia do obrazów BananaPi BPi-R4
- dodanie wsparcia dla RM520N-GL wariant 0x5201 (PCI)
- 2026-02-02 - r32537-6afff2039b
- poprawa listy repozytorium dla architektury kirkwood
- 2026-01-04 - r32403-ec16f2532d
- 2025-12-29 - r32376-d819a05a8e
- 2025-12-26 - r32362-116083dd91
Architektury
Dostępny jest klucz publiczny którym podpisane są repozytoria. Jeżeli ktoś chce używać repozytorium eko.one.pl, a nie używa moich obrazów:
# echo 'https://dl.eko.one.pl/<target>/<subtarget>/<repo>/packages.adb' >> /etc/apk/repositories.d/eko1apk.list
# wget https://dl.eko.one.pl/packages/apk/eko1-pub.pem -O /etc/apk/keys/eko1apk.pem
# apk update
Aktualnie budowane są następujące wybrane architektury (w nawiasie podano sposób obsługi switcha):
- ath79 (swconfig)
- ipq40xx (DSA)
- ipq806x (DSA)
- kirkwood (DSA)
- mediatek (DSA)
- mvebu (DSA)
- ramips (MT7620 - swconfig, MT7621 - DSA, MT76x8 - swconfig)
- rockchip (DSA)
Zawartość obrazów
Wszystkie obrazy i odmiany budowane są z tego samego źródła. Jako podstawę wykorzystano branch OpenWrt 25.12-SNAPSHOT z niektórymi poprawkami stworzonymi przeze mnie, udostępnionymi w internecie lub zaimportowanymi z gałęzi rozwojowej.Główna charakterystyka obrazów (dla wszystkich urządzeń):
- lista pakietów dla danego urządzenia zgodna z domyślną listą zawartą w OpenWrt
- brak środowiska graficznego (GUI), czysta konsola
- obsługa wifi
- ustawiona strefa czasowa Europe/Warsaw
- odblokowana możliwość użycia kanałów 12/13 (o ile sterownik to wspiera) - domyślnie włączone opcje REGD/DFS, region ustawiony na PL
- dodany skrypt wyświetlający stan systemu po zalogowaniu się przez ssh
- kolorowanie zgłoszenia shella w konsoli
- zapis historii poleceń konsoli w bieżącej sesji
- dodany program ftpput
- dodany skrypt do obsługi statystyk (domyślnie wyłączony w cronie)
- obsługę USB
- obsługę usb_storage/usb-storage-uas
- pakiet block-mount
- obsługę systemów plików f2fs
- pakiety mkf2fs i f2fsck (tworzenie i naprawa systemów plików f2fs)
- obsługę systemów plików vfat/ext2/ext3/ext4
- pakiet e2fsprogs (tworzenie i naprawa systemów plików ext2/3/4)
- rfkill: wyłączenie/włączenie interfejsu radiowego
- reset: naciśnięcie do 1s powoduje restart urządzenia, powyżej 5s - przywrócenie ustawień domyślnych
- power: wyłączenie urządzenia
Własna kompilacja
W katalogu z obrazami można znaleźć pliki config.buildinfo.* które zawierają opcje z których zostały zbudowane dane obrazy. Aby uzyskać pełen plik konfiguracyjny, należy w katalogu ze źródłami OpenWrt wykonać np.:
# wget https://dl.eko.one.pl/openwrt-25.12/ścieżka do pliku config.buildinfo.usb
# mv config.buildinfo.usb .config
# make defconfig
Extroot
W wersji dla urządzeń z USB znajduje się już pakiet block-mount odpowiadający za możliwość zrobienia extroota. Konfiguracja extroot opisana jest w w/w dokumencie.Dalsza konfiguracja
Konfigurację można wykonać po zalogowaniu się przez ssh. W pierwszej kolejności po zalogowaniu należy ustawić hasło:
# passwd
# uci set wireless.@wifi-device[0].disabled=0
# uci set wireless.@wifi-iface[0].ssid=moja_siec
# uci set wireless.@wifi-iface[0].encryption=psk2
# uci set wireless.@wifi-iface[0].key='superTajnehaSlo!42'
# uci commit wireless
# wifi
Instalacja LuCI (interfejsu graficznego - GUI)
# apk add luci
# /etc/init.d/uhttpd enable
# /etc/init.d/uhttpd start
LuCI
Dostępna jest wersja OpenWrt z wbudowanym interfejsem graficznym o nazwie LuCI. Obrazy te mają też wsparcie dla modemów USB.Problemy
W razie problemów z działaniem obrazów po własnych modyfikacjach/konfiguracjach można posłużyć się trybem failsafe.