immortalwrt/immortalwrt
GitHub: immortalwrt/immortalwrt
一个专为中国大陆用户优化的 OpenWrt 分支,提供更丰富的软件包、更广泛的设备支持和开箱即用的本地化配置。
Stars: 10184 | Forks: 3231

# ImmortalWrt 项目
ImmortalWrt 是 [OpenWrt](https://openwrt.org) 的一个分支,移植了更多的软件包,支持更多的设备,并为大陆用户提供了默认优化的配置文件和本地化修改。
与上游相比,我们允许使用(非上游适用的)修改/技巧(hacks)来提供更好的功能、性能和支持。
默认登录地址:http://192.168.1.1 或 http://immortalwrt.lan,用户名:__root__,密码:_无_。
## 下载
针对许多架构预构建的固件镜像已经可用,并附带可用作 WiFi 家用路由器的软件包选择。要快速找到可用于从厂商原厂固件迁移到 ImmortalWrt 的出厂镜像,请尝试 *固件选择器*。
- [ImmortalWrt 固件选择器](https://firmware-selector.immortalwrt.org/)
如果您的设备受支持,请点击 **Info** 链接查看安装说明,或查阅下面列出的支持资源。
## 开发
要构建您自己的固件,您需要一个 GNU/Linux、BSD 或 macOS 系统(需要区分大小写的文件系统)。Cygwin 不受支持,因为它缺乏区分大小写的文件系统。
### 系统要求
使用本项目进行构建,首选 Debian 11。且您需要使用基于 AMD64 架构的 CPU,至少 4GB 内存和 25GB 可用磁盘空间。确保 __互联网__ 可访问。
编译 ImmortalWrt 需要以下工具,软件包名称因发行版而异。
- 以下是 Debian/Ubuntu 用户的示例:
- 方法 1:
通过 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 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
- 方法 2:
sudo bash -c 'bash <(curl -s https://build-scripts.immortalwrt.org/init_build_environment.sh)'
注意:
- 请以非特权用户身份执行所有操作,不要使用 root,也不要使用 sudo。
- 使用基于其他架构的 CPU 编译 ImmortalWrt 应该也是可行的,但需要更多的修改(hacks)——完全不提供任何保证。
- 您的 PATH 或驱动器上的工作文件夹中 __绝不能__ 包含空格或非 ASCII 字符。
- 如果您使用的是适用于 Linux 的 Windows 子系统(或 WSL),则需要从 PATH 中移除 Windows 文件夹,请参阅 [构建系统设置 WSL](https://openwrt.org/docs/guide-developer/build-system/wsl) 文档。
- __不__ 建议使用 macOS 作为主机构建操作系统。完全不提供任何保证。您可以从 [构建系统设置 macOS](https://openwrt.org/docs/guide-developer/build-system/buildroot.exigence.macosx) 文档中获取提示。
- 更多详情,请参阅 [构建系统设置](https://openwrt.org/docs/guide-developer/build-system/install-buildsystem) 文档。
### 快速入门
1. 运行 `git clone -b
--single-branch --filter=blob:none https://github.com/immortalwrt/immortalwrt` 克隆源代码。
2. 运行 `cd immortalwrt` 进入源代码目录。
3. 运行 `./scripts/feeds update -a` 获取 feeds.conf / feeds.conf.default 中定义的所有最新软件包定义。
4. 运行 `./scripts/feeds install -a` 将所有获取到的软件包的符号链接安装到 package/feeds/ 目录。
5. 运行 `make menuconfig` 选择您偏好的工具链、目标系统和固件软件包配置。
6. 运行 `make` 构建您的固件。这将下载所有源代码,构建交叉编译工具链,然后为您的目标系统交叉编译 GNU/Linux 内核及所有选定的应用程序。
### 相关仓库
主仓库使用多个子仓库来管理不同类别的软件包。所有软件包都通过名为 opkg 的 OpenWrt 软件包管理器进行安装。如果您打算开发 Web 界面或将软件包移植到 ImmortalWrt,请在下方找到合适的仓库。
- [LuCI Web 界面](https://github.com/immortalwrt/luci):通过 Web 浏览器控制设备的现代且模块化的界面。
- [ImmortalWrt 软件包](https://github.com/immortalwrt/packages):移植软件包的社区仓库。
- [OpenWrt 路由](https://github.com/openwrt/routing):专门针对(Mesh)路由的软件包。
- [OpenWrt 视频](https://github.com/openwrt/video):专门针对显示服务器和客户端(Xorg 和 Wayland)的软件包。
## 支持信息
有关受支持设备的列表,请参阅 [OpenWrt 硬件数据库](https://openwrt.org/supported_devices)
### 文档
- [快速入门指南](https://openwrt.org/docs/guide-quick-start/start)
- [用户指南](https://openwrt.org/docs/guide-user/start)
- [开发者文档](https://openwrt.org/docs/guide-developer/start)
- [技术参考](https://openwrt.org/docs/techref/start)
### 支持社区
- 支持聊天:[Telegram](https://telegram.org/) 上的群组 [@ctcgfw_openwrt_discuss](https://t.me/ctcgfw_openwrt_discuss)。
- 支持聊天:[Matrix](https://matrix.org/) 上的群组 [#immortalwrt](https://matrix.to/#/#immortalwrt:matrix.org)。
## 许可证
ImmortalWrt 采用 [GPL-2.0-only](https://spdx.org/licenses/GPL-2.0-only.html) 许可。
## 致谢
标签:Cutter, ImmortalWrt, OpenWrt, OpenWrt分支, rizin, WiFi, 中国大陆, 固件编译, 客户端加密, 客户端加密, 嵌入式系统, 开源, 智能家居, 本土化, 系统优化, 网络基础设施, 网络安全, 网络设备, 网络通信, 自定义固件, 路由器固件, 路由系统, 软路由, 隐私保护