Openwrt常用软件模块之uHTTPd

Openwrt常用软件模块之uHTTPd

uHTTPd概述

uHTTPd 是 OpenWrt/LuCI 开发者从零开始编写的 Web 服务器,目的是成为优秀稳定 的、适合嵌入式设备的轻量级任务的 HTTP 服务器,并且和 OpenWrt 配置框架非常好地 集成在一起。它是管理 OpenWrt 的默认的 Web 服务器,还提供了现代 Web 服务器所有的 功能 。

  • uHTTPd支持TSL(SSL)、CGI和 Lua,是单线程运行但支持多个实例,例如多个监听端口,每一个都有自己的根目录和其他特性
  • 使用TLS(HTTPS 支持)时需要安装uhttpd-mod-tls模块
  • 和许多其他的Web服务器一样,它也支持在进程内运行Lua,这样可以加速Lua CGI脚本。注意这依赖于Lua,默认情况下没有这样配置

安装

  • uHTTPd是OpenWrt 的标准HTTP服务器,但是它默认并不会安装在OpenWrt发行版的系统文件中。因为默认的发行版并不包含 Web 用户管理界面,通常 uHTTPd 会作为 Web 接口 LuCI 的依赖模块自动安装
  • 如果需要单独安装,可以通过以下命令来实现:
opkg update
 
opkg install uhttpd

配置

  • uHTTPd也提供一个初始化脚本/etc/init.d/uhttpd来启动或停止服务,或者在系统启动时自动启动

  • uHTTPd的配置和OpenWrt用户接口系统UCI完全集成在一起。UCI配置文件是/ etc/config/uhttpd

  • 由于uHTTPd直接依赖这文件,因此当UCI设置提交时没有第二个配置文件需要重新生成。uHTTPd是UCI系统配置的一部分

配置文件内容

  • uHTTPd有两个配置节定义,类型uHTTPd包含了通用的服务器设置
  • cert部分:定义了加密连接SSL证书的默认值,在局域网中一般不使用,因此不再介绍
  • 配置文件中必须包含文档根目录(home)和HTTP监听端口
名 称 类型 含 义
listen_http 字符串 定义服务器的 IP 和端口。指所监听的非加密的地址和端口。如 果仅给出端口号,将同时服务于 IPv4 和 IPv6 请求。使用 0.0.0.0:80 仅绑定在 IPv4 接口,使用[::]:80 仅绑定 IPv6
home 目录路径 定义服务器的文档根目录
max_requests 整型数字 最大的并行请求数,如果大于这个值,后续的请求将进入排队队 列中
cert 文件路径 用于 HTTPS 连接的 ASN.1/DER 证书。在提供 HTTS 连接时必须 提供
key 文件路径 用于 HTTPS 连接的 ASN.1/DER 私钥。在提供 HTTPS 连接时必 须提供
cgi_prefix 字符串 定义 CGI 脚本的相对于根目录的前缀。如果没有该选项,CGI 功能将不支持
script_timeout 整型数字 Lua 或 CGI 请求的最大等待时间秒值。如果没有输出产生,则超 时后执行就结束了
network_timeout 整型数字 网络活动的最大等待时间,如果指定的秒数内没有网络活动发 生,则程序终止,连接关闭
tcp_keepalive 整型数字 tcp 心跳检测时间间隔,发现对端已不存在时则关闭连接。设置 为 0 则关闭 tcp 心跳检测
realm 字符串 基本认证的域值,默认为主机名,是当客户端进行基本认证的提 示内容
config 文件路径 用于基本认证的配置文件
config uhttpd main
        list listen_http        0.0.0.0:80
        list listen_http        [::]:80
        list listen_https       0.0.0.0:443
        list listen_https       [::]:443
        option redirect_https   1
        option home             /www
        option rfc1918_filter 1
        option max_requests 3
        option max_connections 100
        option cert             /etc/uhttpd.crt
        option key              /etc/uhttpd.key
        option cgi_prefix       /cgi-bin
        list lua_prefix         "/cgi-bin/luci=/usr/lib/lua/luci/sgi/uhttpd.lua"
        option script_timeout   60
        option network_timeout  30
        option http_keepalive   20
        option tcp_keepalive    1
        option config   /etc/httpd.conf
config cert defaults
        option days             730
        option key_type         rsa
        option bits             2048
        option ec_curve         P-256
        option country          ZZ
        option state            Somewhere
        option location         Unknown
        option commonname       'OpenWrt'

你可能感兴趣的:(OpenWrt,openwrt,uHTTPd)