Nginx支持web界面执行bash|python等系统命令和脚本，可以传递参数

步骤总结

1.安装好nginx，假设其html根路径为/usr/share/nginx/html
2.准备工作：关闭防火墙，关闭selinux,安装epel源
3.yum安装依赖包：dh-autoreconf fcgi fcgi-devel
4.源码安装spawn-fcgi和fcgiwrap

（这俩其实也可以直接通过yum方式安装，不过安装后没法通过systemctl的方式启动fcgiwrap，还是得用脚本文件，启动的时候会报错：spawn-fcgi: child exited with: 127，因此还是使用源码安装比较稳妥）

5.配置nginx的location路径
把下载好的linux-shell模板放在nginx的html根路径下，设置用户和用户组为nginx，然后脚本目录文件增加可执行权限,添加location规则

location规则中配置的root是nginx的html根路径，并不是实际程序所在路径，因为执行的时候会在设置root路径也就是nginx的html根路径下查找linux-shell/page/script/(.*)$路径里的文件进行执行。

chown -R nginx:nginx /usr/share/nginx/html/linux-shell cd /usr/share/nginx/html/linux-shell/page/script/ chmod +x */*

location ~ ^/linux-shell/page/script/(.*)$ { gzip off; root /usr/share/nginx/html; fastcgi_pass unix:/var/run/fcgiwrap.socket; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; }

路径：/usr/share/nginx/html下有api文件夹，api文件夹下有一个disk的文件

cd `/usr/share/nginx/html/ chown -R nginx:nginx api chmod a+x api/disk

访问路径是： http://localhost/api/disk ，就会在设置的root路径下，也就是/usr/share/nginx/html路径下找api开头的文件夹，进而找到disk文件进行执行

location ~ ^/api/(.*)$ { gzip off; default_type text/plain; root /usr/share/nginx/html; fastcgi_pass unix:/var/run/fcgiwrap.socket; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; }

如上俩，模板和参数可以合并起来，linux-shell模板可以参考disk里的文件内容写法接收传递过来的参数

使用说明

1，shell命令 | python命令 | 系统支持的都可以
2，不支持交互式显示 | 不支持动态内容显示
3，傻瓜式操作（页面点击链接一次，执行一次脚本内容）|可以设置页面自动刷新，实现重复执行脚本

准备工作

##关闭防火墙 ##（centos6） service iptables stop chkconfig iptables off ##（centos7） systemctl stop firewalld systemctl disable firewalld #关闭selinux sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config setenforce 0 #已有epel源的跳过此步骤，直接安装依赖开始 #centos6 添加epel yum源 wget -O /etc/yum.repos.d/epel-6.repo http://mirrors.aliyun.com/repo/epel-6.repo #centos7 添加epel yum源 wget -O /etc/yum.repos.d/epel-7.repo http://mirrors.aliyun.com/repo/epel-7.repo #清除缓存 重新生成缓存 yum clean all yum makecache

安装依赖包

#安装开发包组和相关的依赖包 yum install dh-autoreconf fcgi fcgi-devel -y

安装spawn-fcgi 和 fcgiwrap

#创建存放包的目录（包下载到哪个目录都可以，这里放在/source/目录下） mkdir /source/ && cd /source/ #安装spawn-fcgi #github下载最新代码 https://github.com/lighttpd/spawn-fcgi 本地下载：wget https://www.jinchuang.org/novel/lnmp/spawn-fcgi.zip 最新版：wget https://github.com/lighttpd/spawn-fcgi/archive/refs/tags/spawn-fcgi-1.6.4.zip 解压：unzip spawn-fcgi-1.6.4.zip 安装： cd spawn-fcgi-spawn-fcgi-1.6.4 ./autogen.sh ./configure make && make install #安装fcgiwrap #github下载最新代码 https://github.com/gnosek/fcgiwrap 本地下载：wget https://www.jinchuang.org/novel/lnmp/fcgiwrap.zip 最新版： wget https://github.com/gnosek/fcgiwrap/archive/refs/tags/1.1.0.zip 解压： unzip 1.1.0.zip 安装: cd fcgiwrap-1.1.0 autoreconf -i ./configure make && make install

创建fcgiwrap启动脚本

【nginx通过转发请求到这里来执行脚本命令】,脚本启动用户要和你nginx启动用户一致，注意下脚本中2个命令的路径是否和你的一致

vim /etc/init.d/fcgiwrap #! /bin/bash ### BEGIN INIT INFO # Provides: fcgiwrap # Required-Start: $remote_fs # Required-Stop: $remote_fs # Should-Start: # Should-Stop: # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: FastCGI wrapper # Description: Simple server for running CGI applications over FastCGI ### END INIT INFO PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin SPAWN_FCGI="/usr/local/bin/spawn-fcgi" DAEMON="/usr/local/sbin/fcgiwrap" NAME="fcgiwrap" PIDFILE="/var/run/$NAME.pid" FCGI_SOCKET="/var/run/$NAME.socket" # 注意：这里跟原文不一样 FCGI_USER="nginx" FCGI_GROUP="nginx" FORK_NUM=5 SCRIPTNAME=/etc/init.d/$NAME case "$1" in start) echo -n "Starting $NAME... " PID=`pidof $NAME` if [ ! -z "$PID" ]; then echo " $NAME already running" exit 1 fi $SPAWN_FCGI -u $FCGI_USER -g $FCGI_GROUP -s $FCGI_SOCKET -P $PIDFILE -F $FORK_NUM -f $DAEMON if [ "$?" != 0 ]; then echo " failed" exit 1 else echo " done" fi ;; stop) echo -n "Stoping $NAME... " PID=`pidof $NAME` if [ ! -z "$PID" ]; then kill `pidof $NAME` if [ "$?" != 0 ]; then echo " failed. re-quit" exit 1 else rm -f $pid echo " done" fi else echo "$NAME is not running." exit 1 fi ;; status) PID=`pidof $NAME` if [ ! -z "$PID" ]; then echo "$NAME (pid $PID) is running..." else echo "$NAME is stopped" exit 0 fi ;; restart) $SCRIPTNAME stop sleep 1 $SCRIPTNAME start ;; *) echo "Usage: $SCRIPTNAME {start|stop|restart|status}" exit 1 ;; esac

启动fcgiwrap服务

增加可执行权限 chmod +x /etc/init.d/fcgiwrap #添加到服务里面（centos6系统执行，centos7跳过此步骤） chkconfig --add fcgiwrap chkconfig --level 2345 fcgiwrap on #启动服务 /etc/init.d/fcgiwrap start Starting fcgiwrap... spawn-fcgi: child spawned successfully: PID: 22416 spawn-fcgi: child spawned successfully: PID: 22417 spawn-fcgi: child spawned successfully: PID: 22418 spawn-fcgi: child spawned successfully: PID: 22419 spawn-fcgi: child spawned successfully: PID: 22420 done

nginx配置转发 （系统安装好nginx）

这一步的含义是下载现成的模板放在一个目录下，然后nginx中配置location路径进行访问

#注意下修改为你的目录路径 #location ~ ^/linux-shell/page/script/.*\.(cgi) { #这里的cgi后缀匹配根据需要修改，后缀自定义即可 # linux-shell 为模板程序目录，放在nginx网站根目录下面 location ~ ^/linux-shell/page/script/ { #我这里调用的文件是没有后缀的就用这个配置 gzip off; fastcgi_pass unix:/var/run/fcgiwrap.socket; # 注意：这里跟原文不一样 root /usr/share/nginx/html; # 注意：这里跟原文不一样，nginx的html目录 include fastcgi_params; fastcgi_param SCRIPT_NAME $document_root/$fastcgi_script_name; # 注意：这里跟原文不一样 } #重启nginx： nginx -s reload

模板目录结构

# 下载模板，放在网站根目录下 # 目录结构： linux-shell ├── css │ ├── iconfont.css │ ├── iconfont.eot │ ├── iconfont.svg │ ├── iconfont.ttf │ ├── iconfont.woff │ ├── iconfont.woff2 │ ├── page.css │ └── style.css ├── favicon.ico ├── images │ ├── b.jpg │ ├── body.cur │ ├── b.png │ ├── content.jpg │ ├── hua.gif │ ├── link.cur │ ├── logo.png │ ├── nav.jpg │ └── page.cur ├── index.html ├── js │ ├── jquery-2.1.1.min.js │ └── nav.js └── page ├── content │ ├── index.html │ ├── script.js │ └── TweenMax.min.js ├── h5 │ ├── 161 │ │ └── 161.html │ ├── 188 │ │ └── 188.html │ └── local │ └── local.html └── script ├── 161 │ ├── disk │ ├── info │ ├── mem │ ├── ps │ ├── server │ ├── ssh │ └── uptime ├── 188 │ ├── disk │ ├── info │ ├── mem │ ├── ps │ ├── server │ ├── ssh │ └── uptime └── local ├── disk ├── info ├── mem ├── ps ├── server ├── ssh └── uptime

shell代码示例文件（查看磁盘使用情况）：

#!/bin/bash echo "Content-Type:text/html;charset=utf-8" echo "" # 自动刷新 #echo "<script>window.setInterval(function(){ # window.location.reload(); #},1000);</script>" #echo "<meta http-equiv="refresh" content="60">" # html页面css样式 echo '<style> body{color:#cecece;} .title{color: #FF9800;border-left: 4px solid;padding: 4px;} pre{font-size:14px;border-left: 4px solid #4CAF50;padding: 5px;} </style>' # 定义变量 ip="192.168.x.x" # 内容代码（命令返回结果放在<pre>标签中） echo '<div style="padding-left:10px;">' echo '<h1 class="title">硬盘使用情况</h1>' echo '<h5 style="color:#848484;">' dd=`date` echo "统计时间: $dd 【当前机器ip: $ip】" echo '</h5>' echo '<pre>' # 查看磁盘使用（本机） df -hT # 查看磁盘使用（远程机器，可以使用ansible|sshpass等远程工具） sshpass -p "password" ssh root@$ip -o StrictHostKeyChecking=no 'df -hT' echo '</pre>'

html模板下载

如果访问弹出下载，先检查fcgiwrap服务是否正常，再检查nginx匹配规则

下载地址：https://files.cnblogs.com/files/sanduzxcvbnm/linux-shell.zip

# 程序html模板使用：(脚本文件要加执行权限，不然会提示403 错误)

cd linux-shell/page/script/ chmod +x */* # 脚本文件说明： # disk 查看硬盘使用情况 # info 提示信息内容 # mem 内存使用情况 # ps 系统进程概览 # server 自定义服务进程查看 # ssh ssh连接用户情况 # uptime 系统负载cpu和内存使用概览

传递参数

nginx配置

location ~ ^/api/(.*)$ { gzip off; default_type text/plain; root /usr/share/nginx/html; fastcgi_pass unix:/var/run/fcgiwrap.socket; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; }

在/usr/share/nginx/html路径下有api文件夹，api文件夹下有一个disk的文件，其内容如下：

#!/bin/sh echo "Content-Type:text/html;charset=utf-8" echo "" for i in a b c; do echo $i done echo "$QUERY_STRING" | awk -F '=' '{print $1}' echo "$QUERY_STRING" | awk -F '=' '{print $2}'

访问测试,用浏览器访问效果是一样的

# curl http://localhost/api/disk a b c

# curl http://10.16.16.101/api/disk?abc=123 a b c abc 123

关于使用nginx用户，不使用root用户的问题

首先，在写fcgiwrap启动脚本文件，也就是/etc/init.d/fcgiwrap的时候里面指定的是nginx用户，这个用户是启动nginx使用的用户是一致的。

若是该脚本文件中使用root用户，启动的时候会报错：

stderr, "spawn-fcgi: I will not set uid to 0

因为用spawn-fcgi 启动不能使用-u root启动FastCGI进程。若是想使用root用户启动，需要修改源代码：
在文件src/spawn-fcgi.c中注释掉一段代码, 总共有三处需要注释

/* if (my_uid == 0) { fprintf(stderr, "spawn-fcgi: I will not set uid to 0\n"); return -1; } */

然后再编译源码进行安装

这样一来spawn-fcgi就行使用root启动了，修改启动脚本，把nginx修改成root,删除使用nginx用户生成的fcgiwrap.socket文件。

还需要修改nginx配置文件中nginx启动使用的用户，也修改为root。

然后重新启动fcgiwrap和nginx，就能实现使用root用户了

写好shell脚本访问报错：An error occurred while parsing CGI reply，nginx日志显示是502 bad gateway

shell脚本开头内容中加上如下：

echo "Content-Type:text/html;charset=utf-8" echo ""

关于传递参数的进一步分析

在nginx的location配置文件中，比如如下：

location ~ ^/api/(.*)$ { gzip off; root /usr/share/nginx/html; fastcgi_pass unix:/var/run/fcgiwrap.socket; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; }

里面有include fastcgi_params;, fastcgi_params文件内容如下：

# cat fastcgi_params fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; fastcgi_param SCRIPT_NAME $fastcgi_script_name; fastcgi_param REQUEST_URI $request_uri; fastcgi_param DOCUMENT_URI $document_uri; fastcgi_param DOCUMENT_ROOT $document_root; fastcgi_param SERVER_PROTOCOL $server_protocol; fastcgi_param REQUEST_SCHEME $scheme; fastcgi_param HTTPS $https if_not_empty; fastcgi_param GATEWAY_INTERFACE CGI/1.1; fastcgi_param SERVER_SOFTWARE nginx/$nginx_version; fastcgi_param REMOTE_ADDR $remote_addr; fastcgi_param REMOTE_PORT $remote_port; fastcgi_param SERVER_ADDR $server_addr; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_NAME $server_name; # PHP only, required if PHP was built with --enable-force-cgi-redirect fastcgi_param REDIRECT_STATUS 200;

看到这一行：fastcgi_param QUERY_STRING $query_string;,联想到接收参数的脚本内容写法，里面同样有变量：$QUERY_STRING:

#!/bin/bash echo "Content-Type:text/html;charset=utf-8" echo "" echo "$QUERY_STRING" | awk -F '=' '{print $1}' echo "$QUERY_STRING" | awk -F '=' '{print $2}'

这就很好理解了， 传递的参数是给变量$QUERY_STRING赋值，然后进一步使用该变量进行其他操作。

从安全性上考虑，nginx的location配置文件中没必要指定引用fastcgi_param文件，可以只配置其中需要使用到的变量参数。比如：

location ~ ^/api/(.*)$ { gzip off; root /usr/share/nginx/html; fastcgi_pass unix:/var/run/fcgiwrap.socket; #include fastcgi_params; fastcgi_param QUERY_STRING $query_string; fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; }

此时，就只能传递参数使用，而不是获取其他默认变量的值了。

举例说明：
nginx的location配置如下：

location ~ ^/api/(.*)$ { gzip off; root /usr/share/nginx/html; fastcgi_pass unix:/var/run/fcgiwrap.socket; include fastcgi_params; #fastcgi_param QUERY_STRING $query_string; fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; }

shell脚本内容如下：

#!/bin/bash echo "Content-Type:text/html;charset=utf-8" echo "" for i in a b c; do echo $i done echo "$QUERY_STRING" | awk -F '=' '{print $1}' echo "$QUERY_STRING" | awk -F '=' '{print $2}' echo "$REQUEST_METHOD" echo "$SCRIPT_NAME" echo "$DOCUMENT_ROOT"

此时访问该脚本内容，结果如下：

# curl http://10.16.16.101/api/disk?name=123 a b c name 123 GET /api/disk /usr/share/nginx/html

若是修改nginx的location配置如下：

location ~ ^/api/(.*)$ { gzip off; root /usr/share/nginx/html; fastcgi_pass unix:/var/run/fcgiwrap.socket; #include fastcgi_params; fastcgi_param QUERY_STRING $query_string; fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name; }

shell脚本内容不变，此时访问该脚本内容，结果如下：

# curl http://10.16.16.101/api/disk?name=123 a b c name 123

可以看到，nginx的location中未被引用的变量则不再输出变量值

nginx和fcgiwrap都配置启动了，但是访问报错，nginx日志中找不到fcgiwrap.socket文件

解决办法：如果把该文件放在/tmp路径下，比如是：/tmp/fcgiwrap.socket,此时就算nginx和fcgiwrap都配置启动了，访问的时候查看nginx日志，会提示找不到/tmp/fcgiwrap.socket文件。
给该文件换个路径就行了，比如上文中说的路径：/var/run/fcgiwrap.socket