手把手教你在开发板中搭建一个嵌入式web服务器

浅浅的花香味﹌ 2022-09-02 05:22 243阅读 0赞

**关注+****星标公众****号**，不错过精彩内容

![da6c295ac43505be90dda73d3d2e77ca.gif][]

转自 | 嵌入式大杂烩

本文手把手教大家在10分钟内使用开发板搭建一个web服务器。

文章《[**常见的嵌入式web服务器有哪些？**][web]》中分享了几种可以在嵌入式中使用的web服务器。

嵌入式 web 服务器就是把 web 服务器移植到嵌入式系统的服务器。它仍然是基于http文本协议进行通信的，具有标准的接口形式，对客户端来说，访问嵌入式 web服务器就和访问普通的web 服务一样。

我们在实际工作中也有在板子上搭建web服务器，给我们调试带来了一些便利，可以通过网页与板子进行交互，板子在没有显示屏的情况下，也可以作为一种方案来进行功能展示。

## web服务器——boa ##

![eb8dbcd5dc4f8c1e0c3c4c0223a96277.png][]

本文演示如何把boa移植到开发板上，boa 是一个小巧的web 服务器，可执行代码只有70KB，占用的系统资源少，速度快安全性能高。

boa官网：

> ❝
> 
> www.boa.org
> 
> ❞

下载的版本：

> ❝
> 
> boa-0.94.13.tar.gz
> 
> ❞

本片文章关于web服务器地使用需要依赖于网络，可以参考我们上一篇笔记搭建开发板地WiFi环境：[**实用 | 如何远程登录开发板？**][Link 1]。

## boa交叉编译 ##

下载得到boa-0.94.13.tar.gz，解压后进入`boa-0.94.13/src`目录，执行如下命令生成Makefile文件：

./configure

修改 Makefile， 设置交叉编译器 。找到 CC 和 CPP 变量 ，修改为：

CC = arm-linux-gnueabihf-gcc 
    CPP = arm-linux-gnueabihf-gcc -E

执行make编译。编译报错如：

arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o response.o response.c
    arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o select.o select.c
    arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o signals.o signals.c
    arm-linux-gnueabihf-gcc  -g -O2 -pipe -Wall -I.   -c -o util.o util.c
    In file included from boa.h:50:0,
                     from util.c:26:
    util.c: In function 'get_commonlog_time':
    util.c:100:39: error: pasting "t" and "->" does not give a valid preprocessing token
             time_offset = TIMEZONE_OFFSET(t);
                                           ^
    compat.h:120:30: note: in definition of macro 'TIMEZONE_OFFSET'
     #define TIMEZONE_OFFSET(foo) foo##->tm_gmtoff
                                  ^~~
    <内置>: recipe for target 'util.o' failed

把compat.h  文件里的：

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

修改为：

#define TIMEZONE_OFFSET(foo) foo->tm_gmtoff

再次编译，可以编译通过则会在当前路径下生成boa可执行文件：

![0889923d979c92ef03d0986178146ba8.png][]

## boa配置 ##

把Ubuntu 的/etc 目录下的 mime.types 文件传到开发板的/etc目录下。注：这是MIME（多用途因特网邮件扩展），这是web服务器支持的规范。

在开发板/etc目录下创建boa文件夹（用于存放boa的配置文件及log文件）：

cd /etc
    mkdir boa

在开发板根目录下建立 www 文件夹  ，www 目录下面建立文件夹 cgi-bin 目录 （用于存放后期页面及交互代码）：

mkdir -p /www/cgi-bin

把boa-0.94.13目录下的boa.conf 文件传到开发板的/etc/boa目录下。

scp boa.conf root@192.168.1.10:/etc/boa

把boa 可执行程序传到开发板的 bin 目录下 。

scp boa root@192.168.1.10:/bin

在开发板/etc目录下创建group文件：

cd /etc
    touch group

在开发板上使用vi编辑器打开/etc/boa目录下的boa.conf文件，需要做如下修改：

① 把里面的`Group nogroup` 改为`Group 0`  。

②把`ErrorLog`  和 `AccessLog` 这两行， 指定 log 文件的路径，把log保存到/etc/boa目录下，修改如下：

ErrorLog /etc/boa/error_log
    # Please NOTE: Sending the logs to a pipe ('|'), as shown below,
    #  is somewhat experimental and might fail under heavy load.
    # "Usual libc implementations of printf will stall the whole
    #  process if the receiving end of a pipe stops reading."
    #ErrorLog "|/usr/sbin/cronolog --symlink=/var/log/boa/error_log /var/log/boa/error-%Y%m%d.log"
    
    # AccessLog: The location of the access log file. If this does not
    # start with /, it is considered relative to the server root.
    # Comment out or set to /dev/null (less effective) to disable
    # Access logging.
    
    AccessLog /etc/boa/access_log

③ 把`#ServerName www.your.org.here`这一行， 修改为`ServerName www.your.org.here`：

# ServerName: the name of this server that should be sent back to
    # clients if different than that returned by gethostname + gethostbyname
    
    ServerName www.your.org.here

④ 然后找到`DocumentRoot /var/www`这一行， 修改为`DocumentRoot /www`：

DocumentRoot /www

⑤ 然后找到`ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/`这一行， 修改为`ScriptAlias /cgi-bin/ /www/cgi-bin/`：

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

上面就是boa.conf配置文件需要修改的几点内容。

最后，进入我们前面创建的 www 目录， 然后使用 `vi index.html` 命令建立 `index.html` 网页文件进行测试，关于简单网页的设计大家可以上网搜一些教程。这里我们设计一个简单的网页如：

<html>
     <head>
      <title>
      boa服务器测试
      </title>
     </head>
     <body style="background-color:#000000;padding-left:300px; padding-top:100px;">
      <p style="color:white; text-align:left; width:190px; height:45px; font-size:30px; font-family:微软雅黑; padding-left:5px;">嵌入式大杂烩</p>
      <p style="color:red; font-size:20px; font-family:微软雅黑;">ZhengN</p>
      <p style="color:yellow; font-size:20px; font-family:微软雅黑; text-align:left;">本公众号专注于嵌入式技术，包括但不限于C/C++、嵌入式、物联网、Linux。</p>
     </body>
    </html>

保存并退出 `index.html`。到了这一步我们的web服务器就大致搭建完成了，服务器上有一个简单的网页文件index.html。

下面进行简单的测试：

在我们的开发板上输入`boa` 命令启动 web 服务器 。

输入 如下命令查看boa程序是否启动成功：

ps - e | grep "boa"

![e1e9f461c93f98a12ddf47c53b384675.png][]

boa 进程启动成功后，在浏览器中输入我们开发板的 IP 地址就可以访问到 index.html 网页：

![5a1931aece08aa2bcbc0bcf18ee9c033.png][]

可见，我们可以通过浏览器访问我们使用开发板搭建的web服务器上的网页，表明我们已经成功在开发板搭建了基于boa的web服务器。

本文只是简单地演示打通开发板web服务器环境并设计了一个简单地网页，后续我们再继续来探究如何通过网页来与我们地开发板进行交互，如：通过网页点亮开发板上地led、把开发板上地一些数据传到网页上进行显示等内容。

\------------ **END** ------------

后台回复『**MCU**』『**嵌入式软件基础知识**』阅读更多相关文章。

**欢迎关注我的公众号，**回复“**加群**”按规则加入技术交流群，回复“**1024**”查看更多内容。

**欢迎关注我的视频号：**

![a365e18910b6fbeb7054bce318de222d.png][]

点击“**阅读原文**”查看更多分享，欢迎**点分享、收藏、点赞、在看。**

[da6c295ac43505be90dda73d3d2e77ca.gif]: /images/20220829/7a94f534cee8439791564aab21413b82.png
[web]: http://mp.weixin.qq.com/s?__biz=MzU5MzcyMjI4MA%3D%3D&chksm=fe0e9453c9791d455fc1207c41d1d26e195a3886f6c5ccf98dd80bf4f3bd96ece821ef295400&idx=1&mid=2247498388&scene=21&sn=9b11c413ad49df3b97bc5415ef50ad2a#wechat_redirect
[eb8dbcd5dc4f8c1e0c3c4c0223a96277.png]: /images/20220829/b05e77e31da34f7ea67de02bc2bfbadd.png
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzU5MzcyMjI4MA%3D%3D&chksm=fe0e9228c9791b3e28521108eb1462ffe2b4afa7daa46ee01d587f57e1a0b6941d7cbe2a203a&idx=1&mid=2247498991&scene=21&sn=b90e7a7d8c1022471811ef356bb78831#wechat_redirect
[0889923d979c92ef03d0986178146ba8.png]: /images/20220829/f6e8d97b5c114ac8876e31c68aa4f9c3.png
[e1e9f461c93f98a12ddf47c53b384675.png]: /images/20220829/841fd4b00a7741daa9851ae175113620.png
[5a1931aece08aa2bcbc0bcf18ee9c033.png]: /images/20220829/0742ec45cc8b460aabf1f65a7276fa1f.png
[a365e18910b6fbeb7054bce318de222d.png]: /images/20220829/894e2c7eb7a04ec78f1146008da36fff.png