【调试笔记-20240604-Linux-为 OpenWrt-23.05 添加自己的 feed 软件包】

调试笔记-系列文章目录

调试笔记-20240604-Linux-为 OpenWrt-23.05 添加自己的 feed 软件包

文章目录

• 调试笔记-系列文章目录
• • 调试笔记-20240604-Linux-为 OpenWrt-23.05 添加自己的 feed 软件包
  • 前言
  • 一、调试环境
  • • 操作系统：Ubuntu 22.04.4 LTS
    • 编译环境
    • 调试目标
    • 二、调试步骤
    • • 预置条件
      • 安装 OpenWrt 编译工具
      • • 打开 PuTTY 终端连接开发主机
        • 安装编译工具
        • 准备 openwrt 构建系统
        • • 下载 openwrt 构建系统
          • 配置 openwrt 编译选项
          • 方法一：加入已有的 feed 目录中
          • 方法二：添加自己的 feed 目录
          • 构建新版本 luci-app-nginx 软件包
          • 运行新版本 luci-app-nginx 软件
          • 三、应用场景
          • • 将自己的开发的软件加入 feeds 列表中
            • 四、参考资料
            • 总结

              ---

              前言

              本文记录在 Linux 环境下用 OpenWrt-23.05 SDK 添加自己的 feed 软件包的步骤。

              实验使用的电脑如下：

              CPU：

              Intel(R) Core(TM) i5-6600K CPU @ 3.50GHz

              操作系统：

              Ubuntu 22.04.4 LTS

              ---

              一、调试环境

              ---

              操作系统：Ubuntu 22.04.4 LTS

              操作系统详细信息如下：

              Kernel                : Linux 6.5.0-35-generic (x86_64)Version                : #35~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Tue May  7 09:00:52 UTC 2C Library                : GNU C Library / (Ubuntu GLIBC 2.35-0ubuntu3.7) 2.35Distribution                : Ubuntu 22.04.4 LTS

              ---

              编译环境

              • Windows 工作主机通过 PuTTY 远程连接 Linux 开发主机，Linux 开发主机安装 Ubuntu 22.04 LTS 发行版本

                参考【安装笔记-20240519-Windows-安装测试 PuTTY】

                ---

                调试目标

                将已有的软件包加入 feed 中编译生成能在 OpenWrt-23.05 固件上运行的最新版本软件包。

                ---

                二、调试步骤

                预置条件

                1、参考【安装笔记-20240519-Windows-安装测试 PuTTY】准备好 Ubuntu 22.04 LTS 工作环境

                2、下载 OpenWrt-23.05 SDK

                下载链接：openwrt-sdk-23.05.3-x86-64_gcc-12.3.0_musl.Linux-x86_64.tar.xz

                安装 OpenWrt 编译工具

                参考 Build system setup

                打开 PuTTY 终端连接开发主机

                • 在 Windows 点击 PuTTY 图标，连接开发主机，输入用户名和密码

                  安装编译工具

                  • 在 PuTTY 窗口执行以下命令：

                    sudo apt updatesudo apt install build-essential clang flex bison g++ gawksudo apt install gettext git libncurses-dev libssl-devsudo apt install sudo apt install python3-distutils rsync unzip zlib1g-dev file wget

                    ---

                    准备 openwrt 构建系统

                    下载 openwrt 构建系统

                    • 进入工作目标并下载 openwrt 构建系统，执行以下命令：

                      cd wks/openwrtwget https://downloads.openwrt.org/releases/23.05.3/targets/x86/64/openwrt-sdk-23.05.3-x86-64_gcc-12.3.0_musl.Linux-x86_64.tar.xztar Jvxf openwrt-sdk-23.05.3-x86-64_gcc-12.3.0_musl.Linux-x86_64.tar.xz

                      配置 openwrt 编译选项

                      • 复制配置文件到 openwrt 构建系统目录，执行以下命令：

                        cd openwrt-sdk-23.05.3-x86-64_gcc-12.3.0_musl.Linux-x86_64cp -f feeds.conf.default feeds.conf

                        • 更新软件包信息，执行以下命令：

                          ./scripts/feeds update -a

                          方法一：加入已有的 feed 目录中

                          • 复制 luci-app-nginx/ 目录到 feeds/luci/applications/ 目录中

                            cp -af ~/wks/github/luci-app-nginx ./feeds/luci/applications/

                            • 更新软件包信息，执行以下命令：

                              ./scripts/feeds update -a

                              ./scripts/feeds install luci-app-nginx

                              方法二：添加自己的 feed 目录

                              • 在 feeds.conf 文件中添加 mypackages 目录，内容如下：

                                src-git-full base https://git.openwrt.org/openwrt/openwrt.git;openwrt-23.05src-git packages https://git.openwrt.org/feed/packages.git^063b2393cbc3e5aab9d2b40b2911cab1c3967c59src-git luci https://git.openwrt.org/project/luci.git^b07cf9dcfc37e021e5619a41c847e63afbd5d34asrc-git routing https://git.openwrt.org/feed/routing.git^648753932d5a7deff7f2bdb33c000018a709ad84src-git telephony https://git.openwrt.org/feed/telephony.git^86af194d03592121f5321474ec9918dd109d3057src-link mypackages /home/hue/wks/openwrt/mypackages

                                • 更新软件包信息，执行以下命令：

                                  ./scripts/feeds update mypackages./scripts/feeds install -a -p mypackages

                                  构建新版本 luci-app-nginx 软件包

                                  • 执行以下命令，开始编译：

                                    make package/luci-app-nginx/compile V=99

                                    最后，成功编译，画面如下：

                                    ---

                                    运行新版本 luci-app-nginx 软件

                                    • 将生成的软件包文件上传到 QEMU 目标主机的 OpenWrt 系统中，运行以下命令：

                                    • opkg install luci-app-nginx_20230323_all.ipk

                                      系统提示 nginx 软件包未安装，执行以下命令：

                                      opkg updateopke install nginx

                                      继续安装 luci-app-nginx 软件包，执行以下命令：

                                      opkg install luci-app-nginx_20230323_all.ipk

                                      安装成功，在 Windows 主机上打开浏览器，查看是否添加了新的 LuCI 控制项：

                                      https://localhost:50443/cgi-bin/luci/admin/services/nginx/servers

                                      点击 nginx 的状态页，提示“资源不可用”，检查代码，发现获取状态是通过 /usr/bin/curl 命令实现的，当前 QEMU 目标主机的 OpenWrt 运行环境中没有 curl 命令，执行以下命令：

                                      opkg updateopkg install curl

                                      至此， luci-app-nginx 可以正常工作。

                                      ---

                                      三、应用场景

                                      将自己的开发的软件加入 feeds 列表中

                                      ---

                                      四、参考资料

                                      1、OpenWrt Feeds

                                      2、Including your package feed into OpenWrt build system

                                      ---

                                      总结

                                      本文介绍了在 Linux 环境下用 OpenWrt-23.05 SDK 添加自己的 feed 软件包的步骤，并指出过程中遇到的问题及解决方法。