Boa服務(wù)器在A(yíng)RM+Linux上的移植

Boa是一種非常小巧的Web服務(wù)器，其可執(zhí)行代碼只有大約60KB左右。

作為一種單任務(wù)Web服務(wù)器，Boa只能依次完成用戶(hù)的請(qǐng)求，而不會(huì)fork出新的進(jìn)程來(lái)處理并發(fā)連接請(qǐng)求。但Boa支持CGI，能夠?yàn)镃GI程序fork出一個(gè)進(jìn)程來(lái)執(zhí)行。Boa的設(shè)計(jì)目標(biāo)是速度和安全。

二、移植環(huán)境

（1）源碼的獲取

Boa的源碼可以從網(wǎng)站www.boa.org獲取

（2）Boa移植平臺(tái)

nPC機(jī)（RedHat9.0操作系統(tǒng)）

n交叉編譯工具,arm-linux,最好是2.9的

三、移植步驟

（1）解壓源碼$ tar xzvf boa-0.94-14.tar.gz

（2）$cd boa-0.94-14 目錄下，進(jìn)入src目錄中

（3） ./configure 配置安裝文件，自動(dòng)根據(jù)Makefile.in 生成Makefile文件

（4） 生成的Makefile文件是針對(duì)X86平臺(tái)的，為了生成能夠在ARM上運(yùn)行的boa，

需要修改Makefile文件,用vi或則gedit修改Makefile文件中的CC = CC ；CPP = CC –E修改為自己的交叉編譯器如：

CC = arm-linux-gcc；和CC = arm-linux-gcc –E(這是在交叉編譯器環(huán)境變量配置好的情況下，如果沒(méi)有配置好，需要把路徑填寫(xiě)完整)

（5）然后執(zhí)行make，生成可執(zhí)行程序boa，就在src目錄下面，后面就要用到這個(gè)可執(zhí)行程序。

三、Boa.conf文件分析

在Boa源碼目錄下已有一個(gè)示例boa.conf，可以在其基礎(chǔ)上進(jìn)行修改，下面解釋一下該文件的含義：

#監(jiān)聽(tīng)的端口號(hào)，缺省都是80，一般無(wú)需修改注意，如果你你的httpd服務(wù)時(shí)已經(jīng)開(kāi)啟，那么你必須關(guān)掉或者重新設(shè)定端口號(hào)，當(dāng)你修改了模式http端口那么訪(fǎng)問(wèn)的時(shí)候要加上端口號(hào)，如http：//192.168.0.2:1100

Port 80

# bind調(diào)用的IP地址，一般注釋掉，表明綁定到INADDR_ANY，通配于服務(wù)器的所有IP地址，

#Listen 192.68.0.5

#作為哪個(gè)用戶(hù)運(yùn)行，即它擁有該用戶(hù)的權(quán)限，一般都是nobody，需

要 /etc/passwd中有nobody用戶(hù)

User nobody

#作為哪個(gè)用戶(hù)組運(yùn)行，即它擁有該用戶(hù)組的權(quán)限，一般都是nogroup，需要在/etc/group文件中有nogroup組

Group nogroup

#當(dāng)服務(wù)器發(fā)生問(wèn)題時(shí)發(fā)送報(bào)警的email地址，目前未用，注釋掉

#ServerAdminroot@localhost

#錯(cuò)誤日志文件。如果沒(méi)有以/開(kāi)始，則表示從服務(wù)器的根路徑開(kāi)始。如果不需要錯(cuò)誤日志，則用#/dev/null。在下面設(shè)置時(shí)，注意一定要建立/var/log/boa目錄，也可以將其注釋掉否則為出現(xiàn)Can’t open /var/log/boa/error_log錯(cuò)誤

ErrorLog /var/log/boa/error_log

#訪(fǎng)問(wèn)日志文件。如果沒(méi)有以/開(kāi)始，則表示從服務(wù)器的根路徑開(kāi)始。如果不需要錯(cuò)誤日志，則用#/dev/null或直接注釋掉。(在這里我遇到的問(wèn)題是，cannot open /usr/boa/log/boa/access_log for logging,permission denied.<前面的路徑是我定義的路徑，大家依據(jù)自己的情況作適當(dāng)修改>這是權(quán)限不足的問(wèn)題，可是其它的方法我都試了一遍，也沒(méi)有成功，最好把AcessLog /usr/boa/log/boa/access_log前面加個(gè)#號(hào)，也就是注掉，如下面，問(wèn)題就解決了) 在下面設(shè)置時(shí)，注意一定要建立/var/log/boa目錄,也可以將其注釋掉否則會(huì)出錯(cuò)

#AccessLog /var/log/boa/access_log

#是否使用本地時(shí)間。如果沒(méi)有注釋掉，則使用本地時(shí)間。注釋掉則使用UTC時(shí)間

#UseLocaltime

#是否記錄CGI運(yùn)行信息，如果沒(méi)有注釋掉，則記錄，注釋掉則不記錄

#VerboseCGILogs

#服務(wù)器名字

ServerName www.shuzhengfeng.com

#是否啟動(dòng)虛擬主機(jī)功能，即設(shè)備可以有多個(gè)網(wǎng)絡(luò)接口，每個(gè)接口都可以擁有一個(gè)虛擬的Web服務(wù)器。一般注釋掉，即不需要啟動(dòng)
#VirtualHost

#非常重要，HTML文檔的主目錄。如果沒(méi)有以/開(kāi)始，則表示從服務(wù)器的根路徑開(kāi)始。注意，如果此處設(shè)置不正確，將不能打開(kāi)網(wǎng)頁(yè)

DocumentRoot /var/www

#如果收到一個(gè)用戶(hù)請(qǐng)求的話(huà)，在用戶(hù)主目錄后再增加的目錄名

UserDir public_html

#HTML目錄索引的文件名，也是沒(méi)有用戶(hù)只指明訪(fǎng)問(wèn)目錄時(shí)返回的文件名

DirectoryIndex index.html

#當(dāng)HTML目錄沒(méi)有索引文件時(shí)，用戶(hù)只指明訪(fǎng)問(wèn)目錄時(shí)，boa會(huì)調(diào)用該程序生成索引文件然后返回給用戶(hù)，因?yàn)樵撨^(guò)程比較慢最好不執(zhí)行，可以注釋掉或者給每個(gè)HTML目錄加上DirectoryIndex指明的文件

#DirectoryMaker /usr/lib/boa/boa_indexer

#如果DirectoryIndex不存在，并且DirectoryMaker被注釋?zhuān)敲淳陀肂oa自帶的索引生成程序來(lái)生成目錄的索引文件并輸出到下面目錄，該目錄必須是Boa能讀寫(xiě)

# DirectoryCache /var/spool/boa/dircache

#一個(gè)連接所允許的HTTP持續(xù)作用請(qǐng)求最大數(shù)目，注釋或設(shè)為0都將關(guān)閉HTTP持續(xù)作用

KeepAliveMax 1000

#HTTP持續(xù)作用中服務(wù)器在兩次請(qǐng)求之間等待的時(shí)間數(shù)，以秒為單位，超時(shí)將關(guān)閉連接

KeepAliveTimeout 10

#指明mime.types文件位置。如果沒(méi)有以/開(kāi)始，則表示從服務(wù)器的根路徑開(kāi)始。可以注釋掉避免使用mime.types文件，此時(shí)需要用AddType在本文件里指明

MimeTypes /etc/mime.types

#文件擴(kuò)展名沒(méi)有或未知的話(huà)，使用的缺省MIME類(lèi)型

DefaultType text/plain

#提供CGI程序的PATH環(huán)境變量值

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

#將文件擴(kuò)展名和MIME類(lèi)型關(guān)聯(lián)起來(lái)，和mime.types文件作用一樣。如果用mime.types
#文件，則注釋掉，如果不使用mime.types文件，則必須使用

#AddType application/x-httpd-cgi cgi

#指明文檔重定向路徑

#Redirect /barhttp://elsewhere/feh/bar

#為路徑加上別名

Alias /doc /usr/doc

#非常重要，指明CGI腳本的虛擬路徑對(duì)應(yīng)的實(shí)際路徑。一般所有的CGI腳本都要放在實(shí)際路徑里，用戶(hù)訪(fǎng)問(wèn)執(zhí)行時(shí)輸入站點(diǎn)+虛擬路徑+CGI腳本名

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

用戶(hù)可以根據(jù)自己需要，對(duì)boa.conf進(jìn)行修改，但必須要保證其他的輔助文件和設(shè)置必須和boa.conf里的配置相符，不然Boa就不能正常工作。在上面的例子中，我們還需要?jiǎng)?chuàng)建日志文件所在目錄/var/log/boa，創(chuàng)建HTML文檔的主目錄/var/www，將mime.types文件拷貝到/etc目錄，創(chuàng)建CGI腳本所在目錄/var/www/cgi-bin/。mime.types文件用來(lái)指明不同文件擴(kuò)展名對(duì)應(yīng)的MIME類(lèi)型，一般可以直接從Linux主機(jī)上拷貝一個(gè)，大部分也都是在主機(jī)的/etc目錄下。

四、源碼修改

第一、修改boa-0.94-14/src目錄下面的defines.h里的

#ifndef SERVER_ROOT

#define SERVER_ROOT"/etc/boa"

#endif,

"/etc/boa"該路徑為boa.conf存放的路徑。

第二、修改boa.conf文件

（1）Group nogroup

Group nogroup—>改為Group nobody

（2）DoucmentRoot的修改

修改DoucmentRoot /var/www ，為存放網(wǎng)頁(yè)的路徑

第三、運(yùn)行Boa

./Boa

出現(xiàn)boa：server version Boa/0.94.14

boa: server built Sep 15 2009 at 01:02:14

boa: starting server pid=14390 ,port 80

五、服務(wù)器測(cè)試以及網(wǎng)頁(yè)編寫(xiě)

（1）測(cè)試

打開(kāi)Mozilla瀏覽器，輸入自己的IP地址如：192.168.0.2 就可以打開(kāi)網(wǎng)頁(yè)。

（2）簡(jiǎn)單網(wǎng)頁(yè)的編寫(xiě)網(wǎng)頁(yè)

equiv="Content-Type" content="text/html; charset=gb2312">

Hello veryone!!!!!!!!!!!!!!!!!!!!!!!!

六、可能出錯(cuò)及修正

(1) 會(huì)出現(xiàn)錯(cuò)誤：util.c:100:1: error: pasting "t" and "->" does not give a valid preprocessing token make: * [util.o] 錯(cuò)誤 1

修改 src/compat.h

#define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff

修改成

#define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff

(2) 會(huì)出現(xiàn)錯(cuò)誤log.c:73 unable to dup2 the error log:bad file descriptor

修改 src/log.c注釋掉

　　if (dup2(error_log, STDERR_FILENO) == -1) {

　　DIE("unable to dup2 the error log");

　　}

　　為：

(3) boa.c:211 - getpwuid: No such file or directory

修改src/boa.c注釋掉下面兩句話(huà)：

　　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）會(huì)出現(xiàn)問(wèn)題：boa.c:228 - icky Linux kernel bug!: No such file or directory

注釋掉下面語(yǔ)句：

　　if (setuid(0) != -1) {

　　DIE(”icky Linux kernel bug!”);

　　}為

　　#if 0

　　if (setuid(0) != -1) {

　　DIE(”icky Linux kernel bug!”);

　　}

　　#endif