boa webserver的配置及相关问题

一、简介

boa是一个嵌入式web服务器，小巧而且高效，是可以unix或linux下使用，支持cgi的、非常适合于嵌入式系统的单任务的http服务器，源代码开放、性能高。

二、下载

源码下载可以到：http://www.boa.org 进行下载。下载后可得boa的压缩包(boa-0.94.13.tar.gz)

三、配置和使用

1. 解压、进入解压后的目录中的src，执行./configure,生成对应的Makefile文件。具体的命令如下：

$ tar zxvf  boa-0.94.13.tar.gz         #(解压)
$ cd ./boa-0.94.13/src                 #(进入到src)
$ ./configure                          #(配置)

2. 在执行make时会有如下错误，因此需要在编译前修改一些内容，具体如下：

编译一个linux下的C系统，包含词法和语法分析模块，Linux上用bison和flex。yacc是一个文法分析器的生成器,bison即是yacc的GNU版本.Lex和YACC是用于构造词法分析机和语法解释器的工具，利用Lex和YACC你可以轻松的构造一个语法解释器。开始make：

错误1：
解决方法：#sudo apt-get install bison

错误2：
解决方法：#sudo apt-get install flex

错误3:此时可以修改一些内容
a. 修改boa-0.94.13/src/compat.h文件（去掉##）
define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff 改为 define TIMEZONE_OFFSET(foo) foo->tm_gmtoff
b. 修改boa-0.94.13/boa.conf文件。打开#gedit boa-0.94.13/boa.conf
User nobody 改为 User 0 Group nogroup 改为 Group 0 ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ 改为 ScriptAlias /cgi-bin/ /var/www/cgi-bin/
c. 修改 src/log.c（注释掉）

把if (dup2(error_log, STDERR_FILENO) == -1) {DIE("unable to dup2 the error log");} 注释掉
否则会出现 log.c:73 - unable to dup2 the error log: Bad file descriptor

d.创建相应的文件夹及文件
1、在/etc下创建boa文件夹，并添加文件boa.conf

$ cd /etc
$ mkdir boa 
$ cp boa-0.94.13/boa.conf /etc/boa

2、在/var/log添加boa文件夹及文件

$ cd /var/log
$ mkdir boa 
$ cd boa 
$ touch access_log
$ touch error_log

d.在/var中添加www文件夹并增加相应的文件,index.html文件也要存放在/var/www这个文件夹下。

$ cd /var 
$ mkdir www
$ cd www
$ mkdir  cgi-bin

四、编译与执行

$ cd boa-0.94.13/src		#(切到boa项目文件夹中)
$ make clean
$ make						#(编译) 
$ ./boa						#(执行)

五、测试

打开浏览器，输入当前对应的IP，就可以访问，自己的index.html主页了。

六、关于boa.conf文件的详解：

Port：boa服务器监听的端口，默认的端口是80。如果端口小于1024，则必须是 root用户启动服务器。
Listen：绑定的ip地址。不使用这个参数时，将绑定所有的地址。
User：连接到服务器的客户端的身份，可以是用户名或UID。
Group：连接到服务器的客户端的组，可以是组名或GID。
ServerAdmin：服务器出故障时要通知的邮箱地址。
ErrorLog：指定错误日志文件。如果路径没有以"/“开始，则相对于ServerRoot路径。没有配置时默 认的文件是/dev/stderr。若不想记录日志，指定文件为/dev/null。
AccessLog：设置存取日志文件，与ErrorLog类似。
UseLocaltime：设置使用本地时间，使用UTC时注释这个参数。这个参数没有值。
VerboseCGILogs：在错误日志文件中记录CGI启动和停止时间，若不记录，注释这个参数。这个参数没有值。
ServerName：指定服务器的名称，当客户端使用gethostname + gethostbyname时返回给客户端。
VirtualHost：虚拟主机开关。使用此参数，则会在DocumentRoot设定的
目录添加一个ip地址作为新的DocumentRoot来
处理客户端的请求。如DocumentRoot设置为/var/www，则http://localhost/转换 成/var/www/127.0.0.1/，若注释此参数，则为/var/www/。
DocumentRoot：HTML文件的根目录（也就是网站的目录）。
UserDir：指定用户目录。
DirectoryIndex：指定预生成目录信息的文件，注释此变量将使用DirectoryMaker变量。这个变量也就是设置默认主页的文件名。
DirectoryMaker：指定用于生成目录的程序，注释此变量将不允许列目录。
DirectoryCache：当DirectoryIndex文件不存在，而DirecotryMaker又被注释掉时，将列出这个参数指定目录给客户端。
KeepAliveMax：每个连接允许的请求数量。如果将此值设为” 0 "，将不限制请求的数目。
KeepAliveTimeOut：在关闭持久连接前等待下一个请求的秒数。（秒）。
MimeTypes：设置包含mimetypes信息的文件，一般是/etc/mime.types。
DefaultType：默认的mimetype类型，一般是text/html。
CGIPath：相当于给CGI程序使用的$PATH变量。
SinglePostLimit：一次POST允许最大的字节数，默认是1MB。
AddType: 增加MimeType没有指定的类型，例: AddType type extension [extension …]。要使用cgi，必须添加cgi类型：AddType application/x-httpd-cgi cgi
Redirect：重定向文件。
Aliases：指定路径的别名。
ScriptAlias：指定脚本路径的虚拟路径。