从头搭建一个嵌入式web服务器-boa服务器
qiyuwang 2024-10-31 15:54 12 浏览 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. 修改编代码
- src/compat.h 打开文件
src/compat.h
修改
120： #define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
为
120： #define TIMEZONE_OFFSET(foo) (foo)->tm_gmtoff
- 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：指定脚本路径的虚拟路径。
三、运行测试
- 在 /www下新建index.html文件，并放置名为yikou.png的图片到image目录下。 文件目录如下：
root@ubuntu:/www# tree ./
./
├── image
│ └── yikou.png
└── index.html
1 directory, 2 files
index.html内容
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" >
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>一口Linux</title>
</head>
<body >
<div align="center">
<table width="900" border="0">
<tr><td>
<form onsubmit="return isValidate(myform)" action="cgi-bin/login.cgi" method="post">
用户名: <input type="text" name="username" id="username" >
<td> </td>
<tr><td>
密 码: <input type="password" name="userpass" id="userpass">
<td> </td>
<tr><td>
<input type="submit" value="登录" id="button" >
</form>
</td></tr>
</table>
</div>
<div align="center">
<table width="900" height="467" border="0" background="./image/yikou.png">
<tr>
<td width="126" height="948"> </td>
<td width="351"></td>
<td width="101"> </td>
</tr>
</div>
</body>
</html>
关于html语法，后面一口君会写几篇入门的教程。
- 运行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
- 打开浏览器
输入地址：
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协议，并基于该服务器实现一个物联网综合项目。
敬请大家关注！
相关推荐
- 别再乱找了!这才是 Alist 本地安装挂载的正确打开方式
-
一、探秘Alist的神奇世界在这个数据爆炸的时代，我们的生活里充斥着各种各样的网盘服务，百度网盘、阿里云盘、腾讯微云等等，它们成了我们存储资料的得力助手。但随着网盘数量的增多，管理这些分散在不同平...
- 如何将数据从旧iPhone传输到新iPhone 16?这五个方法你必须知道!
-
前不久，苹果发布了备受期待的iPhone16系列，新机型搭载了更强大的芯片、更流畅的操作体验，还有备受热议的全新摄像系统。无论你是冲着A18仿生芯片，还是更丰富的动态岛功能，相信很多果粉早已跃跃欲试...
- 大数据传输的定义与大数据传输解决方案的选择
-
当我们需要处理大量的数据时，我们就要把数据从一个地方移动到另一个地方。这个过程就叫做大数据传输。它通常需要用到高速的网络连接、分散的存储系统和数据传输协议，以保证数据的快速、可靠和安全的移动。常用的大...
- 【工具】在线传输文件工具（在线文件互传）
-
前言在线传输文件工具主要是用于在不同的设备之间，如手机、电脑、平板等快速便捷地传送文件。告别使用USB传统传输文件的方式。...
- 如何使用 CAN-FD 在 LPC5500 上传输数据
-
目录1引言2CAN-FD3示例演示1引言...
- 轻松同步:将照片从三星手机传输到iPad的简便方法
-
概括想要在新iPad上查看三星照片吗？但是，如果您不知道如何将照片从三星手机传输到iPad，则无法在iPad上查看图片。为此，本文分享了7个有用的方法，以便您可以使用它们在不同操作系统之...
- 常见又地道的网络缩写:美剧中常说的SFW到底是个啥?
-
在这堂课中，让我们来学习更多在数字网络世界中常用的有趣网络用语。7shifts/unsplashhttp,https“http”和“https”是万维网（www）传输文件用的协议。“http”是hy...
- 每天学会一个计算机网络协议之FTP
-
开始行文之前提出一个问题，相信大家在看完本文后一定可以回答当我们在网站上填写注册信息的时候，需要我们上传照片，上传的过程发生了什么？下面引入我们的主角，FTP文件传输协议FTPFileTransf...
- 即用即走，这3款文件分享工具真香
-
打工人的日常，免不了「文件分享存储服务」的需求。我们一般会选择不同的网盘，但是大家也知道，网盘不是限速就是叫你充值。今天跟大家简单推荐3款文件分享工具，既可以免登录匿名使用，而且操作简单稳定性也不错。...
- 安卓手机里的文件和照片与Mac互传的办法
-
因为HandShake一段时间未更新，似乎目前不可操作。我一时间未找到更好的「传输」办法，经实践操作，向大家介绍一下「安卓手机」，包括「一加」、「索尼」，都可用此方法，来进行文件传输到Mac的...
- 软网推荐:同一个平台选择不同的传输方法
-
平时上网的时候，我们经常要分享一些文件给其他朋友，一般通过云服务平台来实现。今天笔者给大家介绍的Worksphere传输服务，它提供了两种不同的分享方式，方便我们根据实际需要进行选择。一个链接分享所有...
- 跨平台不限速的免费文件传输网站（跨平台不限速的免费文件传输网站是什么）
-
大家好，欢迎来到天天惠分享，不知道各位平时都是用什么方法来进行文件跨平台传输的呢？是百度网盘?微信还是QQ?亦或是有线传输。虽然这些方法都可以达到传输的目的，但都有各自的缺陷，使用起来一言难尽。比如百...
- 全网最全最详细的全平台文件传输方法，解决你文件传输问题(一)
-
前言想必现在大多数人文件传输的方法还是使用qq微信，但是qq微信的文件传输有时候真是，...
- 文件传输工具有哪些?这3款堪称办公必备!
-
在不同设备间，想把文件从一台设备传输到另一台，尤其是大体积文件，更是免不了用到文件传输工具，可以说文件传输工具已成为提升效率的关键载体。面对海量文档、设计素材、会议纪要的流转需求，传统邮件附件、U盘拷...
- 小白也能用的跨网文件交换系统!10款简单易上手的文件摆渡工具
-
跨网文件交换系统对于需要频繁在不同网络环境中进行文件共享的用户来说至关重要。以下是10款简单易上手的文件摆渡工具，适合小白用户使用，帮助他们高效地分享和传输文件。10款简单易上手的跨网文件交换工具1....
欢迎 你 发表评论:
- 一周热门
- 最近发表
- 标签列表
-
- navicat无法连接mysql服务器 (65)
- 下横线怎么打 (71)
- flash插件怎么安装 (60)
- lol体验服怎么进 (66)
- ae插件怎么安装 (62)
- yum卸载 (75)
- .key文件 (63)
- cad一打开就致命错误是怎么回事 (61)
- rpm文件怎么安装 (66)
- linux取消挂载 (81)
- ie代理配置错误 (61)
- ajax error (67)
- centos7 重启网络 (67)
- centos6下载 (58)
- mysql 外网访问权限 (69)
- centos查看内核版本 (61)
- ps错误16 (66)
- nodejs读取json文件 (64)
- centos7 1810 (59)
- 加载com加载项时运行错误 (67)
- php打乱数组顺序 (68)
- cad安装失败怎么解决 (58)
- 因文件头错误而不能打开怎么解决 (68)
- js判断字符串为空 (62)
- centos查看端口 (64)