把你的 Linux 设备变成路由器

❝

Linux Router 是一个基于 Flask + NetworkManager + systemd 的开源项目，能将 Debian/Armbian 设备快速转变为路由器，通过 Web 控制台集中管理系统状态、有线/Wi-Fi 网络、热点共享及客户端连接，并采用非特权 Web 服务与 root Agent 分离的架构来安全执行底层网络操作。

要点

• 系统概览：提供硬件信息、IP 地址、活动连接、存储、内存、运行状态，一站式呈现。
• 有线和 Wi-Fi 管理：支持扫描、连接、断开、配置文件绑定与遗忘网络。
• 热点功能：可创建独立 AP 或 AP+STA 并发热点，并展示已连接客户端、DHCP 租约、信号强度，支持 LAN 网段配置。
• 热点保活机制：意外断开后自动恢复连接。
• 依赖检测与修复：自动检查 NetworkManager、wpa_supplicant、dnsmasq、iptables、iw 等运行环境并支持引导修复。
• 双服务架构：Web 服务以普通用户 router-panel 运行，负责页面、登录、CSRF 防护和操作提交；root Agent 通过 Unix Socket 接收指令，仅执行白名单内的系统查询与网络变更，兼顾安全与功能。
• 附加工具：提供 Tailscale 登录辅助、服务监控、密码修改、设备重启等运维工具。

安装

• 默认安装路径：

• 程序目录：/opt/linux-router
• 数据目录：/var/lib/linux-router
• Web 服务：router-panel.service
• root Agent 服务：router-panel-agent.service

• 安装：

  curl -fsSL https://raw.githubusercontent.com/Jaksay/Linux-Router/main/install.sh \  -o /tmp/linux-router-install.shsudo bash /tmp/linux-router-install.sh install

  安装脚本会自动检查或安装依赖，部署应用，创建服务账号并配置网络栈。首次登录用户名为 admin，初始密码在安装结束时打印，并保存在 /var/lib/linux-router/initial_password.txt 中。登录后应立即修改密码。

系统要求：仅支持 Debian 13 或基于 Debian 的 Armbian，必须预装 systemd、apt、NetworkManager，且网络接口由 NetworkManager 管理。

依赖自动安装：安装脚本会自动安装或检查 Python 3、Flask、Gunicorn、wpa_supplicant、dnsmasq-base、iptables、iw、iproute2、udev、curl、tar 等依赖，目标设备无需安装 Git。

项目由 Jaksay 开发，采用 GPL-3.0 协议，当前 124 Stars。

❝

项目地址：https://github.com/Jaksay/Linux-Router