Vite 启动报错:listen EACCES: permission denied 0.0.0.0:80 解决方案

目录

  • [Vite 启动报错:listen EACCES: permission denied 0.0.0.0:80 解决方案](#Vite 启动报错:listen EACCES: permission denied 0.0.0.0:80 解决方案)

Vite 启动报错:listen EACCES: permission denied 0.0.0.0:80 解决方案

一、问题现象

在 Linux(如 Ubuntu)环境中运行 RuoYi 前端项目时,执行:

bash 复制代码
npm run dev

出现如下错误:

bash 复制代码
error when starting dev server:
Error: listen EACCES: permission denied 0.0.0.0:80
    at Server.setupListenHandle [as _listen2] (node:net:1886:21)
    at listenInCluster (node:net:1965:12)
    at Server.listen (node:net:2067:7)
    at httpServer.listen (file:///media/roc/Data/Documents/WorkSapce/webstorm/xxxxxx/node_modules/vite/dist/node/chunks/dep-D4NMHUTW.js:38758:14)

二、错误原因

该错误表示:

  • 开发服务器尝试监听 80 端口
  • 当前用户权限不足
  • Linux 系统中 1024 以下端口属于系统保留端口
  • 只有 root 用户可以使用这些端口

因此普通用户运行 Vite 时会报错。


三、解决方案

方案一(推荐):修改开发端口

开发环境不建议使用 80 端口,可以改为 3000 或 5173。

方法 1:修改 .env 文件

找到:

复制代码
.env.development

修改为:

复制代码
VITE_PORT=5173

或:

复制代码
VITE_PORT=3000

然后重新启动:

bash 复制代码
npm run dev

方法 2:修改 vite.config.js

示例:

js 复制代码
export default {
  server: {
    port: 5173,
    host: '0.0.0.0'
  }
}

方案二(不推荐):使用 sudo

可以临时解决:

bash 复制代码
sudo npm run dev

但不推荐,原因:

  • 权限过高存在安全风险
  • 容易导致 node_modules 权限混乱
  • 可能影响后续开发

方案三(高级):给 Node 授权

如果必须使用 80 端口:

bash 复制代码
sudo setcap 'cap_net_bind_service=+ep' $(which node)

适用于特殊场景或服务器环境。


四、总结

该问题本质是:

普通用户没有权限监听 1024 以下端口。

最简单有效的解决方式是:

✔ 修改 Vite 开发端口为 3000 或 5173。

相关推荐
Flynt2 小时前
AI 写的 Three.js 大屏,为什么越跑越卡?我在 Node 里复现了它的内存曲线
前端·ai编程·three.js
无忧.芙桃3 小时前
Linux系统编程(四):用户与权限管理
linux·运维·服务器
一个游离的指针4 小时前
Vue2:vue-router
前端·javascript·vue.js
千寻技术帮5 小时前
10454_基于Springboot的企业购销链管理系统
spring boot·mysql·vue·毕业设计·进销存
戊本菌6 小时前
进程(三)进程优先级:谁先上 CPU
linux·c语言·硬件架构
aningx6 小时前
Arch 系用 greetd 实现开机自动进 Plasma Wayland,注销自动回桌面
linux
火山引擎和TA的超级拍档们7 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
JavaGuide7 小时前
Gemini 真的变强了,写代码做视频的能力接近 Claude Opus5.5 了!
前端·ai编程
niceyayale7 小时前
WebRTC 延迟怎么调试:从 ICE 到 jitter buffer 的六个观测点
前端
aleimu7 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端