OpenWrt 23.05下uHTTPd加载自定义库路径运行CGI问题

在OpenWrt 23.05环境下使用uHTTPd服务器，通过浏览器访问http://192.168.1.1/cgi-bin/myapp.cgi运行无解释器的C++ CGI程序。该程序依赖仅存于/opt/lib/目录的自定义库libmgr.so：

• 直接将编译好的二进制文件拷贝到/www/cgi-bin时，因编译阶段添加了-Wl,-rpath=/opt/lib/参数，程序可正常运行；
• 通过.ipk包安装后，程序无法启动，ldd检测显示找不到libmgr.so，推测是打包过程中RPATH被剥离；
• 已尝试两种无效方案：在OpenWrt包Makefile中添加PKG_BUILD_FLAGS := no-strip，以及配置uHTTPd的cgi_env 'LD_LIBRARY_PATH=/opt/lib'。

1. 用patchelf在打包阶段强制保留/重置RPATH #

OpenWrt的默认打包流程可能会在strip环节移除RPATH，即使设置了no-strip也可能失效。可以在包的Makefile中添加构建钩子，用patchelf工具重新设置RPATH：

# 开发环境安装阶段重置RPATH
define Build/InstallDev
    $(INSTALL_DIR) $(1)/usr/bin
    $(INSTALL_BIN) $(PKG_BUILD_DIR)/myapp.cgi $(1)/usr/bin/
    patchelf --set-rpath /opt/lib $(1)/usr/bin/myapp.cgi
endef

# 目标设备安装阶段再次确保RPATH正确
define Package/myapp/install
    $(INSTALL_DIR) $(1)/www/cgi-bin
    $(INSTALL_BIN) $(PKG_BUILD_DIR)/myapp.cgi $(1)/www/cgi-bin/
    patchelf --set-rpath /opt/lib $(1)/www/cgi-bin/myapp.cgi
endef

注意：需要在OpenWrt SDK环境中安装patchelf，执行opkg install patchelf即可。

2. 修改uHTTPd启动脚本传递全局LD_LIBRARY_PATH #

部分版本的uHTTPd存在cgi_env变量无法正确传递给CGI子进程的问题，可直接修改uHTTPd的启动脚本，让所有子进程继承库路径：

• 编辑/etc/init.d/uhttpd，在start()函数的开头添加：

  export LD_LIBRARY_PATH=/opt/lib:$LD_LIBRARY_PATH
  

• 重启uHTTPd生效：/etc/init.d/uhttpd restart

3. 给依赖库创建系统库目录软链接 #

如果libmgr.so是你自己打包的ipk库，可在库的安装脚本中添加软链接到/usr/lib，让动态链接器直接找到它：

define Package/libmgr/install
    $(INSTALL_DIR) $(1)/opt/lib
    $(INSTALL_BIN) $(PKG_BUILD_DIR)/libmgr.so $(1)/opt/lib/
    # 创建软链接到系统默认库路径
    ln -sf /opt/lib/libmgr.so $(1)/usr/lib/libmgr.so
endef

安装ipk后，执行以下命令检查RPATH是否生效：

readelf -d /www/cgi-bin/myapp.cgi | grep RPATH

如果输出包含RPATH Library rpath: [/opt/lib]，说明设置成功；也可直接执行/www/cgi-bin/myapp.cgi测试程序是否能正常启动。

内容的提问来源于stack exchange，提问作者InfiniteStorm