如何在Windows Server 2022的IIS上部署Remix框架应用？

前期准备 #

• 本地完成Remix项目构建：执行 npm run build
• 将构建产物（build、public文件夹，package.json、node_modules等）上传至Windows Server的目标目录，例如 C:\inetpub\wwwroot\my-remix-app

IIS必需组件安装 #

确保Windows Server 2022已安装以下组件：

• 通过服务器管理器添加Web服务器（IIS）及基础组件，勾选应用程序开发分类下的CGI
• 安装URL重写模块
• 安装iisnode模块（用于在IIS中托管Node.js应用）

IIS站点配置 #

1. 打开IIS管理器，右键「网站」→「添加网站」：
   • 站点名称：自定义（如MyRemixApp）
   • 物理路径：选择项目上传的根目录
   • 绑定：设置端口（如80）及主机名（按需配置）
2. 右键站点→「管理网站」→「高级设置」，将「应用程序池」切换至无托管代码的应用程序池（若没有则新建一个，.NET CLR版本选「无托管代码」）

web.config配置 #

在项目根目录创建web.config文件，内容如下：

<configuration>
  <system.webServer>
    <handlers>
      <add name="iisnode" path="build/index.js" verb="*" modules="iisnode" />
    </handlers>
    <rewrite>
      <rules>
        <rule name="Remix App Server" stopProcessing="true">
          <match url="/*" />
          <action type="Rewrite" url="build/index.js" />
        </rule>
      </rules>
    </rewrite>
    <iisnode nodeProcessCommandLine="C:\Program Files\nodejs\node.exe" />
  </system.webServer>
</configuration>

注意：nodeProcessCommandLine需指向服务器上Node.js的实际安装路径

应用程序池权限配置 #

1. 在IIS管理器中找到对应应用程序池，右键→「高级设置」
2. 将「标识」设置为LocalSystem或拥有项目目录读写权限的账户
3. 若安装的是64位Node.js，将「启用32位应用程序」设为False

测试部署 #

启动站点，访问绑定的地址验证应用是否正常加载。若出现错误，可查看IIS日志或项目目录下iisnode文件夹内的日志排查问题

内容的提问来源于stack exchange，提问作者cancan