Node.js后端文件下载站仅本地可访问，外部无法下载求助

核心问题 #

用Raspi 5搭建文件下载服务器，前端提交文件路径+静态密码请求下载，后端基于Express实现。当前仅localhost可正常下载，外部设备访问失败；若直接使用app.use(cors())允许所有来源，localhost也会出现**"CORS Request did not succeed"或"Access-Control-Allow-Origin缺失"**错误。

排查方向与解决步骤 #

1. 修正服务器监听地址（最关键）

当前app.listen(PORT)默认仅绑定127.0.0.1（localhost），外部设备无法通过局域网IP连接到服务器。必须修改为监听所有网络接口：

app.listen(PORT, '0.0.0.0', () => {
    console.log(`Server running on http://0.0.0.0:${PORT}`);
    console.log(`Local access: http://localhost:${PORT}`);
    console.log(`LAN access: http://[你的树莓派局域网IP]:${PORT}`); // 比如http://192.168.178.5:3000
});

2. 修复CORS配置

• 测试阶段可使用动态允许Origin的配置，避免因地址遗漏导致的CORS错误：

app.use(cors({
    origin: true, // 自动匹配请求的Origin，替代固定列表
    credentials: true,
    methods: ['GET', 'POST', 'OPTIONS'],
    allowedHeaders: ['Content-Type']
}));

• 若需固定允许的来源，务必保证列表中的地址与前端页面的实际访问地址完全一致（包括协议http/https、IP、端口），比如外部设备前端地址是http://192.168.178.100:8080，必须将其加入origin数组。

3. 开放树莓派的3000端口

外部设备的请求可能被树莓派防火墙拦截，需手动开放端口：

• 若使用ufw防火墙：

sudo ufw allow 3000/tcp
sudo ufw reload

• 若使用iptables：

sudo iptables -A INPUT -p tcp --dport 3000 -j ACCEPT
sudo iptables-save

4. 验证网络连通性

• 在外部设备上ping树莓派局域网IP，确认网络可达：

ping 192.168.178.5 # 替换为你的树莓派IP

• 测试端口是否开放：

telnet 192.168.178.5 3000
# 或用curl
curl -X OPTIONS http://192.168.178.5:3000/download

修改后的完整后端代码 #

const express = require('express');
const cors = require('cors');
const path = require('path');
const fs = require('fs');

const app = express();
const PORT = 3000;
const PASSWORD = "halflife";
const BASE_DIRECTORY = "/home/frissyn/dload/";

// 调整后的CORS配置
app.use(cors({
    origin: true,
    credentials: true,
    methods: ['GET', 'POST', 'OPTIONS'],
    allowedHeaders: ['Content-Type']
}));

app.use(express.json());

app.post('/download', (req, res) => {
    const { filePath, password } = req.body;

    if (password !== PASSWORD) {
        return res.status(403).send("Incorrect password.");
    }

    const resolvedPath = path.resolve(BASE_DIRECTORY, filePath);
    if (!resolvedPath.startsWith(BASE_DIRECTORY)) {
        return res.status(400).send("Invalid file path.");
    }

    fs.access(resolvedPath, fs.constants.F_OK, (err) => {
        if (err) {
            return res.status(404).send("File not found.");
        }

        res.download(resolvedPath, (err) => {
            if (err) {
                res.status(500).send("Failed to download the file.");
            }
        });
    });
});

// 监听所有网络接口
app.listen(PORT, '0.0.0.0', () => {
    console.log(`Server running on http://0.0.0.0:${PORT}`);
    console.log(`LAN access: http://192.168.178.5:${PORT}`); // 替换为你的树莓派实际IP
});

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