如何将 Node.js 应用程序作为后台服务运行？

Question

由于多年来这篇文章引起了很多关注，我在这篇文章的底部列出了每个平台的顶级解决方案。

---

原帖：

我希望我的node.js 服务器在后台运行，即：当我关闭终端时，我希望我的服务器继续运行。我用谷歌搜索了这个并想出了这个教程，但是它不起作用正如预期的那样。因此，我没有使用该守护程序脚本，而是认为我只是使用了输出重定向（2>&1>>文件部分），但这也不会退出 - 我得到一个空行在我的终端中，就像它正在等待输出/错误一样。

我还尝试将进程置于后台，但是一旦我关闭终端，该进程也会被终止。

那么当我关闭本地计算机时如何让它继续运行呢？

---

顶级解决方案：

• Systemd (Linux)
• 启动 (Mac)
• node-windows (Windows)
• PM2 (Node.js)

Answer 1

从 复制我自己的答案我应该将 Node.js 应用程序作为自己的进程运行吗？

2015 年答案：几乎每个 Linux 发行版都附带 systemd，这意味着 forever、monit、PM2 等不再是必要的 - 您的操作系统已经处理这些任务。

创建一个 myapp.service 文件（显然，将“myapp”替换为您的应用程序名称）：

[Unit]
Description=My app

[Service]
ExecStart=/var/www/myapp/app.js
Restart=always
User=nobody
# Note Debian/Ubuntu uses 'nogroup', RHEL/Fedora uses 'nobody'
Group=nogroup
Environment=PATH=/usr/bin:/usr/local/bin
Environment=NODE_ENV=production
WorkingDirectory=/var/www/myapp

[Install]
WantedBy=multi-user.target

如果您是 Unix 新手，请注意： /var/www/ myapp/app.js 应该在第一行有 #!/usr/bin/env 节点 并打开可执行模式 chmod +x app.js.

将您的服务文件复制到 /etc/systemd/system 中。

使用systemctl start myapp启动它。

使用 systemctl enable myapp 使其能够在启动时运行。

使用 journalctl -u myapp 查看日志

这取自我们如何在 Linux 2018 版上部署节点应用程序，其中还包括生成 AWS/DigitalOcean/Azure CloudConfig 来构建 Linux/ 的命令/节点服务器（包括 .service 文件）。

Answer 2

更新 - 正如下面的一个答案中提到的，PM2 有一些非常好的功能永远缺失。考虑使用它。

原始答案

使用nohup：

nohup node server.js &

编辑我想补充一点，接受的答案确实是要走的路。我在需要保持运行状态的实例上使用forever。我喜欢执行 npm install -g permanent 因此它位于节点路径中，然后执行 forever start server.js

Answer 3

您可以使用 Forever，这是一个简单的 CLI 工具，用于确保给定的节点脚本连续运行（即永远）：
https://www.npmjs.org/package/forever

Answer 4

这可能不是公认的方式，但我用屏幕来做到这一点，特别是在开发过程中，因为我可以在必要时将其恢复并愚弄它。

screen
node myserver.js
>>CTRL-A then hit D

屏幕将分离并在您注销后继续存在。然后你可以通过 screen -r 将其恢复。点击屏幕手册了解更多详细信息。如果您愿意，您可以为屏幕命名等等。

Answer 5

2016 年更新：
node-windows/mac/linux系列使用跨所有操作系统的通用API，因此它绝对是一个相关的解决方案。然而; node-linux 生成 systemv 初始化文件。随着 systemd 的不断普及，它实际上是 Linux 上更好的选择。如果有人想为 node-linux 添加 systemd 支持，欢迎 PR :-)

原始线程：

这是一个非常旧的线程，但是 node-windows 提供了另一种在 Windows 上创建后台服务的方法。它大致基于在节点脚本周围使用 exe 包装器的 nssm 概念。然而;它使用 winsw.exe 来代替，并提供一个可配置的节点包装器，以便更精细地控制进程在失败时如何启动/停止。这些进程与任何其他服务一样可用：

该模块还包含一些事件日志记录：

守护进程化脚本是通过代码完成的。例如：

var Service = require('node-windows').Service;

// Create a new service object
var svc = new Service({
  name:'Hello World',
  description: 'The nodejs.org example web server.',
  script: 'C:\\path\\to\\my\\node\\script.js'
});

// Listen for the "install" event, which indicates the
// process is available as a service.
svc.on('install',function(){
  svc.start();
});

// Listen for the "start" event and let us know when the
// process has actually started working.
svc.on('start',function(){
  console.log(svc.name+' started!\nVisit http://127.0.0.1:3000 to see it in action.');
});

// Install the script as a service.
svc.install();

该模块支持诸如限制重新启动（因此糟糕的脚本不会破坏您的服务器）和增加重新启动之间的时间间隔等功能。

由于节点窗口服务与其他服务一样运行，因此可以使用您已经使用的任何软件来管理/监视服务。

最后，没有 make 依赖项。换句话说，简单的 npm install -g node-windows 就可以了。您不需要 Visual Studio、.NET 或 node-gyp magic 来安装它。此外，它还获得了 MIT 和 BSD 许可。

坦白说，我是这个模块的作者。它旨在减轻 OP 所经历的确切痛苦，但更紧密地集成到操作系统已提供的功能中。我希望未来有同样问题的观众会发现它很有用。

Answer 6

如果您只是想不间断地运行脚本直到完成，您可以使用 nohup （如此处答案中已提到的）。但是，没有一个答案提供同时记录 stdin 和 stdout 的完整命令。

nohup node index.js >> app.log 2>&1 &

• >> 表示附加到 app.log。
• 2>&1 确保错误也发送到 stdout 并添加到 app.log 中。
• 结尾的 & 确保您当前的终端与命令断开连接，以便您可以继续工作。

如果您想运行节点服务器（或者在服务器重新启动时应该启动备份的东西），您应该使用 systemd / systemctl。

Answer 7

更新：我更新了 pm2 的最新内容：

对于许多用例，使用 systemd 服务是管理节点进程的最简单、最合适的方法。对于那些在单一环境中运行大量节点进程或独立运行的节点微服务的人来说，pm2 是一个功能更齐全的工具。

https://github.com/unitech/pm2

http://pm2.io

• 它有一个非常有用的监控功能 ->漂亮的“gui”，用于使用 pm2 monit 命令行监控多个进程，或使用 pm2 list
• 组织日志管理进程列表 -> pm2 记录
• 其他内容：

  <块引用>

  • 行为配置
  • 源地图支持
  • 兼容 PaaS
  • 观看与观看重新加载
  • 模块系统
  • 最大内存重新加载
  • 集群模式
  • 热重载
  • 开发工作流程
  • 启动脚本
  • 自动完成
  • 部署工作流程
  • 关键指标监控
  • API

Answer 8

如果您正在使用nohup，请尝试运行此命令 -

nohup npm start 2>/dev/null 1>/dev/null&

您也可以使用forever来启动服务器

forever start -c "npm start" ./ 

PM2也支持npm start

pm2 start npm -- start

Answer 9

如果您运行的是 OSX，那么生成真正的系统进程的最简单方法是使用 launchd 来启动它。

构建一个像这样的 plist，并将其放入 /Library/LaunchDaemons 中，名称为 top-level-domain.your-domain.application.plist （放置时您需要是 root）

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>top-level-domain.your-domain.application</string>

    <key>WorkingDirectory</key>
    <string>/your/preferred/workingdirectory</string>

    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/node</string>
        <string>your-script-file</string>
    </array>

    <key>RunAtLoad</key>
    <true/>

    <key>KeepAlive</key>
    <true/>

</dict>
</plist>

：完成后，发出此命令（以 root 身份）：

launchctl load /Library/LaunchDaemons/top-level-domain.your-domain.application.plist
launchctl start top-level-domain.your-domain.application

然后您就可以运行了。

重新启动后您仍将运行。

有关 plist 中的其他选项，请查看此处的手册页： https://developer.apple.com/library/mac/documentation/Darwin/Reference/Manpages/man5/launchd.plist.5.html

Answer 10

我只是使用 daemon npm 模块：

var daemon = require('daemon');

daemon.daemonize({
    stdout: './log.log'
  , stderr: './log.error.log'
  }
, './node.pid'
, function (err, pid) {
  if (err) {
    console.log('Error starting daemon: \n', err);
    return process.exit(-1);
  }
  console.log('Daemonized successfully with pid: ' + pid);

  // Your Application Code goes here
});

最近我也在使用 mon(1)< /a> 来自 TJ Holowaychuk 用于启动和管理简单的节点应用程序。

Answer 11

我使用 Supervisor 进行开发。它就是有效的。当您对 .js 文件进行更改时，Supervisor 会自动重新启动您的应用程序并加载这些更改。

这是其 Github 页面的链接

安装：

sudo npm install Supervisor -g

您可以使用 -e 轻松使其监视其他扩展。我经常使用的另一个命令是 -i 来忽略某些文件夹。

您可以使用 nohup 和 Supervisor 使您的节点应用程序在后台运行，即使在您注销后也是如此。

sudo nohup Supervisor myapp.js &

Answer 12

Node.js 作为 WINDOWS XP 中的后台服务

• 感谢 Hacksparrow，网址为：http://www.hacksparrow.com/install-node-js-and-npm-on-windows.html 了解为 Windows 安装 Node.js + npm 的教程。
• 向 Tatham Oddie 致敬：http://blog.tatham。 oddie.com.au/2011/03/16/node-js-on-windows/ 用于 nnsm.exe 实现。

安装：

1. 通过安装程序可执行文件安装 WGET http://gnuwin32.sourceforge.net/packages/wget.htm
2. 安装 GIT http://code.google.com/p/msysgit/downloads/list 通过安装程序可执行文件
3. 安装 NSSM http://nssm.cc/download/?page=download 通过将 nnsm.exe 复制到 %windir%/system32文件夹

4. 创建c:\node\helloworld.js

   // http://howtonode.org/hello-node
   var http = require('http');
   var server = http.createServer(function (请求, 响应) {
       response.writeHead(200, {"Content-Type": "text/plain"});
       响应.end("你好世界\n");
   });
   服务器.听(8000);
   console.log("服务器运行在http://127.0.0.1:8000/");
   

5. 打开命令控制台并键入以下内容（仅当安装了资源工具包时才使用 setx）

   C:\node>设置路径=%PATH%;%CD%
   C:\节点> setx 路径“%PATH%”
   C:\节点>设置 NODE_PATH="C:\Program Files\nodejs\node_modules"
   C:\节点> git config --system http.sslcainfo /bin/curl-ca-bundle.crt    
   C:\节点> git clone --recursive git://github.com/isaacs/npm.git    
   C:\节点> cd npm    
   C:\node\npm> Node cli.js 安装 npm -gf   
   C:\节点>光盘 ..    
   C:\节点> nssm.exe 安装node-helloworld "C:\Program Files\nodejs\node.exe" c:\node\helloworld.js    
   C:\节点>网络启动节点-helloworld
   

6. 一个漂亮的批处理好东西是创建 c:\node\ServiceMe.cmd

   @echo 关闭
   nssm.exe 安装节点-%~n1 "C:\Program Files\nodejs\node.exe" %~s1
   网络起始节点-%~n1
   暂停
   

服务管理：

• 现在可以通过“开始”->“服务”访问服务本身。运行->
  services.msc 或通过“开始”->“运行”->“ MSCONFIG->服务（并选中“隐藏
  所有 Microsoft 服务'）。
• 该脚本将为通过批处理脚本创建的每个节点添加前缀
  '节点-'。
• 同样，它们可以在注册表中找到：“HKLM\SYSTEM\CurrentControlSet\Services\node-xxxx”

Answer 13

接受的答案可能是最好的生产答案，但是对于进行开发工作的快速破解，我发现：

nodejs scriptname.js & 不起作用，因为 nodejs 似乎吞噬了 & ，所以这件事不允许我继续使用终端而不导致 scriptname.js 死亡。

但我将 nodejs scriptname.js 放在 .sh 文件中，并且
nohup sh startscriptname.sh & 有效。

绝对不是生产问题，但它解决了“我需要继续使用我的终端并且不想启动 5 个不同的终端”问题。

Answer 14

2017 年 6 月更新：
Linux 的解决方案：（红帽）。以前的评论对我不起作用。
这对我在 Amazon Web Service - Red Hat 7 上有用。希望这对其他人有用。

A. Create the service file 
sudo vi /etc/systemd/system/myapp.service
[Unit]
Description=Your app
After=network.target

[Service]
ExecStart=/home/ec2-user/meantodos/start.sh
WorkingDirectory=/home/ec2-user/meantodos/

[Install]
WantedBy=multi-user.target

---

B. Create a shell file
/home/ec2-root/meantodos/start.sh
#!/bin/sh -
sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to 8080
npm start

then:
chmod +rx /home/ec2-root/meantodos/start.sh
(to make this file executable)

---

C. Execute the Following

sudo systemctl daemon-reload
sudo systemctl start myapp
sudo systemctl status myapp

(If there are no errors, execute below.  Autorun after server restarted.)
chkconfig myapp -add

Answer 15

如果你在linux服务器上运行nodejs，我认为这是最好的方法。

创建服务脚本并复制到 /etc/init/nodejs.conf

启动服务： sudo service nodejs start

停止服务： sudo service nodejs stop

服务脚本

description "DManager node.js server - Last Update: 2012-08-06"
author      "Pedro Muniz - [email protected]"

env USER="nodejs" #you have to create this user 
env APPNAME="nodejs" #you can change the service name
env WORKDIR="/home/<project-home-dir>" #set your project home folder here
env COMMAND="/usr/bin/node <server name>" #app.js ?

# used to be: start on startup
# until we found some mounts weren't ready yet while booting:
start on started mountall
stop on shutdown

# Automatically Respawn:
respawn
respawn limit 99 5

pre-start script
    sudo -u $USER echo "[`date -u +%Y-%m-%dT%T.%3NZ`] (sys) Starting" >> /var/log/$APPNAME.log
end script

script
    # Not sure why $HOME is needed, but we found that it is:
    export HOME="<project-home-dir>"  #set your project home folder here
    export NODE_PATH="<project node_path>"

    #log file, grant permission to nodejs user
    exec start-stop-daemon --start --make-pidfile --pidfile /var/run/$APPNAME.pid --chuid $USER --chdir $WORKDIR --exec $COMMAND >> /var/log/$APPNAME.log 2>&1
end script

post-start script
   # Optionally put a script here that will notifiy you node has (re)started
   # /root/bin/hoptoad.sh "node.js has started!"
end script

pre-stop script
    sudo -u $USER echo "[`date -u +%Y-%m-%dT%T.%3NZ`] (sys) Stopping" >> /var/log/$APPNAME.log
end script

Answer 16

我有点晚了。简单的解决方案是在终端中执行以下两个命令，如下所示。

nohup node ./server.js &
disown -h %1 

然后关闭 ssh 会话，节点程序继续运行。在 Ubuntu 18 上测试。

Answer 17

使用 nssm Windows 最佳解决方案，只需下载 nssm，打开 cmd 到 nssm 目录并键入

nssm install <service name> <node path> <app.js path> 

eg: nssm install myservice "C:\Program Files\nodejs" "C:\myapp\app.js" 

此命令将安装一个新的 Windows 服务，该服务将在 services.msc 中列出，您可以从那里启动或停止该服务，该服务将自动启动，您可以配置在失败时重新启动。

Answer 18

使用pm2模块。 pm2 Nodejs 模块

Answer 19

由于我在提供的答案列表中缺少此选项，因此我想在 2020 年添加一个符合条件的选项： docker 或任何同等内容 容器平台。除了确保您的应用程序在稳定的环境中运行之外，还有其他安全优势以及改进的可移植性。

Windows、macOS 和大多数/主要 Linux 发行版都支持 docker。 在受支持的平台上安装 docker 相当简单且有详细记录。设置 Node.js 应用程序非常简单，只需将其放入容器中并运行该容器，同时确保其在关闭后重新启动。

创建容器映像

假设您的应用程序在该服务器上的 /home/me/my-app 中可用，请创建一个文本文件 Dockerfile 位于文件夹 /home/me 中，内容与此类似：

FROM node:lts-alpine
COPY /my-app/ /app/
RUN cd /app && npm ci
CMD ["/app/server.js"]

它正在创建一个用于运行的映像Alpine Linux 下 Node.js 的 LTS 版本，将应用程序的文件复制到映像中并运行 npm ci 以确保依赖项与运行时上下文匹配。

在包含内容的同一文件夹中创建另一个文件 .dockerignore

**/node_modules

这将防止主机系统的现有依赖项注入到容器中，因为它们可能无法在容器中工作。 Dockerfile 中提供的 RUN 命令将解决这个问题。

使用如下命令创建镜像：

docker build -t myapp-as-a-service /home/me

-t 选项选择构建容器镜像的“名称”。这用于下面运行的容器。

注意：最后一个参数是选择包含该 Dockerfile 的文件夹而不是 Dockerfile 本身。您可以使用选项 -f 选择不同的选项。

启动容器

使用此命令启动容器：

docker run -d --restart always -p 80:3000 myapp-as-a-service

此命令假设您的应用程序正在侦听端口 3000，并且您希望它在主机的端口 80 上公开。

这当然是一个非常有限的例子，但它是一个很好的起点。

Answer 20

为了完善建议的各种选项，这里还有一个：GNU/Linux 中的 daemon 命令，您可以在此处阅读：http://libslack.org/daemon/manpages/daemon.1.html。 （如果上面的评论之一已经提到了这一点，我们深表歉意）。

Answer 21

看看赋格！除了启动许多工作人员之外，您还可以妖魔化您的节点进程！

http://github.com/pgte/fugue

Answer 22

PM2 是 Node.js 应用程序的生产流程管理器，具有内置负载均衡器。它允许您使应用程序永远保持活动状态，无需停机即可重新加载它们，并简化常见的系统管理任务。
https://github.com/Unitech/pm2

Answer 23

我很惊讶没有人提到 Guvnor

我一直在尝试，pm2 等。但是，当它出现时对于可靠的控制和基于网络的性能指标，我发现 Guvnor 是迄今为止最好的。另外，它也是完全开源的。

编辑：但是，我不确定它是否适用于 Windows。我只在 Linux 上使用过它。

Answer 24

有人注意到“2>&1”的位置有一个小错误吗？

2>&1 >> file

应该是

>> file 2>&1

Answer 25

我将 tmux 用于远程主机上的多窗口/窗格开发环境。分离并保持进程在后台运行非常简单。看看 tmux

Answer 26

对于使用较新版本的 daemon npm 模块的人 - 您需要传递文件描述符而不是字符串：

var fs = require('fs');
var stdoutFd = fs.openSync('output.log', 'a');
var stderrFd = fs.openSync('errors.log', 'a');
require('daemon')({
    stdout: stdoutFd, 
    stderr: stderrFd
});

Answer 27

如果您使用 pm2，则可以将 autorestart 设置为 false 来使用它：

$ pm2 生态系统

这将生成一个示例 ecosystem.config.js：

module.exports = {
  apps: [
    {
      script: './scripts/companies.js',
      autorestart: false,
    },
    {
      script: './scripts/domains.js',
      autorestart: false,
    },
    {
      script: './scripts/technologies.js',
      autorestart: false,
    },
  ],
}

$ pm2 启动 Ecosystem.config.js

Answer 28

我在 RHEL 8 AWS EC2 实例上使用 @mikemaccana 接受的答案时收到以下错误：(code =exited, status=216/GROUP)

这是由于使用的用户/组设置为：“nobody”。

经过谷歌搜索，似乎使用用户/组作为“nobody”/“nogroup”对于守护进程来说是不好的做法，正如所回答的此处位于 unix 堆栈交换上。

将用户/组设置为我的实际用户和组后，效果非常好。

您可以输入 whomai 和 groups 以查看解决此问题的可用选项。

我的带有 mongodb 的完整堆栈节点应用程序的服务文件：

[Unit]
Description=myapp
After=mongod.service

[Service]
ExecStart=/home/myusername/apps/myapp/root/build/server/index.js
Restart=always
RestartSec=30
User=myusername
Group=myusername
Environment=PATH=/usr/bin:/usr/local/bin
Environment=NODE_ENV=production
WorkingDirectory=/home/myusername/apps/myapp

[Install]
WantedBy=multi-user.target

Answer 29

您可以在 unix 中使用 & 在后台运行节点应用程序。确保您的节点应用程序不应该有任何交互模式，例如从输入接收数据。

node src/index.js -p 1234 --another-options &

Answer 30

这个答案已经很晚了，但我发现最好的解决方案是编写一个同时使用 screen -dmS 和 nohup 命令的 shell 脚本。

screen -dmS newScreenName nohup node myserver.js >> logfile.log

我还添加了 >> logfile 位位于末尾，这样我就可以轻松保存节点 console.log() 语句。

为什么我使用 shell 脚本？我还添加了一个 if 语句来检查 node myserver.js 进程是否已经在运行。

这样我就能够创建一个命令行选项，既可以让我保持服务器运行，也可以在我进行更改时重新启动它，这对开发非常有帮助。