1、下载Boa Webserver的源码
2、解压并编译Boa Webserver
$ tar zxvf boa-0.94.13.tar.gz
由于Boa Webserver的Makefile中没有install,我们只是进行编译,然后手动拷贝编译后的二进制文件到相应的文件目录中,因此在使用configure时无须指定位置。同时在make时,可能会出现不少错误,部分的错误处理方法可以参看<附录>:
$ cd boa-0.94.13/src/
$ ./configure
$ apt-get install bisonflex 否则会出现错误提示
修改 src/compat.h 两处地方 ,否则会出现错误提示
找到#define TIMEZONE_OFFSET(foo)foo##->tm_gmtoff
修改成#defineTIMEZONE_OFFSET(foo)(foo)->tm_gmtoff
若要修改配置文件boa.conf的存放位置,假设修改为"/web",则需修改defines.h:
#define SERVER_ROOT "/etc/boa"
修改成 #define SERVER_ROOT "/web"
$ make
3、配置Boa Web server环境
目录结构如下:
/web 存放html文件
/web/cgi-bin 存放cgi文件
/etc/boa 存放boa.conf
/bin 存放boa和boa_indexer
boa.conf 缺省配置:
User nobody
Group nogroup
DirectoryIndex index.html
CGIPath /bin:/usr/bin:/usr/local/bin
MimeTypes /etc/mime.types
ErrorLog/var/log/boa/error_log
AccessLog /var/log/boa/access_log
boa.conf 改动配置:
User 0
Group 0
#DirectoryMaker /usr/lib/boa/boa_indexer#注释掉,提高访问速度
#ErrorLog /var/log/boa/error_log #注释掉,关闭错误日志
#AccessLog /var/log/boa/access_log #注释掉,关闭访问日志
DocumentRoot/web #存放index.html
ScriptAlias /cgi-bin//web/cgi-bin/ #存放cgi文件
boa.conf 添加配置:
AddType text/plain txt
AddType image/gif gif
AddType text/html html
AddType text/html htm
AddType text/xml xml
AddType image/jpeg jpe
AddType image/jpeg jpeg
AddType image/jpeg jpg
AddType image/x-icon ico
编译后在boa-0.94.13/src/中有2个二进制文件,那就是我们需要的执行档,只需拷贝到/bin中,注意这里的操作权限:
$ sudo cp boa/boa-0.94.13/src/boa /bin
$ sudo cp boa-0.94.13/src/boa_indexer /bin
$ ls /bin/boa*
/bin/boa /bin/boa_indexer
BoaWebserver的配置文件是boa.conf。该文件需要被放置在/etc/boa目录下。同时我们需要对boa.conf稍做修改,注意一定是在/etc/boa下的boa.conf进行修改:
# sudo mkdir /etc/boa
# cp boa/boa-0.94.13/boa.conf /etc/boa/
# gedit /etc/boa/boa.conf
a)【可选配置】找到Group nogroup修改为Group 0; user nobody修改为user 用户名;
修改Group的参数为0是因为系统中没有nogroup组,如果你没有nobody用户,那么Usernobody也要做相应修改(修改成自己的用户名亦可)。其它采用默认设置。如有必要,可以参看<附录>中的参数说明。
b)【可选配置】servername www.your.org.here的注解去掉;
c)修改DocumentRoot后的路径为 /web,这个是文档的主目录;
d)找到ScriptAlias /cgi-bin/ /usr/lib/cgi-bin
修改为ScriptAlias /cgi-bin/ /web/cgi-bin
e)【可选配置】修改MimeTypes /etc/mime.types为MimeTypes/web/mime.types来指明mime.types文件位置。如果没有以/开始,则表示从服务器的根路径开始。可以注释掉,避免使用mime.types文件,此时需要用AddType在本文件里指明。
若开启日志功能(boa.conf的缺省配置)
建立日志目录【目录/var/log/boa是相关的日志文件保存目录。】:
# mkdir -p /var/log/boa
目录/web/用于保存HTML文档,而/web/cgi-bin用于保存CGI脚本。
4、测试
编写cgi测试代码:
int main(void)
{
printf("Content-type:text/html\n\n"); //这句一定要加上
printf(" Hello,world.");
exit(0);
}
$gcc -o test.cgi test.c
在测试之前,需要先运行Boa Webserver。
$sudo boa
注意这里使用的是root权限,如果是普通用户可能会有报错。
# ps -aux 查看boa进程已经启动
然后打开浏览器,输入http://192.168.1.194/cgi-bin/test.cgi就可以看到cgi测试效果。
当然192.168.1.194是本机地址。可以使用ifconfig命令查看ip地址。然后输入也可以达到一样的效果。
# ifconfig
常见错误
错误1:
request.c: In function ‘get_request’:
request.c:84: warning: pointer targets in passing argument 3 of‘accept’ differ in signedness
gcc -g -O2 -pipe -Wall -I. -c -o response.o response.c
gcc -g -O2 -pipe -Wall -I. -c -o select.o select.c
gcc -g -O2 -pipe -Wall -I. -c -o signals.o signals.c
gcc -g -O2 -pipe -Wall -I. -c -o util.o util.c
util.c:100:1: error: pasting "t" and "->" doesnot give a valid preprocessing token
make: *** [util.o] Error 1
解决办法:根据提示修改源码中的src/compat.h文件。
修改:#define TIMEZONE_OFFSET(foo)foo##->tm_gmtoff
为:#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff
错误2:
[17/Aug/2013:09:28:17 +0000] boa.c:226 - icky Linux kernel bug!: Success
解决办法:注释掉boa.c的226行
参考文档:http://blog.sina.com.cn/s/blog_488fd1fa0100t7ch.html