版本与分支：正式版与快照版怎么选

OpenWrt 的版本是怎么编号的

打开 OpenWrt 的下载页面，会看到一堆版本号：23.05、24.10、25.12，每个后面还跟着一串小数点，让人眼花。其实它的编号规则很简单，掌握了规律就不再困惑。版本号的结构从左到右分别对应“系列、维护更新、构建类型”三层含义，记住这个框架，任何版本号你都能一眼看懂。

大版本通常一年左右发布一次，每个大版本会持续接收安全补丁与小修复，以次版本号的形式陆续放出，比如 24.10 系列从 24.10.0 一路更新到 24.10.8，再比如更早的 23.05 系列也以同样方式更新到 23.05.6 才画上句号。次版本号之间是纯粹的修复与设备适配，不引入大改动，可以放心升级。候选版是大版本正式发布前的公开测试，功能基本定型但可能还有小瑕疵，新手不建议尝鲜，等到正式版发布再用更踏实。理解这个规律之后，你就知道该选什么：家用永远优先选当前主版本的最新一个小版本。

版本的生命周期

每个大版本都有自己的生命周期：从首次发布开始，先是全面维护阶段，所有类型的修复都会进入；随着下一个大版本发布，旧版本转入只修安全问题的阶段；最终彻底停止支持，不再有任何更新。这条曲线对所有软件都适用，OpenWrt 也不例外。了解生命周期的意义在于，你手上的设备版本决定了它在安全层面还能被照顾多久。

一个实际的建议：如果你的设备版本已经停止支持，找个空闲周末升级到当前主版本，一次麻烦换来持续几年的安全更新，这笔账很划算。反过来，如果设备型号在新版本里适配得不好，留在旧版本继续用也完全可以，安全更新虽停，功能并不受影响，等社区把适配问题解决再升级。工具是为你服务的，不是你为工具服务的，这一点适用于本书所有内容。

快照版有一个对新手很不友好的特点：它默认没有 LuCI 网页界面，需要自己装。很多人兴冲冲刷了快照版，开机后找不到管理页面，还以为刷机失败了，其实只是系统镜像里没带界面包，得手动安装。另外快照版的软件包与系统是同一天构建的，版本组合每天都在变，网上找不到与你完全对应的教程，出了问题只能自己看日志排查，社区能帮的也有限。除非你有明确的开发需求，或者某项功能只在快照版提供，否则不要碰快照版，这是本书最直接的建议。如果你确实需要某个快照版才有的软件包，更稳妥的办法是等它进入下一个正式版，通常等几个月就能在正式版里用上了。

包管理器换代：从 opkg 到 apk

前面多次提到 25.12 把包管理器从 opkg 换成了 apk，这里专门解释一下。opkg 是 OpenWrt 自研的轻量包管理器，历史超过二十年，胜在小巧，但在依赖处理、签名校验等现代需求上有些力不从心。apk 最初为 Alpine Linux 设计，功能完善且维护活跃，社区评估多年后决定引入它作为替代。对用户而言，变化主要体现在命令风格上。

具体的命令演示放在第 4 章软件包升级一节，新手阶段记住两件事就够：第一，25.12 之前的系统继续用 opkg，之后的系统用 apk，两者不会出现在同一个系统里；第二，网上教程看到命令时先确认作者用的版本，再决定照抄还是转换。这个变化也说明一件事：OpenWrt 是个活跃项目，每隔几年就会有这样的现代化改动，保持学习心态很重要。

正式版与快照版的区别

正式版是经过完整测试流程的稳定版本，快照版则是开发主分支每天的自动构建产物。打个比方，快照版是厨房里还在炒的菜，正式版是端上桌经过检验的成品。两者的差别可以用下表概括。

版本选择建议

新手最稳妥的选择是当前主版本系列的最新小版本。本书截稿时，OpenWrt 的当前稳定系列是 25.12，社区推荐普通用户优先使用它；而 24.10 系列已经进入维护尾声，不久后将停止支持，不建议新安装。此外，OpenWrt 25.12 有一个重要变化：包管理器从 opkg 换成了 apk，命令习惯略有调整，网上大量旧教程基于 opkg 编写，阅读时注意区分版本差异，看到教程里的命令在自己机器上不存在，先查版本再怀疑别的。无论你用哪个版本，”选正式版、选最新小版本、不选候选版”这三条原则不变。

新手容易踩的版本坑

版本相关的问题里，有几个反复出现的典型坑，提前知道能省很多事。

第一个坑是跨大版本升级时保留全部配置。从 23.05 升到 24.10，或者从 24.10 升到 25.12，配置格式可能有变化，保留旧配置升级容易出怪问题，比如无线工作异常、防火墙规则部分失效、某些界面选项报错。正确做法是备份配置之后干净升级，然后再把配置恢复进去，哪里不兼容一眼可见。第二个坑是拿着旧版本的教程操作新版本，界面位置、命令名都可能变化，25.12 换用 apk 之后尤其明显，看到命令执行报错先确认版本，别急着怀疑设备或自己。版本差异是所有开源软件的通病，不是你的问题，关键在于养成”先看版本再操作”的习惯。

第三个坑是用命令更新时只更新软件包而不更新系统列表。更新软件源索引和升级软件包是两个步骤，漏掉前者会提示找不到新版本，或者装到旧版本的包。这些细节在软件包升级一章会详细演示，这里先留个印象。第四个坑是盲目追新，看到新版本发布就立刻升级主力路由。新版本刚发布的头两周往往是问题集中暴露期，等次版本号出到第三四个再行动，是老玩家们的默契。你的网络如果全家都在用，稳定性的优先级永远高于尝鲜。

如何查看当前版本

想知道路由器现在跑的是什么版本，LuCI 界面顶部状态栏一目了然，点开系统信息页可以看到完整版本号、内核版本、设备型号、固件构建日期。命令行下也可以查看，相关操作在 ssh 登录路由器之后会经常用到，一条命令的输出比网页还详细。养成记录当前版本号的习惯，求助、查资料、升级之前都用得上。一个小技巧是把版本号连同设备型号一起记在备忘录里，每次升级之后更新一次，这样你随时知道自己家里网络环境的准确信息，别人问起也能立刻回答。

软件源原理上和电脑操作系统很像，都是“更新索引、下载安装、验证依赖”的流程，更基础的概念可参考 jsjwlmst 中关于软件分层的内容。理解软件包机制之后，你会发现 OpenWrt 的可扩展性都建立在这套机制之上，所有进阶玩法本质上都是装不同的软件包。

版本与本书的关系

最后说明本书各章节对应的版本情况。本书以 25.12 系列为主要参照，因为它是最新的稳定系列；同时会标注 24.10 及更早版本的操作差异，照顾手里设备停留在旧版本的读者。如果你刷的是更旧的 23.05，绝大部分操作同样适用，只有包管理与个别防火墙细节需要留意版本差异。如果未来 OpenWrt 发布了 26.x 系列，本书的思路与方法仍然适用，具体命令以官方文档为准。技术书的价值在于思路与流程，命令细节总能查到，理解了原理就不用怕版本更替。把每章的核心概念吃透，任何版本你都能从容上手，这才是本书想教给你的东西，也是它与那些”某个版本的命令速查表“类文章的本质区别。

延伸阅读

• 下一章开始实际操作，从备份原厂固件讲起，所有命令都会给出版本适用范围。刷完系统后先更新补丁再配置，这个顺序很重要。
• 想深入理解软件包机制的读者，可在学完第 2 章后回读 jsjwlmst 中的相关章节。
• 命令行查看版本信息的操作可参考 ssh，登录之后一条命令就能看到完整信息。
• 对服务器版本管理有兴趣的读者，bt2017 中也有类似概念的讨论。