mini-httpd模块研究报告.doc

mini-httpd模块使用指南1. 前言31.1 关于本文档31.2 背景知识31.3 术语32. mini-httpd模块介绍33. 关于mini-httpd开源组件33.1 mini-httpd开源组件介绍33.2 mini-httpd开源组件编译及安装44. mini-httpd程序使用44.1 关于mini-httpd程序44.2 命令参数说明（或者配置文件说明）44.3 mini-httpd程序使用实例44.3 其他45. mini-httpd模块使用场景5HistoryDateVersionChanges2011-11-30Draft A完成第一稿1. 前言1.1 关于本文档 本文档描述mini-httpd模块的基本使用方法，为开发人员做开发时提供必要的说明。1.2 背景知识Web服务器可以解析(handles)HTTP协议。当Web服务器接收到一个HTTP请求(request)，会返回一个HTTP响应(response)，例如送回一个HTML页面。为了处理一个请求(request)，Web服务器可以响应(response)一个静态页面或图片，进行页面跳转(redirect)，或者把动态响应(dynamic response)的产生委托(delegate)给一些其它的程序例如CGI脚本，JSP(JavaServer Pages)脚本，servlets，ASP(Active Server Pages)脚本，服务器端(server-side)JavaScript，或者一些其它的服务器端(server-side)技术。无论它们(译者注：脚本)的目的如何，这些服务器端(server-side)的程序通常产生一个HTML的响应(response)来让浏览器可以浏览。 Web服务器的代理模型(delegation model)非常简单。当一个请求(request)被送到Web服务器里来时，它只单纯的把请求(request)传递给可以很好的处理请求(request)的程序(译者注：服务器端脚本)。Web服务器仅仅提供一个可以执行服务器端(server-side)程序和返回(程序所产生的)响应(response)的环境，而不会超出职能范围。服务器端(server-side)程序通常具有事务处理(transaction processing)，数据库连接(database connectivity)和消息(messaging)等功能。 虽然Web服务器不支持事务处理或数据库连接池，但它可以配置(employ)各种策略(strategies)来实现容错性(fault tolerance)和可扩展性(scalability)，例如负载平衡(load balancing)，缓冲(caching)。集群特征(clusteringfeatures)经常被误认为仅仅是应用程序服务器专有的特征。1.3 术语HTTP Hypertext Transfer Protocol 超文本传输协议IP Internet Protocol 互联网协议TCP Transmission Control Protocol 传输控制协议CGI Common Gageway Interface HTTP服务器与程序进行交互的具，其程序须运行在网络服务器上。2. mini-httpd模块介绍mini-httpd 是一个奉行极简主义的Web Server，重在服务器性能和高度安全性，并使用尽可能少的系统资源。特点：1. HTTP/1.1 compliant keep-connection support.2. Virtual hosting.3. Recording all successful requests in the common Apache-style log-file format.4. The ability to run in a chroot(2) sandbox.5. Dropping all super-user privileges after acquiring the listening socket.6. mini-httpd is configured entirely through the command line. There is no config file.mini-httpd 只提供服务硬盘静态页面功能，不支持CGI和其它动态页面生成功能.mini-httpd的官方网站：/目前公司的FR612等项目中用到了httpd模块。3. 关于mini-httpd开源组件3.1 mini-httpd开源组件介绍Mini_httpd是一个小型的HTTP服务器。开源，它的性能不强，但是它非常适合于中小访问量的站点。Mini_httpd和thttpd都是ACME Labs 开发的软件，功能没有thttpd强。功能及特点：它实现了HTTP服务器的所有的基本功能，包括： 支持CGI功能 支持基本的验证功能 支持安全 . 上级目录功能 支持通用的MIME类型 支持目录列表功能 支持使用 index.html, index.htm, index.cgi 作为首页 支持多个根目录的虚拟主机 支持标准日志记录 支持自定义错误页 Trailing-slash redirection 它可以配置成SSL/HTTPS和 IPv6.3.2 mini-httpd开源组件编译及安装3.2.1 编译安装mini-httpd源码包的编译安装如下：在shell下输入wget /software/mini_httpd/mini_httpd-1.19.tar.gztar zxvf mini_httpd-1.19.tar.gzcd mini_httpd-1.19 进入解压之后的文件夹make 编译套件make install 安装套件/usr/local/sbin/mini_httpd V 查看版本信息mkdir /mini 建立存放网页的资料夹mkdir /mini/wwwrootmkdir /mini/wwwroot/cgi-bin文件大小编译之后生成的可执行文件mini_httpd为50756字节。4. mini-httpd程序使用4.1 关于mini-httpd程序启动web server:在shell下输入/usr/local/sbin/mini_httpd -C /xxx/mini_httpd-1.19/mini/mini_httpd.conf4.2 命令参数说明（或者配置文件说明）配置文件说明：在/mini_httpd-1.19/mini/目录下写一个配置文件：mini_httpd.conf内容如下所示：port=8080 /定义端口号dir=/home/XXX/mini_httpd-1.19 /mini/wwwroot /指定页面路径 cgipat=cgi-bin/* /指定cgi程序路径user=nobody /指定用户pidfile=/home/XXX/mini_httpd-1.19 /mini/mini_httpd.pid logfile=/home/XXX/mini_httpd-1.19 /mini/mini_httpd.log /指定日志文件存放路径4.3 mini-httpd程序使用实例假设你的web server IP是在浏览器内输入:8080那么就可以看到网页内容了。5. mini-httpd模块使用场景客户端发送给mini-httpd服务器的HTTP报文格式如下：GET /?dev=00:0C:29:76:AD:9E HTTP/1.1Host: :8668User-Agent: Mozilla/5.0 (Windows NT 5.1; rv:5.0) Gecko/20100101 Firefox/5.0Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8