一、下载Boa源码
下载地址: http://www.boa.org/， 或者http://sourceforge.net/：
boa-0.94.13.tar.gz，解压：# tar zxvf boa-0.94.13.tar.gz
二、编译#./configure# make可能出现的错误：1、Could not open boa.conf for reading. boa.conf的SERVERROOT路径指定不对，修改后重新make2、error: pasting "t" and "->" does not give a valid preprocessing token 修改 src/compat.h 找到 #define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
修改成
#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
# mkdir /etc/boa
# cp / boa-0.94.13/boa.conf /etc/boa/
修改boa.conf：
1、 Group的修改：修改 Group nogroup 为Group 0
由于在/etc/group文件中没有nogroup组，所以设成0。另外在/etc/passwd中有nobody用户，所以User nobody不用修改。视情况而定。
2、scriptAlias的修改：修改 scriptAlias /cgi-bin/ /usr/lib/cgi-bin/
为 scriptAlias /cgi-bin/ /var/www/cgi-bin/
3、ServerName的设置：修改 #ServerName www.your.org.here/
为 ServerName www.your.org.here/
注意：该项默认为未打开，执行Boa会异常退出，提示“gethostbyname::No such file or directory”,所以必须打开。其它默认设置即可。
# mkdir /var/log （注：redhat上已经存在，此步骤省略）
# mkdir /var/log/boa（创建日志文件目录）
# mkdir /var/www （创建HTML文档的主目录）（注：redhat上已经存在，此步骤省略）
可以将主机 /usr/share/doc/HTML/目录下的index.html文件和img目录复制到/var/www目录下；
将主机/etc目录下的mime.types文件放置到制作的根文件夹的/etc下；（注：redhat上已经存在，此步骤省略）
最后将boa-0.94.13下的boa可执行文件拷贝到/usr/local/bin下面。
四、执行
运行boa命令
#boa
在浏览器中输入本机的ip地址，若不知道则输入/sbin/ifconfig查看。
这时浏览器中就会出现/usr/share/doc/HTML/index.html的内容了。
五、移植到开发板
1、 配置操作完成之后，修改Makefile文件:
将:
CC = gcc
CPP = gcc -E
该为:
CC = arm-linux-gcc
CPP = arm-linux-gcc -E
make即可。
2、 拷贝PC上/etc/mime.types文件到开发板/etc目录下(或者将boa.conf文件中 MimeTypes /etc/mime.types 修改为: MimeTypes /dev/null )
六、常见错误
1>. 错误1: gethostbyname:: No such file or directory
解决办法: 修改boa.conf 去掉 ServerName www.your.org.here 前的注释符号(#)
2>. 错误1: util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: *** [util.o]
解决办法: 修改 src/compat.h
找到
#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
修改成
#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff
3>. 错误2: boa.c:211 - getpwuid: No such file or directory
解决办法: 修改src/boa.c
注释掉下面这段程序:
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}
即修改为:
#if 0
if (passwdbuf == NULL) {
DIE(”getpwuid”);
}
if (initgroups(passwdbuf->pw_name, passwdbuf->pw_gid) == -1) {
DIE(”initgroups”);
}
#endif
4>. 错误3: boa.c:228 - icky Linux kernel bug!: No such file or directory
解决办法: 修改src/boa.c
注释掉下面语句:
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
即修改为:
#if 0
if (setuid(0) != -1) {
DIE(”icky Linux kernel bug!”);
}
#endif
5>. 错误4: log.c:73 unable to dup2 the error log:bad file descriptor
解决方法:
方法1> 确定日志目录对与所有用户都具有可读/写的权限
方法2> 修改src/log.c (建议采用方法1)
注释掉
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
即修改为:
#if 0
if (dup2(error_log, STDERR_FILENO) == -1) {
DIE("unable to dup2 the error log");
}
#endif
附：
Web服务器boa配置文件参数说明
Port：boa服务器监听的端口，默认的端口是80。如果端口小于1024，则必须是root用户启动服务器。
Listen：绑定的ip地址。不使用这个参数时，将绑定所有的地址。
User：连接到服务器的客户端的身份，可以是用户名或UID。（nobody用户也有读权限）
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或者也可以使用/dev/null。
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：指定脚本路径的虚拟路径。