boa設定檔解析

隨著Internet技術的興起，在嵌入式裝置的管理與互動中，基於Web方式的應用成為目前的主流，這種程式結構也就是大家非常熟悉的B/S結構，即在
嵌入式裝置上運行一個支援指令碼或CGI功能的Web伺服器，能夠產生動態網頁面，在使用者端只需要通過Web瀏覽器就可以對嵌入式裝置進行管理和監控，非常方
便實用。本節主要介紹這種應用的開發和移植工作。
使用者首先需要在嵌入式裝置上成功移植支援指令碼或CGI功能的Web伺服器，然後才能進行應用程式的開發。
  1、嵌入式Web伺服器移植
由於嵌入式裝置資源一般都比較有限，並且也不需要能同時處理很多使用者的請求，因此不會使用Linux下最常用的如Apache等伺服器，而需要使用一些專
門為嵌入式裝置設計的Web伺服器，這些Web伺服器在存貯空間和運行時所佔有的記憶體空間上都會非常適合於嵌入式應用場合。
 
典型的嵌入式Web伺服器有Boa （www.boa.org）和thttpd
（http://www.acme.com/software/thttpd/）等，它們和Apache等高效能的Web伺服器主要的區別在於它們一般是
單進程伺服器，只有在完成一個使用者請求後才能響應另一個使用者的請求，而無法並發響應，但這在嵌入式裝置的應用場合裡已經足夠了。
  我們紹比較常用的Boa伺服器的移植。
 
Boa是一個非常小巧的Web伺服器，可執行代碼只有約60KB。它是一個單任務Web伺服器，只能依次完成使用者的請求，而不會fork出新的進程來處理
並發串連請求。但Boa支援CGI，能夠為CGI程式fork出一個進程來執行。Boa的設計目標是速度和安全，在其網站公布的效能測試中，Boa的效能
要好於Apache伺服器。
  第一步完成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目錄下。