運行Node.js的IIS擴展iisnode安裝配置筆記

 這篇文章主要介紹了運行Node.js的IIS擴展iisnode安裝配置筆記,iisnode的擴展可以把Node.js程序托管到IIS,托管之後也意味著可以使用IIS裡面的各種功能,需要的朋友可以參考下

   

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