百度360必应搜狗淘宝本站头条
tomcat 乱码无法与服务器建立安全连接是什么意思sysv-rc-confdocker映射容器目录到宿主机internet explorer 增强的安全配置已启用
当前位置：网站首页 > 技术文章 > 正文

从头搭建一个嵌入式web服务器-boa服务器

nanshan 2025-01-26 23:37 13 浏览 0 评论

一、什么是boa？

BOA是一款非常小巧的Web服务器，源代码开放、性能优秀、支持CGI通用网关接口技术，特别适合应用在嵌入式系统中。

BOA服务器主要功能是在互联嵌入式设备之间进行信息交互，达到通过网络对嵌入式设备进行监控，并将反馈信息自动上传给主控设备的目的。它是基于HTTP超文本传输协议的，Web网页是Web服务最基本的传输单元。

嵌入式Web服务的工作基于客户机/服务器计算模型，由Web浏览器(客户机)和Web服务器(服务器)构成，也即著名的B/S结构。运行于客户端的浏览器首先要与嵌入式Web服务器BOA端建立连接，打开一个套接字虚拟文件，此文件建立标志着SOCKET连接建立成功然后客户端浏览器通过套接字SOCKET以GET或者POST参数传递方式向Web服务器提交请求，Web浏览器提交请求后，通过HTTP协议传送给Web服务器。Web服务器接到请求后，根据请求的不同进行事务处理，返回HTML文件或者通过CGI调用外部应用程序，返回处理结果。

服务器通过CGI与外部应用程序和脚本之间进行交互，根据客户端浏览器在请求时所采用的方法，服务器会搜集客户所提供的信息，并将该部分信息发送给指定的CGI扩展程序，CGI扩展程序进行信息处理并将结果返回给服务器，然后服务器对信息进行分析，并将结果发送回客户端在浏览器上显示出来。

二、boa移植步骤

平台：ubuntu 16.04 版本是：boa-0.94.13.tar.gz

1. 下载地址：

http://www.boa.org/

服务器已经无法访问，可以公号后台回复关键字：boa，获取压缩包

2. 源码解压

源代码拷贝到：

/home/peng/boa

peng@ubuntu:~/boa$ tar -xf boa-0.94.13.tar.gz


3. 安装词法解析器

$ sudo apt-get install bison
$ sudo apt-get install flex

yacc是一个文法分析器的生成器,bison即是yacc的GNU版本 Lex和YACC是用于构造词法分析机和语法解释器的工具，利用Lex和YACC你可以轻松的构造一个语法解释器。

4. 修改编代码

  1. src/compat.h 打开文件
src/compat.h

修改

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

为

120： #define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
  1. src/log.c 打开文件：
src/log.c

3. boa.c

5. 编译 peng@ubuntu:~/boa/boa-0.94.13$ cd src/
peng@ubuntu:~/boa/boa-0.94.13/src$ ./configure --prefix=/home/peng/boa/boa-0.94.13/tmp

peng@ubuntu:~/boa/boa-0.94.13/src$ make
peng@ubuntu:~/boa/boa-0.94.13/src$ sudo mkdir /etc/boa
peng@ubuntu:~/boa/boa-0.94.13/src$ sudo cp ../boa.conf /etc/boa
6. 修改配置文件boa.conf


修改AccessLog /var/log/boa/access_log
为#AccessLog /var/log/boa/access_log

其中，#表示注释，在文件内部，我们找到#后面的内容，然后加上#下面的内容即可。

Boa Webserver配置参数说明：

Port：boa服务器监听的端口，默认的端口是80。如果端口小于1024，则必须是root用户启动服务器。

Listen：绑定的ip地址。不使用这个参数时，将绑定所有的地址。

User：连接到服务器的客户端的身份，可以是用户名或UID。（为什么非要指定为文件的所有者才能访问网页呢？nobody用户也有读权限啊）

Group：连接到服务器的客户端的组，可以是组名或GID。

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。

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：指定脚本路径的虚拟路径。

三、运行测试

  1. 在 /www下新建index.html文件，并放置名为yikou.png的图片到image目录下。 文件目录如下：
root@ubuntu:/www# tree ./
./
├── image
│   └── yikou.png
└── index.html

1 directory, 2 files

index.html内容





一口Linux




 

   

    

  用户名:  
  
 
    

  密    码:  
    
    

  
   

   

 




   

    
关于html语法，后面一口君会写几篇入门的教程。
  1. 运行boa
root@ubuntu:/home/peng/boa/boa-0.94.13/src# ./boa
root@ubuntu:/home/peng/boa/boa-0.94.13/src# [29/Jan/2022:15:42:26 +0000] boa: server version Boa/0.94.13
[29/Jan/2022:15:42:26 +0000] boa: server built Jan 29 2022 at 07:42:23.
[29/Jan/2022:15:42:26 +0000] boa: starting server pid=5761, port 80

  1. 打开浏览器
输入地址：
http://192.168.174.128/

只要能ping通boa所在主机的ip地址的浏览器都可以访问。

四、错误汇总
1.必需要在板子的/etc下建一个boa目录（错误代码忘了）
2.”can't open boa.conf for reading“ 解决：不只要在你本身放置boa的目录下放入boa.conf配置文件，并且要在板子的/etc/boa下也要放入boa.conf文件，这样系统在运行boa的时候才能够读取到boa.conf文件。
3.“unable to dup2 the error log bad file descriptor” 解决：在boa源码里，即src文件夹下把log.c中的第73行的if语句注释掉。
4."unable to dup2 the error log:Bad file descriptor" 解决：在boa.conf里，把“#AccessLog /var/log/boa/access_log”注释掉（即去掉＃号）。
5.“[01/Jan/2031:00:12:25 +0000] boa.c:226 - icky Linux kernel bug!: No such file or directory” 解决：在boa源码里，即src文件夹下把boa.c中的第226行的if语句注释掉。
6."gethostbyname:: Resource temporarily unavailable" 解决：把“#ServerName www.your.org.here”的“＃”号去掉。
7."./boa: 1: syntax error: "(" unexpected" 解决：没有修改Makefile，是用gcc编译的，应该改为是arm-linux-gcc编译。
8.若是页面上是：“502 Bad Gateway The CGI was not CGI/1.1 compliant.“ 解决：给你要执行的cgi可执行程序赋个权限。chmod 777 filename
9.在
中，cgi可执行程序的路径就直接写“cgi-bin/test2.cgi”就能够了，不要写板子上的绝对路径，这样就重复了，由于cgi执行时会自动去boa.conf的指定的路径里找。
10.出现警告：“control reaches end of non-void function”，是由于某个函数没有return，而函数定义时是非void型的。因此须要有个返回值。好比int cgiMain()这个函数就必定要有个返回值的，不然会报这个错误。
11.运行网页时老出现错误：“mkstemp:No such file or diectory” 解决：不能用post，只能用get。由于post方式须要新建一个临时文件，这就须要用到mkstemp函数。这个函数是在系统中以惟一的文件名建立一个文件并打开，且只有当前用户才能访问这个临时文件。故权限不够，或其余什么问题都会报这个错误。那么就用get吧！这里具体缘由细节笔者暂时也不是很清楚...
12.直接写的含有system()函数的c程序用arm-linux-gcc编译到板子上的能够执行，而若是写在cgi中的就不必定能执行了。由于牵涉到一个cgi的权限的问题。即便给你的cgi-bin文件夹下的全部cgi可执行文件都赋了权限，也不必定能执行。
解决办法就是看看你的boa.conf中的权限设置的如何。这里正确的应该是把“User nobody Group nogroup”改成“User root Group 0”，不然不能正确执行！你会发现你的cgi可执行程序的其余代码都执行了，却只有这个system()函数没有执行！
五、修改的参数说明
(1)Group的修改：
修改 Group nogroup 为 Group 0 Group表示连接到服务器的客户端的组，可以是组名或GID。
(2)user的修改
修改 User nobody 为 User 0 User：连接到服务器的客户端的身份，可以是用户名或UID。
(3)ScriptAlias的修改
修改ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/ 为 ScriptAlias /cgi-bin/ /www/cgi-bin/ ScriptAlias：指定脚本路径的虚拟路径。
(4)DocumentRoot的修改
修改DocumentRoot /var/www 为DocumentRoot /www DocumentRoot：HTML文件的根目录（也就是网站的目录）。
(5)ServerName的设置
修改#ServerName www.your.org.here 为 ServerName www.your.org.here 否则会出现错误“gethostbyname::No such file or directory” ServerName：指定服务器的名称，当客户端使用gethostname + gethostbyname时返回给客户端。
六、补充
后续一口君会在本篇文章基础之上，继续讲解HTTP协议，并基于该服务器实现一个物联网综合项目。
敬请大家关注！

        
    
        

            

    

    

相关推荐

                                                


        
Linux 的磁盘系统，和你了解的Windows差别很大

    

        
我的C盘去哪了？一个系统，如果没有存储，那么也就不能称之为系统。存储性是一个完整系统的重要组成部分。例如AWS最开始的服务就是S3(用来存储数据的云服务)，足以见得存储对于一个应用平台是多么的重要。...

    

    
                                


        
一文读懂 Linux 硬盘挂载:从问题到解决方案

    

        
各位互联网大厂的后端开发伙伴们！在咱们日常工作中，操作Linux系统是常有的事儿吧。你们有没有遇到过这样的场景：新添加了一块硬盘，满心欢喜准备用来存储重要数据或者部署新的应用服务，却突然发现不知道...

    

    
                                


        
硬盘分区（硬盘分区格式）

    

        
　磁盘（硬盘）分区，可以分C、D、E等分区，大家可能都会用，会根据自已的需要确定所需的空间，但分区是如何工作的呢，内容如下。Windows中有3类：MBR分区：ＭasterBootRecord，也...

    

    
                                


        
parted命令工具分区介绍（particle命令）

    

        
linux系统磁盘分区通常可以使用fdisk和parted命令，当分区大小小于2TB的时候，两种皆可以使用，当分区大于2TB的话，就需要用parted分区。以下介绍parted命令相关使用，以sdb为...

    

    
                                


        
Linux 服务器上查看磁盘类型的方法

    

        
方法1：使用lsblk命令lsblk输出说明：TYPE列显示设备类型，如disk（物理磁盘）、part（分区）、rom（只读存储）等。NAME列显示设备名称（如sda、nvme0n1）。TR...

    

    
                                


        
Linux分区命令fdisk和parted使用介绍

    

        
摘要：一般情况下，Linux分区都是选择fdisk工具，要求硬盘格式为MBR格式，能支持的最大分区空间为2T。但是目前在实际生产环境中使用的磁盘空间越来越大，呈TB级别增长；而常用的fdisk这个工具...

    

    
                                


        
linux 分区原理与名词解释（linux操作系统中的分区类型）

    

        
分区的意义将磁盘分成几份，每份挂在到文件系统的那个目录在linux里的文件系统Ext2:早期的格式，不支持日志功能Ext3:ext2改良版，增加了日志功能，是最基本且最常用的使用格式了Ext4:针对e...

    

    
                                


        
linux 分区合并（linux合理分区）

    

        
查看虚拟机当前磁盘挂载情况fdisk-l选择磁盘fdisk/dev/sda查看磁盘分区情况p重新选择分区n选择主分区p保存w创建物理卷pvcreate/dev/sda3查看物理卷信息pvdi...

    

    
                                


        
如何在 Linux 系统中永久禁用交换分区 ?

    

        
Linux操作系统中的交换分区或交换文件充当硬盘上的临时存储区域，当物理内存(RAM)满时，系统使用该存储区域。它用于交换较少使用的内存页，这样系统就不会因为运行应用程序而耗尽物理内存。随着技术的发...

    

    
                                


        
Linux 如何知道硬盘已用多少空间、未用多少空间

    

        
刚出社会时，去了一家公司上班，老板为了省钱，买的服务器是低配的，硬盘大小只有40G，有一次网站突然不能访问了，排查半天才知道原来服务器的硬盘空间已用完，已无可用空间。第一步是查看硬盘的使用情况，第二步...

    

    
                                


        
用Linux系统管理磁盘空间 就该这么来

    

        
要想充分有效的管理使用Linux系统中的存储空间，用户必须要做的就是双管齐下，一边扩充空间一边限制空间。不得不说的就是很多时候磁盘空间就像水资源，需节制水流。说到要如何实现限制空间就离不开使用LVM技...

    

    
                                


        
Windows 11 磁盘怎么分区?（windows11磁盘怎么分区）

    

        
Windows11磁盘分区技术解析与操作指南：构建高效存储体系一、磁盘分区的技术本质与系统价值磁盘分区作为存储系统的基础架构，通过逻辑划分实现数据隔离与管理优化。Windows11采用NTF...

    

    
                                


        
linux上创建多个文件分区，格式化为 ext2、ext3、ext4、XFS 文件

    

        
以下是在Linux系统上创建多个20GB文件分区并格式化为不同文件系统的分步指南：步骤1：创建基础文件（4个20GB文件）bash#创建4个20GB稀疏文件（实际占用空间随写入量增长）ddif=/...

    

    
                                


        
救命的U盘低格哪家最强?（低格优盘）

    

        
周二时有位童鞋留言说U盘之前做过引导盘，现在格式化不了，用各种工具都不行，而且因为U盘厂商的关系，查不到U盘主控，无法量产恢复，特来求助。小编花了点时间特意弄坏一个U盘分区，终于试出方法了，特来分享一...

    

    
                                


        
Linux 查看硬件磁盘存储大小和磁盘阵列(RAID)的组合方式

    

        
一、查看硬件磁盘存储大小查看所有磁盘信息：#lsblk该命令会列出所有磁盘（如/dev/sda、/dev/nvme0n1）及其分区和挂载点。查看磁盘总容量：fdisk-l#或parted-...

    

    
                
            

                



        
        







    
取消回复欢迎 你 发表评论:

    

        
        
                
 

                

                        

                
                

            
            
        

    


            

                                    

                
一周热门

                

                    
                

            

            
            




最近发表












标签列表