linux[armbian]环境安装nginx

落日映苍穹つ 2024-03-17 15:40 74阅读 0赞

#### 文章目录 ####

*  linux\[armbian\]环境安装
 *  常用命令
 *  遇到的问题和解决方法
 *   *  问题一：conf/koi-win复制错误
     *  解决方法
     *  问题二：缺少相关的日志目录
     *  解决方法

## linux\[armbian\]环境安装 ##

1.  下载Nginx：  
    访问\[Nginx官方网站\]（https://nginx.org/)，在下载页面找到最新版本的Nginx。可以选择稳定版本或开发版本，然后点击相应的下载链接。
2.  安装依赖项：  
    在安装Nginx之前，需要安装一些必要的依赖项，例如编译工具和库。对于基于Debian或Ubuntu的系统，可以使用以下命令安装依赖项：
    
        sudo apt update
        sudo apt install build-essential

sudo apt install libpcre3 libpcre3-dev
    	```
    	- 否则，你可能遇到这样的错误
    		- 错误1：HTTP rewrite module需要PCRE库。
    	- 错误：make命令没有找到所需的目标'build'。
    	```bash
    	./configure: error: the HTTP rewrite module requires the PCRE library.
    	You can either disable the module by using --without-http_rewrite_module
    	option, or install the PCRE library into the system, or build the PCRE library
    	statically from the source with nginx by using --with-pcre=<path> option.
    
    	root@armbian:/usr/local/nginx# make
    	make: *** No rule to make target 'build', needed by 'default'.  Stop.
    	```
    ```bash
    sudo apt install zlib1g zlib1g-dev

*  否则，你会遇到这写错误：

./configure: error: the HTTP gzip module requires the zlib library.
    You can either disable the module by using --without-http_gzip_module
    option, or install the zlib library into the system, or build the zlib library
    statically from the source with nginx by using --with-zlib=<path> option.

--------------------

*  编译成功的标志:
    
        Configuration summary
          + using system PCRE library
          + OpenSSL library is not used
          + using system zlib library
        
          nginx path prefix: "/usr/local/nginx"
          nginx binary file: "/usr/local/nginx/sbin/nginx"
          nginx modules path: "/usr/local/nginx/modules"
          nginx configuration prefix: "/usr/local/nginx/conf"
          nginx configuration file: "/usr/local/nginx/conf/nginx.conf"
          nginx pid file: "/usr/local/nginx/logs/nginx.pid"
          nginx error log file: "/usr/local/nginx/logs/error.log"
          nginx http access log file: "/usr/local/nginx/logs/access.log"
          nginx http client request body temporary files: "client_body_temp"
          nginx http proxy temporary files: "proxy_temp"
          nginx http fastcgi temporary files: "fastcgi_temp"
          nginx http uwsgi temporary files: "uwsgi_temp"
          nginx http scgi temporary files: "scgi_temp"
 *  Nginx编译已经成功完成，并且使用了系统的PCRE库和zlib库。下面是一些重要的配置信息：

<table> 
 <thead> 
  <tr> 
   <th>配置项</th> 
   <th>路径/文件</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Nginx路径前缀</td> 
   <td>“/usr/local/nginx”</td> 
  </tr> 
  <tr> 
   <td>Nginx可执行文件路径</td> 
   <td>“/usr/local/nginx/sbin/nginx”</td> 
  </tr> 
  <tr> 
   <td>Nginx模块路径</td> 
   <td>“/usr/local/nginx/modules”</td> 
  </tr> 
  <tr> 
   <td>Nginx配置前缀</td> 
   <td>“/usr/local/nginx/conf”</td> 
  </tr> 
  <tr> 
   <td>Nginx配置文件路径</td> 
   <td>“/usr/local/nginx/conf/nginx.conf”</td> 
  </tr> 
  <tr> 
   <td>Nginx的pid文件路径</td> 
   <td>“/usr/local/nginx/logs/nginx.pid”</td> 
  </tr> 
  <tr> 
   <td>Nginx错误日志文件路径</td> 
   <td>“/usr/local/nginx/logs/error.log”</td> 
  </tr> 
  <tr> 
   <td>Nginx HTTP访问日志文件路径</td> 
   <td>“/usr/local/nginx/logs/access.log”</td> 
  </tr> 
  <tr> 
   <td>Nginx HTTP客户端请求体临时文件目录</td> 
   <td>“client_body_temp”</td> 
  </tr> 
  <tr> 
   <td>Nginx HTTP代理临时文件目录</td> 
   <td>“proxy_temp”</td> 
  </tr> 
  <tr> 
   <td>Nginx HTTP FastCGI临时文件目录</td> 
   <td>“fastcgi_temp”</td> 
  </tr> 
  <tr> 
   <td>Nginx HTTP uWSGI临时文件目录</td> 
   <td>“uwsgi_temp”</td> 
  </tr> 
  <tr> 
   <td>Nginx HTTP SCGI临时文件目录</td> 
   <td>“scgi_temp”</td> 
  </tr> 
 </tbody> 
</table>

这些路径和文件是默认配置下的设置，可以根据需要进行自定义修改。可以编辑`nginx.conf`文件来更改Nginx的监听端口、虚拟主机配置、代理设置等。

--------------------

1.  解压和编译：
    
     *  下载完成后，将下载的Nginx压缩包解压到选择的目录中。
     *  使用命令行进入解压后的目录，然后执行以下命令编译和安装Nginx：

#查看文件的权限
    ls -l configure
    #添加执行权限
    chmod +x configure
    #使用sudo命令以超级用户权限运行
    sudo ./configure
    make
    make install

![在这里插入图片描述][61aa97cc09f542d3a3ebc2a1d8dfb1f2.png]

1.  启动Nginx：  
    编辑完配置文件后，使用以下命令启动Nginx(`/usr/local/nginx`为项目目录)：
    
        sudo /usr/local/nginx/sbin/nginx
2.  验证安装：  
    打开浏览器并访问`http://localhost`，

![在这里插入图片描述][15db2ab080744f3abfdade57478835a6.png]

## 常用命令 ##

cd /usr/local/nginx/sbin/
    ./nginx  启动
    ./nginx -s stop  停止
    ./nginx -s quit  安全退出
    ./nginx -s reload  重新加载配置文件
    ps aux|grep nginx  查看nginx进程

*  要停止Nginx服务器，可以使用以下命令：
    
     *  使用`systemctl`命令（适用于使用systemd的Linux系统，如Ubuntu 16.04+、CentOS 7+等）：
    
        sudo systemctl stop nginx
    
     *  或者使用Nginx自带的执行程序：
    
        sudo /usr/local/nginx/sbin/nginx -s stop
 *  如果使用的是Nginx安装包管理工具（例如apt或yum），可以使用对应的包管理命令：
    
    使用apt（适用于Ubuntu/Debian）：
    
        sudo apt-get remove nginx
    
     *  使用yum（适用于CentOS/RHEL）：
    
        sudo yum remove nginx

## 遇到的问题和解决方法 ##

### 问题一：conf/koi-win复制错误 ###

root@armbian:/usr/local/nginx# make install
    make -f objs/Makefile install
    make[1]: Entering directory '/usr/local/nginx'
    test -d '/usr/local/nginx' || mkdir -p '/usr/local/nginx'
    test -d '/usr/local/nginx/sbin' \
            || mkdir -p '/usr/local/nginx/sbin'
    test ! -f '/usr/local/nginx/sbin/nginx' \
            || mv '/usr/local/nginx/sbin/nginx' \
                    '/usr/local/nginx/sbin/nginx.old'
    cp objs/nginx '/usr/local/nginx/sbin/nginx'
    test -d '/usr/local/nginx/conf' \
            || mkdir -p '/usr/local/nginx/conf'
    cp conf/koi-win '/usr/local/nginx/conf'
    cp: 'conf/koi-win' and '/usr/local/nginx/conf/koi-win' are the same file
    make[1]: *** [objs/Makefile:1212: install] Error 1
    make[1]: Leaving directory '/usr/local/nginx'
    make: *** [Makefile:13: install] Error 2

*  复制`conf/koi-win`文件时目标文件路径和源文件路径相同导致的。
 *  Nginx在编译安装时，并不需要复制`conf/koi-win`文件，因此这个错误并不会影响Nginx的安装和运行。这可能是在编译过程中出现的一个小问题，通常不会影响Nginx的正常使用。

### 解决方法 ###

可以尝试通过以下步骤绕过这个错误：

1.  使用`sudo make`命令编译Nginx，而不要使用`sudo make install`。
2.  编译成功后，手动将编译生成的`objs/nginx`二进制文件复制到`/usr/local/nginx/sbin/nginx`路径中。
3.  手动创建Nginx配置文件目录`/usr/local/nginx/conf`，并确保在该目录下有正确的配置文件，例如`nginx.conf`。

以下是可能的绕过方法：

# 编译Nginx
    sudo make
    
    # 复制编译生成的二进制文件
    sudo cp objs/nginx /usr/local/nginx/sbin/nginx
    
    # 创建配置文件目录（如果目录不存在）
    sudo mkdir -p /usr/local/nginx/conf
    
    # 确保在 /usr/local/nginx/conf 目录下有正确的配置文件，例如 nginx.conf
    
    # 启动Nginx
    sudo /usr/local/nginx/sbin/nginx

### 问题二：缺少相关的日志目录 ###

root@armbian:/usr/local/nginx# sudo cp objs/nginx /usr/local/nginx/sbin/nginx
    root@armbian:/usr/local/nginx# sudo /usr/local/nginx/sbin/nginx
    nginx: [alert] could not open error log file: open() "/usr/local/nginx/logs/error.log" failed (2: No such file or directory)
    2023/07/05 23:51:04 [emerg] 26667#0: open() "/usr/local/nginx/logs/access.log" failed (2: No such file or directory)

*  错误提示表明Nginx在启动时无法打开错误日志文件和访问日志文件。

### 解决方法 ###

*  可能是因为在安装Nginx时缺少了相关的日志目录，或者目录的权限设置不正确。

1.  创建日志目录：  
    首先，确保日志目录`/usr/local/nginx/logs/`已经存在。如果不存在，您可以使用以下命令创建该目录并设置正确的权限：
    
        sudo mkdir -p /usr/local/nginx/logs/ # 结合自己的路径进行灵活修改
        sudo chown -R <your_username>:<your_group> /usr/local/nginx/logs/
    
     *  将`<your_username>`和`<your_group>`替换为您当前用户的用户名和所属用户组。
2.  检查Nginx配置文件：
    
     *  确保您的Nginx配置文件中的错误日志和访问日志的路径正确。
     *  打开Nginx的配置文件`/usr/local/nginx/conf/nginx.conf`，查找并确保以下两行的路径与上面创建的日志目录相匹配：
    
        error_log  /usr/local/nginx/logs/error.log;
        access_log  /usr/local/nginx/logs/access.log;
    
        #user  nobody;
        worker_processes  1;
        
        #error_log  logs/error.log;
        #error_log  logs/error.log  notice;
        #error_log  logs/error.log  info;
        
        #pid        logs/nginx.pid;
3.  启动Nginx：
    
        sudo /usr/local/nginx/sbin/nginx

![在这里插入图片描述][15db2ab080744f3abfdade57478835a6.png]

[61aa97cc09f542d3a3ebc2a1d8dfb1f2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/8d6e7debb8154d4ca88565b97ab5fb01.png
[15db2ab080744f3abfdade57478835a6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/15/928bc06800814f7cbfd08c52483dd627.png