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

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

1. 安装iisnode

第一步，下载iisnode

iisnode可以从官方网站下载得到： https://github.com/tjanczuk/iisnode

第二步，安装iisnode

双击iisnode.msi开始安装程序，一路点击“下一步”，直到安装成功。

1. 配置IIS

第一步，启用IIS

在“控制面板” -> “程序” -> “程序和功能” -> “打开或关闭Windows功能”中，启用IIS。

第二步，添加iisnode模块

在IIS Manager中添加一个模块到服务器上的任何网站，步骤为：

• 选中“服务器节点”并点击“Modules”。
• 点击“Configure Native Modules”。
• 点击“Register New Module”按钮。
• 将“Module Name”设置为"iisnode"。
• 将“Image”设置为iisnode的安装目录。
• 点击“OK”按钮，完成注册iisnode的模块。

第三步，添加IIS网站

在IIS Manager中添加一个网站，步骤为：

• 在IIS管理器中右键点击“Sites”节点，选择“Add Website”。
• 指定网站名称和物理路径。
• 在“输入绑定”中添加绑定ip和端口信息。

第四步，配置iisnode的web.config

在网站实际的物理目录下添加web.config文件，其中必须包含以下XML配置：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="iisnode" path="your-app.js" verb="*" modules="iisnode"/>
    </handlers>
    <rewrite>
      <rules>
        <rule name="your-app">
          <match url="your-app/.*"/>
          <action type="Rewrite" url="your-app.js"/>
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

上述代码示例验证，定义了一个名为"iisnode"的处理程序，处理“your-app.js”文件类型的请求。接下来在rewrite中定义了一个规则，仅能匹配"url/your-app"，并从服务器配置iis重写url到“your-app.js”。

1. 示例说明

假设我们有一个名为"test-app"的Node.js应用程序，其执行入口文件名为"app.js"。以下是如何配置iisnode以运行此应用程序的步骤示例：

第一步，添加iisnode模块

打开IIS Manager，在服务器节点中单击Modules，配置iisnode模块。

第二步，创建IIS网站

右键单击Sites，选择Add Website，填写网站名称和物理路径。下面的示例中，网站名称为"test-site"，物理路径为"C:\websites\test-site"。

第三步，将应用程序复制到网站的物理路径中

将"test-app"文件夹中的所有内容复制到网站的物理路径中。由于应用程序的执行入口是“app.js”，所以必须将应用程序重命名为"app.js"。

第四步，修改iisnode的web.config

在网站的物理路径中创建web.config文件，并将以下内容复制粘贴到web.config中：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <handlers>
       <add name="iisnode" path="app.js" verb="*" modules="iisnode"/>
    </handlers>
    <rewrite>
      <rules>
        <rule name="test-site">
          <match url="test-site/.*"/>
          <action type="Rewrite" url="app.js"/>
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

第五步，测试iisnode是否正确安装和配置

在浏览器中输入"http://localhost/test-site/"，如果成功看到"Hello World"字样，则说明iisnode已经安装和配置成功。