linux的Boa服务器

Boa是一种非常小巧的Web服务器，其可执行代码只有大约60KB左右。作为一种单任务Web服务器，Boa只能依次 完成用户的请求，而不会fork出新的进程来处理并发连接请求。但Boa支持CGI，能够为CGI程序fork出一个进程来执行。Boa的设计目标是速度 和安全。 下面给大家介绍一下Boa服务器移植的具体操作步骤，希望能够有帮助。 环境 主机：ubuntu8.10 交叉工具链：gcc-3.4.5-glibc-2.3.6 目标：s3c2410开发板 结合网上一些文档，整理了一个比较完整的文档。 1.下载Boa源码 下载地址: http://www.boa.org/ 最新发行版本： 0.94.13 下载boa-0.94.13.tar.gz 解压：# tar xzf boa-0.94.13.tar.gz 2.安装需要工具bison，flex sudo apt-get install bison flex 否则会出现如下错误 make: yacc：命令未找到 make: *** [y.tab.c] 错误 127 make: lex：命令未找到 make: *** [lex.yy.c] 错误 127 3.修改文件 (1)修改 src/compat.h 找到 #define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff 修改成 #define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff 否则会出现错误： util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: *** [util.o] 错误 1 (2)修改 src/log.c 注释掉 if (dup2(error_log, STDERR_FILENO) == -1) { DIE("unable to dup2 the error log")} 为： /*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 deor (3)修改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 否则会出现错误：boa.c:211 - getpwuid: No such file or directory 注释掉下面语句： if (setuid(0) != -1) { DIE(”icky Linux kernel bug!”)} 为 #if 0 if (setuid(0) != -1) { DIE(”icky Linux kernel bug!”)} #endif 否则会出现问题：boa.c:228 - icky Linux kernel bug!: No such file or directory 4、生成Makefile文件 执行： #cd boa-0.94.13/src #./configure 5、修改Makefile cd src vim Makefile 修改CC = gcc 为 CC = arm-softfloat-linux-gnu-gcc 修改CPP = gcc -E 为 CC = arm-softfloat-linux-gnu-gcc -E 6、编译 make ls -l boa -rwxr-xr-x 1 david david 189223 2009-05-31 13:44 boa 然后为生成的二进制文件boa瘦身 arm-softfloat-linux-gnu-strip boa ls -l boa -rwxr-xr-x 1 david david 61052 2009-05-31 13:51 boa 可以发现boa的大小前后差距很大这为我们节省了很大的空间 7、Boa的配置 这一步的工作也在电脑主机上完成。 在boa-0.94.13目录下已有一个示例boa.conf，可以在其基础上进行修改。如下： #vi boa.conf (1)Group的修改 修改Group nogroup 为Group 0 (2)user的修改 修改User nobody 为User 0 (3)Alias的修改 修改Alias /cgi-bin/ /usr/lib/cgi-bin/ 为Alias /cgi-bin/ /www/cgi-bin/ (5)DoucmentRoot的修改 修改DoucmentRoot /var/www 为DoucmentRoot /www (6)ServerName的设置 修改#ServerName www.your.org.here 为ServerName www.your.org.here 否则会出现错误“gethostbyname::No such file or directory” (7)AccessLog修改 修改AccessLog /var/log/boa/access_log 为#AccessLog /var/log/boa/access_log 否则会出现错误提示：“unable to dup2 the error log: Bad file deor” (8)以下配置和boa.conf的配置有关，都是在ARM根文件系统中创建 以下步骤在开发板上进行： 创建目录/etc/boa并且把boa 和 boa.conf拷贝到这个目录下 mkdir /etc/boa 创建HTML文档的主目录/www mkdir /www 创建CGI脚本所在录 /www/cgi-bin mkdir /www/cgi-bin 以下步骤在ubuntu下进行： 将boa.conf拷贝到开发板根文件系统的/etc/boa下 #cp boa.conf /source/rootfs/etc/boa 将boa拷贝到开发板根文件系统的/etc/boa下 #cp src/boa /source/rootfs/etc/boa 将ubuntu下/etc/mime.types拷贝到开发板根文件系统的/etc下 #cp /etc/mime.types /source/rootfs/etc 将你的主页index.html拷贝到www目录下 8、测试 打开一个浏览器输入开发板ip看看效果 OK

其实也就是构建个WebServer服务器，只不过这里是以boa+cgic来实现的。 移植boa软件 所用的软件为boa-0.94.13.tar.gz，先进行解压到当前目录 。 移植cgic库 ，cgic205.tar.gz，修改Makefile ，修改为如下（红色的地方为改过的）；

第一步完成Boa程序的移植。从www.boa.org下载Boa源码，当前最新版本为0.94.13，将其解压并进入源码目录的src子目录

# tar xzf boa-0.94.13.tar.gz

# cd boa-0.94.13/src

生成Makefile文件

# ./configure

修改Makefile文件，找到CC=gcc，将其改成CC = arm-linux-gcc，再找到CPP = gcc –E，将其改成CPP = arm-linux-gcc –E，并保存退出。

然后运行make进行编译，得到的可执行程序为boa，将调试信息剥去，得到的最后程序只有约60KB大小。

# make

# arm-linux-strip boa

第二步完成Boa的配置，使其能够支持CGI程序的执行。Boa需要在/etc目录下建立一个boa目录，里面放入Boa的主要配置文件boa.conf。在Boa源码目录下已有一个示例boa.conf，可以在其基础上进行修改，下面解释一下该文件的含义：

#监听的端口号，缺省都是80，一般无需修改

Port 80

# bind调用的IP地址，一般注释掉，表明绑定到INADDR_ANY，通配于服务器的所有IP地址

#Listen 192.68.0.5

#作为哪个用户运行，即它拥有该用户的权限，一般都是nobody，需要/etc/passwd中有

#nobody用户

User nobody

#作为哪个用户组运行，即它拥有该用户组的权限，一般都是nogroup，需要在/etc/group文

#件中有nogroup组

Group nogroup

#当服务器发生问题时发送报警的email地址，目前未用，注释掉

#ServerAdmin root@localhost

#错误日志文件。如果没有以/开始，则表示从服务器的根路径开始。如果不需要错误日志，则用#/dev/null。在下面设置时，注意一定要建立/var/log/boa目录

ErrorLog /var/log/boa/error_log

#访问日志文件。如果没有以/开始，则表示从服务器的根路径开始。如果不需要错误日志，则用#/dev/null或直接注释掉。在下面设置时，注意一定要建立/var/log/boa目录

#AccessLog /var/log/boa/access_log

#是否使用本地时间。如果没有注释掉，则使用本地时间。注释掉则使用UTC时间

#UseLocaltime

#是否记录CGI运行信息，如果没有注释掉，则记录，注释掉则不记录

#VerboseCGILogs

#服务器名字

ServerName www.hyesco.com

#是否启动虚拟主机功能，即设备可以有多个网络接口，每个接口都可以拥有一个虚拟的Web服

#务器。一般注释掉，即不需要启动

#VirtualHost

#非常重要，HTML文档的主目录。如果没有以/开始，则表示从服务器的根路径开始。

DocumentRoot /var/www

#如果收到一个用户请求的话，在用户主目录后再增加的目录名

UserDir public_html

#HTML目录索引的文件名，也是没有用户只指明访问目录时返回的文件名

DirectoryIndex index.html

#当HTML目录没有索引文件时，用户只指明访问目录时，boa会调用该程序生成索引文件然后

#返回给用户，因为该过程比较慢最好不执行，可以注释掉或者给每个HTML目录加上#DirectoryIndex指明的文件

#DirectoryMaker /usr/lib/boa/boa_indexer

#如果DirectoryIndex不存在，并且DirectoryMaker被注释，那么就用Boa自带的索引

#生成程序来生成目录的索引文件并输出到下面目录，该目录必须是Boa能读写

# DirectoryCache /var/spool/boa/dircache

#一个连接所允许的HTTP持续作用请求最大数目，注释或设为0都将关闭HTTP持续作用

KeepAliveMax 1000

#HTTP持续作用中服务器在两次请求之间等待的时间数，以秒为单位，超时将关闭连接

KeepAliveTimeout 10

#指明mime.types文件位置。如果没有以/开始，则表示从服务器的根路径开始。可以注释掉

#避免使用mime.types文件，此时需要用AddType在本文件里指明

MimeTypes /etc/mime.types

#文件扩展名没有或未知的话，使用的缺省MIME类型

DefaultType text/plain

#提供CGI程序的PATH环境变量值

CGIPath /bin:/usr/bin:/usr/local/bin

#将文件扩展名和MIME类型关联起来，和mime.types文件作用一样。如果用mime.types

#文件，则注释掉，如果不使用mime.types文件，则必须使用

#AddType application/x-httpd-cgi cgi

#指明文档重定向路径

#Redirect /bar http://elsewhere/feh/bar

#为路径加上别名

Alias /doc /usr/doc

#非常重要，指明CGI脚本的虚拟路径对应的实际路径。一般所有的CGI脚本都要放在实际路径

#里，用户访问执行时输入站点+虚拟路径+CGI脚本名

ScriptAlias /cgi-bin/ /var/www/cgi-bin/

用户可以根据自己需要，对boa.conf进行修改，但必须要保证其他的辅助文件和设置必须和boa.conf里的配置相符，不然Boa就不能正常工作。 在上面的例子中，我们还需要创建日志文件所在目录/var/log/boa，创建HTML文档的主目录/var/www，将mime.types文件拷贝 到/etc目录，创建CGI脚本所在目录/var/www/cgi-bin/。mime.types文件用来指明不同文件扩展名对应的MIME类型，一般 可以直接从Linux主机上拷贝一个，大部分也都是在主机的/etc目录下。

---