一. boa简介
boa是一个嵌入式web服务器,小巧而且高效,是可以unix或linux下使用,支持cgi的、非常适合于嵌入式系统的单任务的http服务器,源代码开放、性能高。
二. boa源码
源码下载可以到:http://www.boa.org/ 进行下载。下载后可得boa的压缩包(boa-0.94.13.tar.gz)
三. boa配置和使用
1. 有了boa的压缩包之后,就可以开始使用了,首先是从解压缩包开始,而后进入解压后的目录中的src,执行./configure,生成对应的Makefile文件。具体的命令如下:
#tar zxvf boa-0.94.13.tar.gz (解压)
#cd ./boa-0.94.13/src (进入到src)
#./configure (配置)
2. 在执行make编译之前,首先要做如下的修改,要不然会报错。
a. 修改boa-0.94.13/src/compat.h。打开#gedit 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/
关于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:指定脚本路径的虚拟路径。
c.创建相应的文件夹及文件
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
index.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>我的第一个样式页面</title> </head> <body> <!-- 目录 --> <ul class="navbar"> <li><a href="index.html">首页</a> <li><a href="musings.html">连接1</a> <li><a href="town.html">连接2</a> <li><a href="links.html">连接3</a> </ul> <!-- 主要内容 --> <h1>我的第一个样式页面</h1> <p>welcome to milesight. <p>hello world. <p>这只是个例子, 好象没什么好写. <!-- 签名和日期 --> <address>2014年5月19日制作</address> </body> </html>四.boa编译与执行
#cd boa-0.94.13/src (切到boa项目文件夹中)
#make clean
#make (编译)
#./bao (执行)
五.测试
打开浏览器,输入当前对应的IP,就可以访问,自己的index.html主页了。