应精准配置 server.fs.allow 明确声明可信外部绝对路径,如 resolve(__dirname, '../shared/src'),禁止使用通配符或根目录,避免安全风险。

要让 Vite 开发服务器能安全地访问项目根目录外的资源(比如 monorepo 中其他 workspace 的源码、本地共享库、或公共 mock 数据),关键不是“放开所有限制”,而是**精准配置 server.fs.allow,明确声明哪些外部路径是可信且允许被服务的**。
明确指定可访问的绝对路径
server.fs.allow 接收一个字符串数组,每个元素必须是**绝对路径**(Windows 下如 C:\shared\utils,macOS/Linux 下如 /Users/name/libs/core)。相对路径或通配符(如 ../、**)无效。
- 推荐使用
path.resolve()或fileURLToPath()动态生成,避免硬编码路径 - 例如在
vite.config.ts中:import { defineConfig } from 'vite' import { resolve } from 'path' export default defineConfig({ server: { fs: { allow: [ resolve(__dirname, '../shared/src'), resolve(__dirname, '../../mock-server/public') ] } } }) - Vite 会检查请求路径是否落在这些目录及其子目录内——只允许匹配,不递归扫描整个磁盘
配合 symlink 使用时需额外注意
如果通过符号链接(ln -s 或 Windows junction)将外部目录链接进项目,Vite 默认只校验链接目标的**解析后路径**,但前提是该路径已包含在 allow 列表中。
- 不能只写链接路径本身(如
./@shared),而要写它实际指向的绝对路径 - 若链接指向的路径未加入
allow,即使文件物理上可读,Vite 仍会报is outside of Vite serving allow list - 建议用
fs.realpathSync()验证链接真实路径,再填入配置
避免常见误配导致的安全风险
随意设置 allow: ['/'] 或 allow: [process.cwd() + '/..'] 极其危险——这等于把整个磁盘或父目录树暴露给开发服务器,可能被利用于任意文件读取(如 CVE-2025-30208、CVE-2026-53571 等漏洞)。
- 始终遵循最小权限原则:只加真正需要的路径,一行一个
- Windows 用户特别留意 NTFS 备用数据流(ADS)和 8.3 短名问题,确保敏感文件(如
.env)不在allow路径下,且server.fs.deny保持默认(它已默认拒绝.env*、*.{crt,pem}) - 生产环境无需此配置——
server选项仅在开发模式生效
验证是否生效
配置完成后,可通过以下方式确认:
- 在代码中尝试
fetch('/@fs/your-allowed-path/some.json'),应返回内容而非 403 - 导入语句如
import { x } from '/@fs/C:/shared/utils.ts'应能正常解析和热更新 - 控制台不再出现
is outside of Vite serving allow list报警











