• R/O
  • HTTP
  • SSH
  • HTTPS

immortalwrt: Résumé du dépôt

Mirror only - Please move to https://github.com/immortalwrt/immortalwrt


Commits Récents RSS

Révision l'heure Auteur Message:
a8fcafa 2022-05-27 00:42:37 Tianling Shen openwrt-18.06-k5.4 feeds: use 22.03 branch for routing and telephony repo S...
f0522b7 2022-05-26 20:34:39 Petr Štetiar openwrt-18.06 treewide: use wpad-basic-openssl as default In order to ...
78ed493 2022-05-26 20:16:03 Tianling Shen mac80211: brcm: fix build for kernel < 4.13 Signed-off-b...
b3fd8d4 2022-05-26 18:26:47 Tianling Shen util-linux: update to 2.37.4 Signed-off-by: Tianling She...
0d1dfcb 2022-05-26 18:25:42 Tianling Shen Revert "util-linux: update to 2.38" This breaks build on...
206ad7b 2022-05-26 18:24:32 Tianling Shen Revert "util-linux: use meson to build" util-linux 2.37 ...
70185ee 2022-05-26 18:24:15 Oskari Rauta util-linux: add lsns lsns lists system namespaces Signe...
42f500a 2022-05-26 18:23:31 Stijn Tintel util-linux: package ipcs command Add a package for util-...
c1ba87f 2022-05-26 18:23:19 Roman Azarenko util-linux: add lslocks This change adds the "lslocks" u...
31c6603 2022-05-26 18:23:00 Hauke Mehrtens util-linux: Add taskset This adds the taskset applicatio...

Tags récemment modifiées

Nom Révision l'heure Auteur
v21.02.0 57dfa29 2022-04-22 08:11:47 Tianling Shen

Branches

Nom Révision l'heure Auteur Message:
openwrt-18.06-k5.4 a8fcafa 2022-05-27 00:42:37 Tianling Shen feeds: use 22.03 branch for...
openwrt-18.06 f0522b7 2022-05-26 20:34:39 Petr Štetiar treewide: use wpad-basic-op...
openwrt-21.02 80dddbf 2022-05-25 23:38:44 Tianling Shen target: use wpad-basic-open...
master 0b84c14 2022-05-25 15:14:15 ZiMing Mo dnsmasq: use inet family & ...

README.md

logo

Project ImmortalWrt

ImmortalWrt is a fork of OpenWrt, with more packages ported, more devices supported, better performance, and special optimizations for mainland China users.
Compared the official one, we allow to use hacks or non-upstreamable patches / modifications to achieve our purpose. Source from anywhere.

Default login address: http://192.168.1.1 or http://immortalwrt.lan, username: root, password: password.

Development

To build your own firmware you need a GNU/Linux, BSD or MacOSX system (case sensitive filesystem required). Cygwin is unsupported because of the lack of a case sensitive file system.

### Requirements To build with this project, Ubuntu 18.04 LTS 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 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 cmake cpio curl device-tree-compiler ecj fastjar flex gawk gettext gcc-multilib g++-multilib \
        git gperf haveged help2man intltool lib32gcc1 libc6-dev-i386 libelf-dev libglib2.0-dev libgmp3-dev libltdl-dev \
        libmpc-dev libmpfr-dev libncurses5-dev libncursesw5 libncursesw5-dev libreadline-dev libssl-dev libtool lrzsz \
        mkisofs msmtp nano ninja-build p7zip p7zip-full patch pkgconf python2.7 python3 python3-pip python3-ply \
        python-docutils qemu-utils re2c rsync scons squashfs-tools subversion swig texinfo uglifyjs upx-ucl unzip \
        vim wget xmlto xxd zlib1g-dev
      

    • Method 2: bash curl -s https://build-scripts.immortalwrt.eu.org/init_build_environment.sh | sudo bash
  • You can also download and use prebuilt container directly:
    See #Quickstart - Build image via OPDE

    Note:

  • For the for love of god please do not use ROOT user to build your image.
  • 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 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

  • Method 1:

    1. Run git clone -b <branch> --single-branch 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.
  • Method 2: Build image via OPDE

    • Pull the prebuilt container:

      docker pull immortalwrt/opde:base
      # docker run --rm -it immortalwrt/opde:base
      
    • For Linux User:

      git clone -b <branch> --single-branch https://github.com/immortalwrt/immortalwrt && cd immortalwrt
      docker run --rm -it \
          -v $PWD:/openwrt \
        immortalwrt/opde:base zsh
      ./scripts/feeds update -a && ./scripts/feeds install -a
      
    • For Windows User:

      1. Create a volume 'immortalwrt' and clone ImmortalWrt source into volume. bash docker run --rm -it -v immortalwrt:/openwrt immortalwrt/opde:base git clone -b <branch> --single-branch https://github.com/immortalwrt/immortalwrt .
      2. Enter docker container and update feeds. bash docker run --rm -it -v immortalwrt:/openwrt immortalwrt/opde:base ./scripts/feeds update -a && ./scripts/feeds install -a
      • Tips: ImmortalWrt source code can not be cloned into NTFS filesystem (symbol link problem during compilation), but docker volume is fine.
    • Proxy Support:

      docker run --rm -it \
        -e   all_proxy=http://example.com:1081 \
        -e  http_proxy=http://example.com:1081 \
        -e https_proxy=http://example.com:1081 \
        -e   ALL_PROXY=http://example.com:1081 \
        -e  HTTP_PROXY=http://example.com:1081 \
        -e HTTPS_PROXY=http://example.com:1081 \
        -v $PWD:/openwrt \
        immortalwrt/opde:base zsh
      

      Recommand http rather socks5 protocol

      IP can not be localhost or 127.0.0.1

    • For Windows User, binary is still in volume. It can be copied to outside via followed command:

      docker run --rm -v <D:\path\to\dir>:/dst -v openwrt:/openwrt -w /dst immortalwrt:base cp /openwrt/bin /dst
      

      Make sure D:\path\to\dir has been appended in File Sharing.

    Related Repositories

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

  • LuCI Web Interface: Modern and modular interface to control the device via a web browser.
  • ImmortalWrt Packages: Community repository of ported packages.
  • OpenWrt Routing: Packages specifically focused on (mesh) routing.
  • CONTRIBUTED.md: the 3rd-party packages we introduced.

    • OpenWrt Video: Packages specifically focused on display servers and clients (Xorg and Wayland).

Support Information

For a list of supported devices see the OpenWrt Hardware Database ### Documentation - Quick Start Guide - User Guide - Developer Documentation - Technical Reference

### Support Community - Support Chat: group @ctcgfw_openwrt_discuss on Telegram. - Support Chat: group #immortalwrt on Matrix.

License

ImmortalWrt is licensed under GPL-3.0-only.

Afficher sur ancien navigateur de dépôt.