常怀感恩之心
　　　　　　　　——鲁迅

0、预置条件

这里已假定你已经成功安装了海思平台的交叉编译环境，并能成功编译出海思平台kernel。

小技巧：
可以通过“在shell输入‘arm-’并使用Tab按键来看是否有补全命令列表”来快速确认。

本资料将以arm-hisiv300-linux平台为例，其他平台可以参考此文并做相应修改。

1、源码准备

下载nginx源码

官网下载nginx源码：点我下载，本文档编写将基于次新稳定版本是1.16.1.

下载nginx-rtmp模块[可选]

git clone https://github.com/arut/nginx-rtmp-module.git

如果速度慢，也可以直接: 点我下载 。

下载zlib源码

官网下载zlib源码：点我下载，本文档编写将基于最新稳定版本是1.2.11。

下载openssl源码

官网下载openssl源码：点我下载，本文档编写时最新稳定版本是1.1.1系列。

下载完成，将源码解压到同级目录，参考：
.
├── nginx-1.16.1
├── nginx-rtmp-module-1.2.1
├── openssl-1.1.1c
└── zlib-1.2.11

2、编译配置

打开shell至nginx-1.16.1路径下：

./configure --prefix=/opt/nginx \
--with-zlib=/home/alex/workspace/zlib-1.2.11 \
--with-cc=arm-hisiv300-linux-gcc \
--user=root \
--group=root \
--without-http_rewrite_module \
--without-http_fastcgi_module \
--without-http_charset_module \
--without-http_ssi_module \
--without-http_userid_module \
--add-module=/home/alex/workspace/nginx-rtmp-module-1.2.1 \
--without-http_auth_basic_module \
--without-http_geo_module \
--without-http_map_module \
--without-http_split_clients_module \
--without-http_referer_module \
--without-http_uwsgi_module \
--without-http_scgi_module \
--without-http_memcached_module \
--without-http_memcached_module \
--without-http_limit_conn_module \
--without-http_limit_req_module \
--without-http_empty_gif_module \
--without-http_browser_module \
--without-mail_pop3_module \
--without-mail_imap_module \
--without-mail_smtp_module \
--without-http_upstream_zone_module \
--with-ipv6 \
--with-openssl=/home/alex/workspace/openssl-1.1.1c

注意将"/home/alex/workspace"替换为实际目录，按照参考都在同级目录也可以直接用".."替换，如"--with-openssl=../openssl-1.1.1c"。
如果没有报错，则可以进入下一步。

3、 执行编译

由于nginx对交叉编译支持的不好，需要如下修改以使openssl和zlib正确被交叉环境编译。

修改openssl模块：

编辑auto/lib/openssl/make文件，将54行:

&& ./config --prefix=$ngx_prefix no-shared no-threads $OPENSSL_OPT \\

改为：

&& ./config --prefix=$ngx_prefix no-shared no-asm no-async no-threads --cross-compile-prefix=arm-hisiv300-linux- $OPENSSL_OPT \\
&& sed -i 's/-m64/ /g' Makefile \\

修改zlib模块：

编辑configure文件，在32行添加:

CHOST="arm-hisiv300-linux"

修改完成，最后执行编译：

make

4、 执行make install

sudo make install

完成安装后，你可以在/opt/发现nginx安装目录，一般包含如下内容:
.
├── conf
├── html
├── logs
└── sbin

5、踩过的坑

踩坑一：

问题内容：

checking for C compiler ... found but is not working
./configure: error: C compiler arm-hisiv400-linux-gcc is not found

原因分析：
configure首先会编译一个小测试程序，通过测试其运行结果来判断编译器是否能正常工作，由于交叉编译器所编译出的程序是无法在编译主机上运行的，故而产生此错误。
解决办法：
方法1：
编辑auto/cc/name文件，将21行的“exit 1”注释掉。
方法2：
编辑auto/cc/name文件，将10行的“ngx_feature_run=yes”改为“ngx_feature_run=no”:

ngx_feature_run=no

踩坑二：

问题内容：

checking for int size ...objs/autotest: 1: objs/autotest: Syntax error: word unexpected (expecting ")")
  bytes
./configure: error: can not detect int size

原因分析：
因为cc编译后的程序无法本地执行导致。
解决办法：
编辑auto/types/sizeof文件，将15行的“ngx_size=”改为“ngx_size=4”，

ngx_size=4

将39行的eval "NGX_AUTOCONF_ERR 2>&1"注释掉:

#eval "$ngx_test >> $NGX_AUTOCONF_ERR 2>&1"

踩坑三：

问题内容：

src/os/unix/ngx_errno.c:58:11: error: ‘NGX_SYS_NERR’ undeclared (first use in this function)
     len = NGX_SYS_NERR * sizeof(ngx_str_t);
           ^
objs/Makefile:708: recipe for target 'objs/src/os/unix/ngx_errno.o' failed

原因分析：
因为交叉编译程序无法本地运行，导致NGX_SYS_NERR宏没有赋值。
解决办法：
编辑objs/ngx_auto_config.h文件，在:

#ifndef NGX_COMPILER
#define NGX_COMPILER  "gcc 4.8.3 20131202 (prerelease) (Hisilicon_v300) "
#endif

行后添加：

#ifndef NGX_SYS_NERR
#define NGX_SYS_NERR  132
#endif

踩坑四：

问题内容：

objs/src/core/ngx_cycle.o: In function 'ngx_init_cycle':
/home/src/nginx-1.14.0/src/core/ngx_cycle.c:476: undefined reference to 'ngx_shm_alloc'
/home/src/nginx-1.14.0/src/core/ngx_cycle.c:685: undefined reference to 'ngx_shm_free'

原因分析：
因为交叉编译程序无法本地运行，导致NGX_HAVE_SYSVSHM宏没有赋值。
解决办法：
编辑objs/ngx_auto_config.h文件，在:

#ifndef NGX_COMPILER
#define NGX_COMPILER  "gcc 4.8.3 20131202 (prerelease) (Hisilicon_v300) "
#endif

行后添加：

#ifndef NGX_HAVE_SYSVSHM
#define NGX_HAVE_SYSVSHM 1
#endif

参考文章：

1、 Nginx mips交叉编译总结
2、 交叉编译Hi3536上面使用的nginx
3、 海思Rtmp之Nginx和ffmpeg的移植
4、 嵌入式hi3516-hi3518海思平台移植nginx-1.12.2