Fedora Workstation 36部署Node.js应用后局域网无法访问问题咨询

1. 是否是防火墙拦截请求？ #

大概率是，同时也要检查Node.js应用的绑定地址：

• 防火墙层面：Fedora 36默认使用firewalld，默认会拦截外部对非标准端口的请求。假设你的应用使用3000端口，执行以下命令开放端口并永久生效：

  firewall-cmd --add-port=3000/tcp --permanent
  firewall-cmd --reload
  

• 应用绑定地址：如果代码里写的是app.listen(3000, 'localhost')或app.listen(3000, '127.0.0.1')，应用只会监听本地回环地址，局域网设备无法访问。改成app.listen(3000, '0.0.0.0')（监听所有网卡），或者直接写app.listen(3000)（多数Node.js框架默认绑定0.0.0.0，但部分框架可能例外）。

2. 本地部署的可选方案 #

• 直接后台运行：适合临时测试，用nohup让进程脱离终端运行：

  nohup node app.js &
  

  也可以用screen/tmux创建持久会话，关闭终端后进程仍能保持运行。
• PM2进程管理器：适合生产环境，提供自动重启、日志管理、负载均衡功能：
  1. 安装PM2：npm install -g pm2
  2. 启动应用：pm2 start app.js
  3. 设置开机自启：执行pm2 startup，按提示运行生成的命令即可
• systemd系统服务：原生系统服务，稳定性强，支持开机自启：
  1. 创建服务文件/etc/systemd/system/node-app.service，内容示例：

     [Unit]
     Description=My Node.js Application
     After=network.target
     
     [Service]
     User=your-username  # 替换为你的系统用户名
     WorkingDirectory=/path/to/your/app  # 替换为应用目录路径
     ExecStart=/usr/bin/node app.js  # 可用which node确认node路径
     Restart=always  # 进程崩溃自动重启
     Environment=NODE_ENV=production  # 启用生产环境模式
     
     [Install]
     WantedBy=multi-user.target
     

  2. 重新加载systemd配置：systemctl daemon-reload
  3. 设置开机自启并启动服务：

     systemctl enable node-app
     systemctl start node-app
     

• Docker容器部署：实现环境隔离，迁移方便，避免依赖冲突：
  1. 在应用根目录创建Dockerfile：

     FROM node:18-alpine  # 选择适配的Node.js版本
     WORKDIR /app
     COPY package*.json ./
     RUN npm install --production  # 仅安装生产依赖
     COPY . .
     EXPOSE 3000  # 替换为应用实际端口
     CMD ["node", "app.js"]
     

  2. 构建镜像：docker build -t my-node-app .
  3. 后台运行容器（自动重启）：

     docker run -d -p 3000:3000 --restart=always my-node-app
     

3. 更优部署方式 #

根据需求选择：

• 如果追求原生稳定、无额外依赖：优先选systemd服务+firewalld端口开放，这是Fedora系统最贴合的生产级方案，无需安装第三方工具，由系统层面保障进程运行。
• 如果需要环境隔离、跨机器迁移：推荐Docker容器+内置重启策略，打包好的镜像可在任何支持Docker的机器上直接运行，避免依赖版本兼容问题。
• 无论哪种方案，都要确保：
  • 应用绑定0.0.0.0而非localhost
  • 防火墙开放对应端口
  • 生产环境启用NODE_ENV=production模式，优化性能并禁用调试功能
  • 定期更新Node.js和依赖包，修复安全漏洞

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