Repolode
Jaksay

Jaksay/Linux-Router

基于 Flask 的 Web 控制台,可将 Debian 或 Armbian 设备改造成路由器,管理有线网络、Wi-Fi、热点和连接设备。

Star
171
Fork
7
未关闭 Issue
0
最近提交
3个月前

这是什么?

Linux Router 可以把运行 Debian 13 或基于 Debian 的 Armbian 的设备变成路由器,并通过 Web 控制台进行配置。控制台涵盖系统状态、有线与 Wi-Fi 网络管理、热点创建、热点客户端查看(包括 DHCP 租约和无线信号详情),以及依赖修复、密码修改和重启等维护功能。

系统分为两个 systemd 服务:Flask Web 服务以非特权用户运行,另有一个 root 权限的 Agent 通过 Unix socket 执行白名单内的系统查询和网络变更。网络操作由 Agent 串行执行,Web 界面查询操作结果并刷新状态。

安装、升级和卸载由 Shell 脚本完成,脚本从 GitHub 下载源码包。由于这些操作会修改 NetworkManager、netplan 和 dhcpcd 配置,可能中断网络连接,建议在本地控制台或维护窗口中执行。

核心功能

  • 01系统概览,包括硬件、IP 地址、存储、内存和运行状态
  • 02有线与 Wi-Fi 管理,支持扫描、连接和配置文件绑定
  • 03热点支持独占 AP 模式及受支持的 AP+STA 并发模式
  • 04热点客户端列表,显示 DHCP 租约和无线信号详情
  • 05热点保活,意外断开后自动恢复
  • 06检查 NetworkManager、dnsmasq、iptables 等依赖并提供引导式修复

适用场景

  • 把闲置的 Debian 或 Armbian 单板机改造成 Wi-Fi 热点网关
  • 在浏览器中管理小型家庭或实验室网络,无需手动敲命令
  • 通过本地热点,将有线或 Wi-Fi 上行网络共享给连接的设备

快速上手

  1. 1

    下载安装脚本

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

    执行全新安装

    sudo bash /tmp/linux-router-install.sh install
  3. 3

    使用 admin 账户和生成的初始密码登录,然后修改密码

使用前须知

  • 仅支持 Debian 13 或基于 Debian 的 Armbian,且需要 NetworkManager。
  • 安装、升级和网络栈修复会修改主机网络配置,可能中断网络连接。
  • 分发修改后的版本时,必须以 GPL-3.0 协议发布并提供源代码。

标签

常见问题

Linux-Router 是什么?
基于 Flask 的 Web 控制台,可将 Debian 或 Armbian 设备改造成路由器,管理有线网络、Wi-Fi、热点和连接设备。 Linux Router 可以把运行 Debian 13 或基于 Debian 的 Armbian 的设备变成路由器,并通过 Web 控制台进行配置。控制台涵盖系统状态、有线与 Wi-Fi 网络管理、热点创建、热点客户端查看(包括 DHCP 租约和无线信号详情),以及依赖修复、密码修改和重启等维护功能。
Linux-Router 可以免费使用吗?用的什么许可证?
Linux-Router 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
Linux-Router 还在维护吗?
半年内有更新。Linux-Router 最近一次提交是在 2026年7月28日。
Linux-Router 适合用来做什么?
把闲置的 Debian 或 Armbian 单板机改造成 Wi-Fi 热点网关 在浏览器中管理小型家庭或实验室网络,无需手动敲命令 通过本地热点,将有线或 Wi-Fi 上行网络共享给连接的设备
Linux-Router 怎么安装和运行?
下载安装脚本: curl -fsSL https://raw.githubusercontent.com/Jaksay/Linux-Router/main/install.sh -o /tmp/linux-router-install.sh 执行全新安装: sudo bash /tmp/linux-router-install.sh install 使用 admin 账户和生成的初始密码登录,然后修改密码
在哪里获取 Linux-Router?
源代码和安装说明在 GitHub 上:https://github.com/Jaksay/Linux-Router

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目