如何在Azure Linux上将子文件夹设为Web应用根目录

一、替代 .htaccess 的根目录配置方法 #

针对Azure Linux Web App，有几种更适配平台特性的方式来将dist设为应用根目录，无需依赖.htaccess：

1. 通过 .deployment 文件指定部署目标 #

在本地项目根目录的.deployment文件中添加以下配置，让Azure部署流程自动将dist作为应用运行的根目录：

[config]
DEPLOYMENT_TARGET = dist

部署完成后，Azure会将dist内的文件作为应用根目录内容，同级的node_modules会保留在根目录的上级路径中。

2. 配置启动命令指定运行目录 #

进入Azure门户的应用服务配置 > 常规设置，在「启动命令」中直接指定从dist目录启动服务，以Node.js应用为例：

node dist/server.js

这种方式无需修改部署路径，而是让服务进程直接从dist目录启动，逻辑上等同于将dist作为运行根目录。

3. 使用PM2配置文件（适用于PM2管理的应用） #

如果你的应用通过PM2管理进程，在项目根目录创建ecosystem.config.js，通过cwd字段指定运行目录为dist：

module.exports = {
  apps: [{
    name: 'your-app-name',
    script: 'server.js',
    cwd: './dist'
  }]
};

然后将启动命令设置为pm2 start ecosystem.config.js，PM2会自动切换到dist目录启动服务。

二、dist设为根目录后的路径有效性与服务器拦截问题 #

1. 相对路径的有效性 #

你代码中的import Password from '../../../node_modules/path/to/components/forms/field-types/Password';需要结合部署后的目录结构验证：

• 假设构建后目标文件位于dist/a/b/c.js，且dist与node_modules为同级目录；
• 当dist设为应用根目录时，../../../node_modules会解析为根目录的上级路径（即node_modules所在目录），只要代码构建后的路径层级与开发时一致，该相对路径就能正确指向目标文件。

2. 服务器拦截情况 #

• 服务器端导入（Node.js代码）：这是本地文件系统的读取操作，Azure Linux App Service默认不会拦截内部文件读取，只要node_modules目录权限为可读（默认部署后权限正常），就能正常加载组件。
• 客户端浏览器导入：浏览器会将相对路径解析为跨目录的资源请求，此时需要确保服务器允许访问应用根目录外的node_modules资源。如果使用Apache，可通过.htaccess添加允许规则；如果是NGINX，可通过自定义启动脚本修改配置。但更推荐将客户端依赖打包到dist的bundle文件中，避免直接暴露node_modules，降低安全风险和路径问题。

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