Node.js 本地服务部署、常驻及调用完整笔记

本笔记记录 Node.js 服务的启动、常驻、跨域调用、QPS 限制处理、服务自检及日志管理方法，适合快速查阅和复用。

一、Node 服务启动与访问

启动服务
node server.js

特点：直接启动，终端关闭服务会被销毁。

访问示例：

本地访问：http://localhost:3000/ocr

局域网访问：http://127.0.0.1:3000/ocr 或 http://0.0.0.0:3000/ocr

公网访问：http://公网IP:3000/ocr（需放通防火墙端口）

常见启动问题
错误原因解决方案
net::ERR_CONNECTION_REFUSED 服务未启动或访问地址错误确认 Node 服务已启动，访问地址与监听地址一致
EADDRINUSE 端口被占用修改端口或结束占用进程 lsof -i:3000 / kill

二、跨域调用与 QPS 限制处理

前端调用 Node 服务示例

async function ocrImage(file, retryCount = 0) {
const base64 = await convertImageToBase64(file);
try {
const res = await fetch("http://117.72.99.159:3000/ocr", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ imageBase64: base64 })
});
const data = await res.json();

复制代码

     // QPS限制重试
     if (data.error_code === 18 || /qps|limit/i.test(data.error_msg)) {
         if (retryCount < 5) {
             const waitTime = 5000 * (retryCount + 1); // 5秒、10秒、15秒...
             console.log(`QPS限制，等待 ${waitTime/1000} 秒重试 (${retryCount + 1}/5)`);
             await sleep(waitTime);
             return await ocrImage(file, retryCount + 1);
         } else {
             return { text: "QPS限制，请稍后重试", confidence: 0 };
         }
     }

     const text = data.words_result?.map(w => w.words).join(" ") || "";
     const confidence = data.words_result?.length > 0
         ? data.words_result.reduce((sum, w) => sum + (w.probability || 0.8), 0) / data.words_result.length
         : 0;
     return { text, confidence: Math.round(confidence * 100) };

 } catch (e) {
     console.error("Fetch请求失败:", e);
 }

}

注意：

访问 localhost 仅本机可访问。

访问公网 IP 可实现跨设备访问。

对接口有 QPS 限制需增加重试机制。

三、Node 服务常驻运行

1. 使用 nohup 后台运行

nohup node server.js > server.log 2>&1 &

nohup：忽略终端挂断信号，服务持续运行
server.log：标准输出写入日志
2>&1：标准错误也写入日志
&：后台运行

2. 查看和管理进程

查看日志

tail -f server.log

查看 Node 后台进程

ps aux | grep node

停止服务

kill

3. 监听地址区别

地址	含义	访问范围
localhost/ 127.0.0.1	本机回环	仅本机访问
0.0.0.0	监听所有网络接口	局域网内可访问
公网 IP	外网访问	需开防火墙端口

四、服务自检与问题排查

自检脚本示例（Node 端）

const http = require('http');

function checkService() {
http.get('http://127.0.0.1:3000/test-token', res => {
if(res.statusCode === 200){
console.log('服务运行正常');
} else {
console.error('服务异常:', res.statusCode);
}
}).on('error', (e) => {
console.error('服务未启动或连接失败:', e.message);
});
}

// 每5分钟自检一次
setInterval(checkService, 5 * 60 * 1000);
常见问题与解决
问题原因解决方案
服务断开进程被意外杀死使用 nohup 或 PM2 监控
日志爆满没有轮转机制配合 logrotate 或 PM2 日志管理
QPS限制接口请求过快增加指数退避重试，限制并发请求
防火墙阻塞公网访问失败放通 3000 端口或使用 Nginx 反代

五、日志管理建议

日志输出到文件：

nohup node server.js > server.log 2>&1 &

实时查看：

tail -f server.log

日志轮转：

Linux 可用 logrotate 定期清理
PM2 内置日志管理功能，可自动分割和备份日志
六、总结与优化建议

服务常驻：

nohup 可用，但日志需管理
更推荐使用 PM2 或 Docker 做进程管理与自检

跨域访问：

本机开发用 localhost 或 127.0.0.1
局域网用 0.0.0.0
公网部署需确保 IP、端口、防火墙正确配置

请求限制：

对接口 QPS 限制做指数退避重试
减少请求压力，提升服务稳定性

服务自检：

定时请求自身健康检查接口
异常时可结合脚本重启或告警