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

今年年初打算用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），一切都有待进一步探索和完善。