本文将对Boa服务器的配置文件boa.conf进行一下解释:
    注:本文采用的Boa的版本是:boa-0.94.14rc21.tar.gz  (最新版本,网上用的比较多的是boa-0.94.13)
    其boa.conf在文件夹里:contrib/rpm/boa.conf

    指定boa的日志目录
   
boa有两种日志文件:记录其所出现的错误和记录其运行状态。
    1)记录其所出现的错误。ErrorLog  /var/log/boa/error_log
    2)记录其运行状态。AccessLog  /var/log/boa/access_log

    指定网页所在的目录
   
如:DocumentRoot  /home/httpd/html  
    表示网页文件需放在此目录下。
    默认的主页名
   
如:DirectoryIndex  index.html
    表示默认的主页名为 index.html

    指定cgi 脚本的目录
    如:ScriptAlias  /cgi-bin/  /home/httpd/cgi-bin/

 

boa.conf完整内容见下:

 
  
  1. # Boa v0.94 configuration file  
  2. # File format has not changed from 0.93  
  3. # File format has changed little from 0.92  
  4. # version changes are noted in the comments  
  5. #  
  6. # The Boa configuration file is parsed with a lex/yacc or flex/bison  
  7. # generated parser.  If it reports an error, the line number will be  
  8. # provided; it should be easy to spot.  The syntax of each of these  
  9. # rules is very simple, and they can occur in any order.  Where possible  
  10. # these directives mimic those of NCSA httpd 1.3; I saw no reason to   
  11. # introduce gratuitous differences.  
  12.  
  13. # $Id: boa.conf,v 1.2 2001/09/25 03:28:31 jnelson Exp $  
  14.  
  15. # The "ServerRoot" is not in this configuration file.  It can be compiled  
  16. # into the server (see defines.h) or specified on the command line with  
  17. # the -c option, for example:  
  18. #  
  19. # boa -c /usr/local/boa  
  20.  
  21.  
  22. # Port: The port Boa runs on.  The default port for http servers is 80.  
  23. # If it is less than 1024, the server must be started as root.  
  24.  
  25. Port 80  
  26.  
  27. # Listen: the Internet address to bind(2) to.  If you leave it out,  
  28. # it takes the behavior before 0.93.17.2, which is to bind to all  
  29. # addresses (INADDR_ANY).  You only get one "Listen" directive,  
  30. # if you want service on multiple IP addresses, you have three choices:  
  31. #    1. Run boa without a "Listen" directive  
  32. #       a. All addresses are treated the same; makes sense if the addresses  
  33. #          are localhost, ppp, and eth0.  
  34. #       b. Use the VirtualHost directive below to point requests to different  
  35. #          files.  Should be good for a very large number of addresses (web  
  36. #          hosting clients).  
  37. #    2. Run one copy of boa per IP address, each has its own configuration  
  38. #       with a "Listen" directive.  No big deal up to a few tens of addresses.  
  39. #       Nice separation between clients.  
  40. # The name you provide gets run through inet_aton(3), so you have to use dotted  
  41. # quad notation.  This configuration is too important to trust some DNS.  
  42.  
  43. #Listen 192.68.0.5  
  44.  
  45. #  User: The name or UID the server should run as.  
  46. # Group: The group name or GID the server should run as.  
  47.  
  48. User nobody  
  49. Group nobody  
  50.  
  51. # ServerAdmin: The email address where server problems should be sent.  
  52. # Note: this is not currently used, except as an environment variable  
  53. # for CGIs.  
  54.  
  55. #ServerAdmin root@localhost  
  56.  
  57. # ErrorLog: The location of the error log file. If this does not start  
  58. # with /, it is considered relative to the server root.  
  59. # Set to /dev/null if you don't want errors logged.  
  60. # If unset, defaults to /dev/stderr  
  61.  
  62. ErrorLog /var/log/boa/error_log  
  63. # Please NOTE: Sending the logs to a pipe ('|'), as shown below,  
  64. #  is somewhat experimental and might fail under heavy load.  
  65. # "Usual libc implementations of printf will stall the whole  
  66. #  process if the receiving end of a pipe stops reading."  
  67. #ErrorLog "|/usr/sbin/cronolog --symlink=/var/log/boa/error_log /var/log/boa/error-%Y%m%d.log"  
  68.  
  69. # AccessLog: The location of the access log file. If this does not  
  70. # start with /, it is considered relative to the server root.  
  71. # Comment out or set to /dev/null (less effective) to disable   
  72. # Access logging.  
  73.  
  74. AccessLog /var/log/boa/access_log  
  75. # Please NOTE: Sending the logs to a pipe ('|'), as shown below,  
  76. #  is somewhat experimental and might fail under heavy load.  
  77. # "Usual libc implementations of printf will stall the whole  
  78. #  process if the receiving end of a pipe stops reading."  
  79. #AccessLog  "|/usr/sbin/cronolog --symlink=/var/log/boa/access_log /var/log/boa/access-%Y%m%d.log"  
  80.  
  81. # VerboseCGILogs: this is just a logical switch.  
  82. #  It simply notes the start and stop times of cgis in the error log  
  83. # Comment out to disable.  
  84.  
  85. #VerboseCGILogs  
  86.  
  87. # ServerName: the name of this server that should be sent back to   
  88. # clients if different than that returned by gethostname + gethostbyname   
  89.  
  90. #ServerName www.your.org.here  
  91.  
  92. # VirtualHost: a logical switch.  
  93. # Comment out to disable.  
  94. # Given DocumentRoot /var/www, requests on interface 'A' or IP 'IP-A'  
  95. # become /var/www/IP-A.  
  96. # Example: http://localhost/ becomes /var/www/127.0.0.1  
  97. #  
  98. # Not used until version 0.93.17.2.  This "feature" also breaks commonlog  
  99. # output rules, it prepends the interface number to each access_log line.  
  100. # You are expected to fix that problem with a postprocessing script.  
  101.  
  102. #VirtualHost   
  103.  
  104. # DocumentRoot: The root directory of the HTML documents.  
  105. # Comment out to disable server non user files.  
  106.  
  107. DocumentRoot /home/httpd/html  
  108.  
  109. # UserDir: The name of the directory which is appended onto a user's home  
  110. # directory if a ~user request is recieved.  
  111.  
  112. UserDir public_html  
  113.  
  114. # DirectoryIndex: Name of the file to use as a pre-written HTML  
  115. # directory index.  Please MAKE AND USE THESE FILES.  On the  
  116. # fly creation of directory indexes can be _slow_.  
  117. # Comment out to always use DirectoryMaker  
  118.  
  119. DirectoryIndex index.html  
  120.  
  121. # DirectoryMaker: Name of program used to create a directory listing.  
  122. # Comment out to disable directory listings.  If both this and  
  123. # DirectoryIndex are commented out, accessing a directory will give  
  124. # an error (though accessing files in the directory are still ok).  
  125.  
  126. DirectoryMaker /usr/lib/boa/boa_indexer  
  127.  
  128. # DirectoryCache: If DirectoryIndex doesn't exist, and DirectoryMaker  
  129. # has been commented out, the the on-the-fly indexing of Boa can be used  
  130. # to generate indexes of directories. Be warned that the output is   
  131. # extremely minimal and can cause delays when slow disks are used.  
  132. # Note: The DirectoryCache must be writable by the same user/group that   
  133. # Boa runs as.  
  134.  
  135. # DirectoryCache /var/spool/boa/dircache  
  136.  
  137. # KeepAliveMax: Number of KeepAlive requests to allow per connection  
  138. # Comment out, or set to 0 to disable keepalive processing  
  139.  
  140. KeepAliveMax 1000  
  141.  
  142. # KeepAliveTimeout: seconds to wait before keepalive connection times out  
  143.  
  144. KeepAliveTimeout 10  
  145.  
  146. # MimeTypes: This is the file that is used to generate mime type pairs  
  147. # and Content-Type fields for boa.  
  148. # Set to /dev/null if you do not want to load a mime types file.  
  149. # Do *not* comment out (better use AddType!)  
  150.  
  151. MimeTypes /etc/mime.types  
  152.  
  153. # DefaultType: MIME type used if the file extension is unknown, or there  
  154. # is no file extension.  
  155.  
  156. DefaultType text/plain  
  157.  
  158. # AddType: adds types without editing mime.types  
  159. # Example: AddType type extension [extension ...]  
  160.  
  161. # Uncomment the next line if you want .cgi files to execute from anywhere  
  162. #AddType application/x-httpd-cgi cgi  
  163.  
  164. # Redirect, Alias, and ScriptAlias all have the same semantics -- they  
  165. # match the beginning of a request and take appropriate action.  Use  
  166. # Redirect for other servers, Alias for the same server, and ScriptAlias  
  167. # to enable directories for script execution.  
  168.  
  169. # Redirect allows you to tell clients about documents which used to exist in  
  170. # your server's namespace, but do not anymore. This allows you to tell the  
  171. # clients where to look for the relocated document.  
  172. # Example: Redirect /bar http://elsewhere/feh/bar  
  173.  
  174. # Aliases: Aliases one path to another.  
  175. # Example: Alias /path1/bar /path2/foo  
  176.  
  177. Alias /doc /usr/doc  
  178.  
  179. # ScriptAlias: Maps a virtual path to a directory for serving scripts  
  180. # Example: ScriptAlias /htbin/ /www/htbin/  
  181.  
  182. ScriptAlias /cgi-bin/ /home/httpd/cgi-bin/  
  183.