immortalwrt /immortalwrt
An opensource OpenWrt variant for mainland China users.
★ 11,928⑂ 4,100👁 96⑃ 507● 1,129▤ 0
+2
Daily
11,928
stars
4,100
forks
96
watchers
507
prs
1,129
issues
0
releases
README
Project ImmortalWrt
ImmortalWrt is a fork of OpenWrt, with more packages ported, more devices supported, default optimized profiles and localization modifications for mainland China users.
Compared to upstream, we allow to use (non-upstreamable) modifications/hacks to provide better feature/performance/support.
Default login address: http://192.168.1.1 or http://immortalwrt.lan, username: __root__, password: _none_.
Download
Built firmware images are available for many architectures and come with a package selection to be used as WiFi home router. To quickly find a factory image usable to migrate from a vendor stock firmware to ImmortalWrt, try the Firmware Selector.
- ImmortalWrt Firmware Selector
If your device is supported, please follow the Info link to see install instructions or consult the support resources listed below.
Development
To build your own firmware you need a GNU/Linux, BSD or macOS system (case sensitive filesystem required). Cygwin is unsupported because of the lack of a case sensitive file system.
Requirements
To build with this project, Debian 11 is preferred. And you need use the CPU based on AMD64 architecture, with at least 4GB RAM and 25 GB available disk space. Make sure the __Internet__ is accessible.
The following tools are needed to compile ImmortalWrt, the package names vary between distributions.
- Here is an example for Debian/Ubuntu users:
- Method 1:
Setup dependencies via APT
bash
sudo apt update -y
sudo apt full-upgrade -y
sudo apt install -y ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
bzip2 ccache clang cmake cpio curl device-tree-compiler ecj fastjar flex gawk gettext gcc-multilib \
g++-multilib git gnutls-dev gperf haveged help2man intltool lib32gcc-s1 libc6-dev-i386 libelf-dev \
libglib2.0-dev libgmp3-dev libltdl-dev libmpc-dev libmpfr-dev libncurses-dev libpython3-dev \
libreadline-dev libssl-dev libtool libyaml-dev libz-dev lld llvm lrzsz mkisofs msmtp nano \
ninja-build p7zip p7zip-full patch pkgconf python3 python3-pip python3-ply python3-docutils \
python3-pyelftools qemu-utils re2c rsync scons squashfs-tools subversion swig texinfo uglifyjs \
upx-ucl unzip vim wget xmlto xxd zlib1g-dev zstd
- Method 2:
bash
sudo bash -c 'bash --single-branch --filter=blob:none https://github.com/immortalwrt/immortalwrt to clone the source code.
2. Run cd immortalwrt to enter source directory.
3. Run ./scripts/feeds update -a to obtain all the latest package definitions defined in feeds.conf / feeds.conf.default
4. Run ./scripts/feeds install -a to install symlinks for all obtained packages into package/feeds/
5. Run make menuconfig to select your preferred configuration for the toolchain, target system & firmware packages.
6. Run make to build your firmware. This will download all sources, build theTop issues
#1764Cudy TR3000刷immortalwrt 24.10后USB连接F50随身WI-FI接口持续断开(设备未自动重启)17 comments · 2025-03-19#1757Orange pi 5 16G NVME12 comments · 2025-03-14#1905Xunlong Orange Pi 5 Plus USB3.0 无法识别10 comments · 2025-06-03#2379Cubie A5E not bootable8 comments · 2026-05-27#2323/usr/sbin/bridger 内存泄露8 comments · 2026-04-05#2240RTL8111E网卡TX方向速度只能跑~600Mbps7 comments · 2026-02-08#2107NLnet XiGuaPi V3上RM520N-GL AP模块,PCIe通道,拨号成功后上网时会崩溃重启7 comments · 2025-11-05#1559k3 划分vlan后导致WiFi无法连接,提示密码错误7 comments · 2024-11-01
Discussions
#2521Attended Sysupgrade 构建失败:GLIBC_2.34 not found1 comments · 2026-11-12#2520Support for GL.iNet BE6500 (Flint3e),Newest WIFI7 Home Router0 comments · 2026-11-08#2518mediatek: 请求增加 Ruijie RG-EW6000GX PRO 设备支持(MT7986A + MT7531)0 comments · 2026-11-05#2507rpcd及其附件版本过低0 comments · 2026-10-23#2500luci-app-appfilter 最新版本v7.0.1能否同步更新下0 comments · 2026-10-12#2499我要提交什么,才可以让immortalwrt官方支持JDC ra50设备?1 comments · 2026-10-12#2494编译的immortalwrt进不去后台2 comments · 2026-09-30#2486扩容 Root 分区后无法正常升级或升级后无法保留用户数据的解决方案0 comments · 2026-09-20