运行Node.js的IIS扩展iisnode安装配置笔记

bluedog 发布于2年前
0 条问题

今年年初打算用Node.js基于Express框架重写博客程序,从此告别ASP.NET。然而,我目前用的VPS是Windows Server系统、IIS服务器,如果让Express和IIS都监听80端口,明显会产生冲突。幸好,有一个叫做iisnode的扩展可以把Node.js程序托管到IIS。而且,这样托管之后也意味着可以使用IIS里面的各种功能(进程管理、GZip压缩、日志、缓存、权限控制、域名绑定等)。

要使用iisnode,得安装:

1.Node.js
2.IIS的URL Rewrite模块
3.iisnode

装好之后,还是按照常规操作,在IIS管理器中创建站点,指向Express程序的目录,关键是还要增加一个web.config文件:

 <configuration>
     <system.webServer>
         <handlers>
             <add name="iisnode" path="bin/www" verb="*" modules="iisnode" resourceType="Unspecified" requireAccess="Script" />
         </handlers>
 
        <rewrite>             <rules>                 <rule name="all">                     <match url="/*" />                     <action type="Rewrite" url="bin/www" />                 </rule>             </rules>         </rewrite>     </system.webServer> </configuration> 

这段内容也可以通过IIS管理器的可视化界面配置。大概意思把所有请求重写到bin/www,而且使用iisnode扩展运行bin/www。然而,打开站点后,却出现了这样的错误提示:

 请求筛选模块被配置为拒绝包含 hiddenSegment 节的 URL 中的路径

起初是觉得不明所以,后来突然醒悟,ASP.NET里面的bin目录是个不允许访问的特殊目录。把请求重写到bin/www,恰好命中了这条规则。所以呢,改一下目录名就好了,比如把bin改成launch(事实证明这不是好做法,后面再说),web.config也要对应调整:
 <configuration>
     <system.webServer>
         <handlers>
             <add name="iisnode" path="launch/www" verb="*" modules="iisnode" resourceType="Unspecified" requireAccess="Script" />
         </handlers>
 
        <rewrite>             <rules>                 <rule name="all">                     <match url="/*" />                     <action type="Rewrite" url="launch/www" />                 </rule>             </rules>         </rewrite>     </system.webServer> </configuration> 

在IIS管理器中重启站点后再次访问,终于运行起来了,不容易啊!不过还是高兴得太早了。

在测试程序功能的过程中,竟然发现获取到的IP为空。在Express框架中,IP是通过req.ip获取的,而req.ip又是从请求头的REMOTE_ADDR获取值。通过一段简单的测试代码,发现REMOTE_ADDR的值也为空。很明显,从IIS到Node.js的过程中,这段头信息丢失了。Google一番之后,发现iisnode确有此问题,官方提供的解决方案是使用X-Forword-For,不过我又发现了另外一个办法。

Web.config中有一段配置(加到</system.webServer>前)可以保留REMOTE_ADDR:

 <iisnode promoteServerVars="REMOTE_ADDR" />

根据说明,保留的REMOTE_ADDR会被改名为x-iisnode-REMOTE_ADDR,所以还得把req.ip的值覆盖一次,在Express的app.js中增加一个中间件函数:

 app.use(function(req, res, next) {
     req.ip = req.headers['x-iisnode-REMOTE_ADDR'];
     next();
 });

然而,这样调整后,获取到的IP还是空,这不免让人怀疑,req.ip的赋值是不是失败了。看一下Express的源代码可以发现,req.ip是通过define getter的方式定义的,所以要覆盖它就得再define一次:
 app.use(function(req, res, next) {
     Object.defineProperty(req, 'ip', {
         get: function() { return this.headers['x-iisnode-REMOTE_ADDR']; }
     });
     next();
 });

这样问题终于解决了,但这不是一个好方法,要是以后Express把req.ip设成只读就麻烦了。

继续测试,又发现另外一个问题。正常来说,博客后台的文件上传功能会把文件传到public/upload这个目录下,但实际上却在launch目录(即原来的bin目录)下生成了public/upload文件夹。其实原因是作为程序入口的www文件是在launch目录下,所以launch目录成了应用程序的执行目录。我的解决办法是,把launch目录的名字改回bin,在根目录下创建一个launch.js去调用bin/www:

 #!/usr/bin/env node
 
require('./bin/www'); 

然后把程序入口改为launch.js:

 <configuration>
     <system.webServer>
         <handlers>
             <add name="iisnode" path="launch.js" verb="*" modules="iisnode" resourceType="Unspecified" requireAccess="Script" />
         </handlers>
 
        <rewrite>             <rules>                 <rule name="all">                     <match url="/*" />                     <action type="Rewrite" url="launch.js" />                 </rule>             </rules>         </rewrite> 
        <iisnode promoteServerVars="REMOTE_ADDR" />     </system.webServer> </configuration> 

显然,iisnode还不是一个成熟的产品,当然Node.js也不是(至今还没1.0),一切都有待进一步探索和完善。

需要 登录 后回复方可回复, 如果你还没有账号你可以 注册 一个帐号。