登录
首页 >  文章 >  前端

Node.js搭建服务器教程与配置方法

时间：2026-05-12 10:27:31 261浏览 收藏

想快速搭建一个轻量、无需Apache或Nginx等外部软件的本地服务器？本文手把手教你用Node.js原生模块（http、fs、path）从零开始创建一个功能完备的静态文件服务器——只需安装Node.js、编写不到30行核心代码、添加一个index.html，就能在http://127.0.0.1:3000实时预览页面；更贴心提供nodemon热重启、端口自定义、跨域调试等实用优化技巧，特别适合前端开发预览、API接口模拟和后端入门学习，简单、高效、即学即用。

Node.js怎么搭建服务器_Node.js搭建本地服务器详细步骤与配置方法

想用Node.js搭建一个本地服务器？其实不难。Node.js自带模块就能快速启动HTTP服务，不需要依赖外部软件如Apache或Nginx。下面一步步教你从零开始搭建本地服务器，并完成基本配置。

1. 安装Node.js环境

搭建服务器的前提是本机已安装Node.js。可以按以下步骤操作：

  • 访问官网 https://nodejs.org 下载LTS版本（推荐稳定版）
  • 安装完成后，打开终端或命令行输入：

node -v 和 npm -v

如果显示版本号，说明安装成功。

2. 创建项目目录与初始化

选择一个合适的位置创建文件夹，比如my-server：

  • 在终端进入该目录：cd my-server
  • 运行命令：npm init -y 自动生成package.json文件

这个文件用来记录项目信息和依赖包，是Node.js项目的标准配置。

3. 编写服务器代码

在项目根目录下新建一个文件，比如server.js，内容如下：

const http = require('http');
const fs = require('fs');
const path = require('path');
<p>const hostname = '127.0.0.1';
const port = 3000;</p><p>const server = http.createServer((req, res) => {
let filePath = '.' + req.url;
if (filePath === './') filePath = './index.html';</p><p>const extname = String(path.extname(filePath)).toLowerCase();
const mimeTypes = {
'.html': 'text/html',
'.css': 'text/css',
'.js': 'application/javascript',
'.png': 'image/png',
'.jpg': 'image/jpeg'
};</p><p>const contentType = mimeTypes[extname] || 'application/octet-stream';</p><p>fs.readFile(filePath, (err, content) => {
if (err) {
if (err.code === 'ENOENT') {
res.writeHead(404, { 'Content-Type': 'text/plain' });
res.end('404 - 页面未找到');
} else {
res.writeHead(500);
res.end('500 - 服务器内部错误');
}
} else {
res.writeHead(200, { 'Content-Type': contentType });
res.end(content, 'utf-8');
}
});
});</p><p>server.listen(port, hostname, () => {
console.log(<code>服务器运行在 http://${hostname}:${port}/</code>);
});</p>

这段代码做了这些事：

  • 引入http、fs、path核心模块
  • 监听本地3000端口
  • 根据请求路径读取对应文件并返回
  • 设置正确的MIME类型，让浏览器正确解析HTML、CSS、JS等资源

4. 添加首页文件

为了让服务器有内容可展示，在项目根目录创建index.html：

<!DOCTYPE html>
<html lang="zh">
<head>
  <meta charset="UTF-8" />
  <title>Node.js本地服务器</title>
</head>
<body>
  <h1>欢迎来到Node.js服务器！</h1>
  <p>服务器已成功运行。</p>
</body>
</html>

5. 启动服务器

回到终端，执行命令：

node server.js

看到输出：

服务器运行在 http://127.0.0.1:3000/

打开浏览器访问该地址，就能看到index.html的内容。

6. 常见配置优化

实际使用中可以做一些简单优化：

  • 自动重启：安装nodemon，开发时代码保存后自动重启服务
    命令：npm install -g nodemon，然后用 nodemon server.js 启动
  • 修改端口：把port改为3001、8080等其他可用端口，避免冲突
  • 跨域支持：在res.writeHead中添加：
    'Access-Control-Allow-Origin': '*'（仅开发环境建议）

基本上就这些。Node.js搭建本地服务器核心就是利用http模块创建服务，配合fs读取文件响应请求。适合做静态页面预览、接口模拟或学习后端基础。不复杂但容易忽略细节，比如MIME类型和路径处理。照着上面步骤走一遍，基本都能跑起来。

到这里，我们也就讲完了《Node.js搭建服务器教程与配置方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于js全栈教程的知识点！

js全栈教程
资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>