Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

OpenWrt 系统学习路线总览

本课程基于你路由器 /etc/config/ 目录下的真实配置文件编写,并结合 OpenWrt 官方文档(openwrt.org/docs)的知识体系,按照“由浅入深、由内到外“的顺序重新组织,帮助你从“会改配置“进阶到“懂原理、能排错“。

为什么这样安排顺序

很多人学 OpenWrt 是从“网络配置“直接开始的,但这样容易卡在两个地方:

  1. 不知道怎么安全地登录和管理路由器(结果改错配置后进不去了);
  2. 不理解 UCI 配置系统的基本语法,只会照抄命令,遇到新场景不会举一反三。

所以本课程的顺序是:

先学会怎么“进得去、改得对、退得出“(UCI + 远程管理),再学网络(网络接口 → DNS/DHCP → 无线),然后学安全(防火墙),最后学维护和进阶应用(存储备份、代理分流、性能调优)。

十个阶段一览

阶段文件主题对应你的配置文件官方文档方向
0101-UCI配置系统入门.mdUCI 是什么、怎么改配置、原子提交通用(以 system/luci 举例)Guide → Base system → UCI
0202-远程管理与系统基础.md主机身份、SSH、Web 管理、终端、权限system dropbear uhttpd luci rpcd ttydBase system → Dropbear / LuCI Essentials
0303-网络核心-接口与网桥.md网桥、LAN/WAN/WAN6 接口、IPv6 路由network(含新旧对比)Network → Network configuration
0404-DHCP与DNS服务.mddnsmasq、DHCP 地址池、IPv6 RA/DHCPv6、广告过滤dhcp adblockBase system → DHCP and DNS
0505-无线网络配置.md双频无线、加密方式、客户端隔离wireless(含新旧对比)Network → Wireless
0606-防火墙与安全策略.md区域/规则/端口转发、nftables、RADIUSfirewall radiusFirewall → Firewall configuration
0707-存储_备份与固件升级.mdoverlay 文件系统、USB 挂载、备份还原、升级fstab ubihealthd attendedsysupgrade opensslBase system → Flash layout / Backup
0808-进阶-代理与流量分流.md透明代理、分流规则、DNS 分流homeproxy passwall(进阶主题,官方文档较少覆盖,以社区最佳实践为主)
0909-进阶-性能调优与故障排查.md硬件加速、连接跟踪、系统化排错方法综合 firewall/network/systemTroubleshooting

如何使用这套教程

  1. 按顺序阅读,不要跳到第 8/9 阶段就想学“科学上网“——那需要前面 7 个阶段的知识作地基。
  2. 每个阶段都会:
    • 先讲官方文档里的通用原理
    • 再逐条对照你自己路由器里的真实配置
    • 给出可以直接在你的路由器上运行的调试命令
    • 最后有“进阶提示“和“自测题“。
  3. 建议边看边操作:SSH 登录路由器后,用 uci export <配置名> 把对应配置导出来,跟教程逐行对照。
  4. 我注意到目录里有 dhcp.bak-*network.bak-*wireless.bak-* 三个备份文件——这是你之前修改配置前手动做的备份,非常好的习惯。第 03、04、05 阶段会特意对比“新旧配置的差异“,这是学习 OpenWrt 最快的方式之一:看别人(也就是你自己过去)改了什么、为什么改。

一个安全提醒

你的配置文件里包含真实的 WiFi 密码、代理节点密码/UUID 等敏感信息。教程中会用配置项名称和结构讲解原理,但不会把这些密码/密钥原文抄写出来。建议你:

  • 定期更换 WiFi 密码和路由器管理密码;
  • 不要把 /etc/config/ 目录原样分享给不信任的人或上传到公开的 Git 仓库。

官方文档入口

  • OpenWrt 用户指南总入口:openwrt.org/docs/guide-user/start
  • UCI 系统说明:openwrt.org/docs/guide-user/base-system/uci
  • 网络配置:openwrt.org/docs/guide-user/network/network_configuration
  • 防火墙配置:openwrt.org/docs/guide-user/firewall/firewall_configuration

如果链接页面结构有变化(官方 wiki 偶尔会调整),直接在 openwrt.org 首页的搜索框搜索对应关键词即可。


准备好了就从 01-UCI配置系统入门.md 开始吧。