diff --git a/docs/openwrt.md b/docs/openwrt.md
index 90f0b06b..8761019e 100644
--- a/docs/openwrt.md
+++ b/docs/openwrt.md
@@ -12,6 +12,10 @@ OpenWrt 下载站镜像。
 
 OpenWrt 当前仍在维护的大版本可参考 <https://openwrt.org/mirrors#space_requirements>。
 
+!!! tip
+
+    从 OpenWrt 25.12 开始，包管理器由 `opkg` 改为 `apk` (Alpine Package Keeper) ，默认软件源的配置文件路径由 `/etc/opkg/distfeeds.conf` 改为 `/etc/apk/repositories.d/distfeeds.list` 。
+
 !!! tip
 
     访问 snapshots 与 RC 版本内容会重定向至反向代理，如果需要下载相关文件，务必使用 HTTPS，否则连接可能会被中断。
@@ -24,13 +28,27 @@ OpenWrt 当前仍在维护的大版本可参考 <https://openwrt.org/mirrors#spa
 
 一般情况下，下载来自 `downloads.openwrt.org` 的文件时，将 URL 中的这部分域名替换为 `mirrors.ustc.edu.cn/openwrt` 即可。
 
-如要使用本镜像作为 OpenWrt 系统 opkg 软件仓库，SSH 登录路由器编辑 `/etc/opkg/distfeeds.conf` 文件，同样按照上面的方法替换域名即可。可以使用如下命令操作：
+如要使用本镜像作为 OpenWrt 系统 `apk` 或 `opkg` 软件仓库，SSH 登录路由器编辑 `/etc/apk/repositories.d/distfeeds.list` 或 `/etc/opkg/distfeeds.conf` 文件，同样按照上面的方法替换域名即可。可以使用如下命令操作：
+
+!!! tip
+
+    对于 OpenWrt 25.12 及以上版本，需使用 `apk` 配置；对于 OpenWrt 24.10 及以下版本，需使用 `opkg` 配置。
+
+=== "`apk` 配置"
+
+    ```shell
+    sed -i 's/downloads.openwrt.org/mirrors.ustc.edu.cn\/openwrt/g' /etc/apk/repositories.d/distfeeds.list
+    ```
+
+    之后运行 `apk update` 更新软件索引，注意检查是否出现错误。
 
-```shell
-sed -i 's/downloads.openwrt.org/mirrors.ustc.edu.cn\/openwrt/g' /etc/opkg/distfeeds.conf
-```
+=== "`opkg` 配置"
 
-之后运行 `opkg update` 更新软件索引，注意检查是否出现错误。
+    ```shell
+    sed -i 's/downloads.openwrt.org/mirrors.ustc.edu.cn\/openwrt/g' /etc/opkg/distfeeds.conf
+    ```
+    
+    之后运行 `opkg update` 更新软件索引，注意检查是否出现错误。
 
 !!! tip