添加了AIO-3399B的支持
Go to file
2024-07-14 02:59:54 +00:00
.devcontainer/ci-env devcontainer: Add development environment for gihub codespace 2023-10-30 23:34:26 +01:00
.github/ISSUE_TEMPLATE octeontx: drop target 2024-06-12 21:52:41 +02:00
config Merge Official Source 2024-06-13 02:12:22 +08:00
include Merge Official Source 2024-07-12 00:52:09 +08:00
LICENSES LICENSES: sync with upstream OpenWrt 2023-01-10 15:46:44 +08:00
package Merge branch 'master' of https://github.com/immortalwrt/immortalwrt 2024-07-14 02:59:54 +00:00
scripts Merge Official Source 2024-06-21 02:27:01 +08:00
target Merge branch 'master' of https://github.com/immortalwrt/immortalwrt 2024-07-14 02:59:54 +00:00
toolchain Merge Official Source 2024-06-17 16:21:53 +08:00
tools Merge branch 'master' of https://github.com/immortalwrt/immortalwrt 2024-07-14 02:59:54 +00:00
.gitattributes add .gitattributes to prevent the git autocrlf option from messing with CRLF/LF in files 2012-05-08 13:30:49 +00:00
.gitignore gitignore: ignore local APK keys 2024-05-17 22:03:06 +03:00
BSDmakefile build: use SPDX license tags 2021-02-05 14:54:47 +01:00
Config.in Merge Official Source 2023-10-29 22:51:04 +08:00
COPYING license: re-license Project ImmortalWrt under GPL-2.0-only 2022-12-24 10:42:24 +08:00
feeds.conf.default Merge Official Source 2023-05-24 14:01:53 +08:00
Makefile build: include tests/Makefile if available 2024-06-17 17:51:31 +02:00
README.md README: update project description 2024-06-26 02:36:08 +08:00
rules.mk build: let HOST_CXXFLAGS default to HOST_CFLAGS 2024-07-08 08:49:43 +02:00

logo

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.

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
      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 libncurses5-dev libncursesw5 \
        libncursesw5-dev libpython3-dev libreadline-dev libssl-dev libtool lld llvm lrzsz mkisofs msmtp \
        nano ninja-build p7zip p7zip-full patch pkgconf python2.7 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:

      sudo bash -c 'bash <(curl -s https://build-scripts.immortalwrt.org/init_build_environment.sh)'
      

Note:

  • Do everything as an unprivileged user, not root, without sudo.
  • Using CPUs based on other architectures should be fine to compile ImmortalWrt, but more hacks are needed - No warranty at all.
  • You must not have spaces or non-ascii characters in PATH or in the work folders on the drive.
  • If you're using Windows Subsystem for Linux (or WSL), removing Windows folders from PATH is required, please see Build system setup WSL documentation.
  • Using macOS as the host build OS is not recommended. No warranty at all. You can get tips from Build system setup macOS documentation.
  • For more details, please see Build system setup documentation.

Quickstart

  1. Run git clone -b <branch> --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 the cross-compile toolchain and then cross-compile the GNU/Linux kernel & all chosen applications for your target system.

The main repository uses multiple sub-repositories to manage packages of different categories. All packages are installed via the OpenWrt package manager called opkg. If you're looking to develop the web interface or port packages to ImmortalWrt, please find the fitting repository below.

Support Information

For a list of supported devices see the OpenWrt Hardware Database

Documentation

Support Community

License

ImmortalWrt is licensed under GPL-2.0-only.

Acknowledgements

Dler Cloud JetBrains Black Box Logo logo SourceForge