在Debian上如何使用Node.js构建API

在Debian系统上搭建一个Node.js API，其实并没有想象中那么复杂。只要跟着下面这几步走，你就能从零开始，跑起一个属于自己的API服务。当然，前提是你得有一台装了Debian的机器，并且已经连上了网络。

1. 安装Node.js和npm

首先，Node.js和npm是必须的。直接用apt安装是最省事的办法：

sudo apt update
sudo apt install nodejs npm

不过，Debian官方源里的Node.js版本往往偏老。如果你希望用上最新的稳定版，推荐走NodeSource的二进制分发库，这样能确保版本够新：

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs

装完之后，可以用 node -v 和 npm -v 确认一下版本，心里有个底。

2. 创建项目目录

找个合适的位置，新建一个项目文件夹，然后进去：

mkdir my-api
cd my-api

这样就把工作空间准备好了。

3. 初始化项目

运行npm init，用 -y 参数跳过所有交互式提问，直接生成一个默认的 package.json：

npm init -y

这个文件会记录项目的元数据，后面安装的依赖也会自动写进去，方便管理。

4. 安装Express框架

Node.js生态里，Express是构建API最常用的框架之一，轻量且灵活。安装它：

npm install express

几秒钟后，node_modules 和 package-lock.json 就出现了，依赖搞定。

5. 创建API服务器

在项目根目录下创建一个 server.js 文件，然后把下面的代码贴进去：

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello World!');
});

app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
});

这段代码启动了一个简单的HTTP服务器，监听3000端口，当访问根路径时返回“Hello World!”。

6. 运行服务器

在终端里执行：

node server.js

你应该会看到输出：Server is running on http://localhost:3000。如果没报错，说明服务器已经跑起来了。

7. 测试API

打开浏览器，访问 http://localhost:3000，或者用Postman、curl等工具发送请求。如果看到“Hello World!”，恭喜，第一个API已经成功响应。

8. 添加更多功能

一个只返回静态文本的API显然不够用。实际项目中，你通常需要处理JSON请求体。这时候可以安装 body-parser 中间件来帮忙：

npm install body-parser

然后在 server.js 中添加如下代码：

const bodyParser = require('body-parser');
app.use(bodyParser.json());

app.post('/api/data', (req, res) => {
  const data = req.body;
  res.json({ message: 'Data received', data });
});

这样一来，你就能接收POST请求中的JSON数据，并返回确认信息了。当然，路由、中间件、错误处理等都可以按需扩展。

9. 部署API

开发完成后，总不能一直开着终端窗口。生产环境里，我们需要一个进程管理器来保证服务持续运行，最常用的是PM2：

npm install pm2 -g
pm2 start server.js --name my-api

PM2会让你的API在后台守护运行，即使终端断开也不会掉线。它还提供了日志查看、自动重启等功能，非常实用。

到这里，你已经走完了在Debian上用Node.js构建API的完整流程。从安装环境到编写代码，再到部署上生产，每一步都清晰可循。接下来，你可以根据具体业务需求，加入数据库连接、身份验证、路由拆分等更复杂的逻辑，把API真正用起来。