如何在 Ubuntu 上使用 pm2 和 Nginx 部署 Node.js 应用
Node.js
pm2 是一个 Node.js 应用的进程管理器，它可以让你的应用程序保持运行，还有一个内建的负载均衡器。它非常简单而且强大，你可以零间断重启或重新加载你的 node 应用，它也允许你为你的 node 应用创建集群。


在这篇博文中，我会向你展示如何安装和配置 pm2 用于这个简单的 'Express' 应用，然后配置 Nginx 作为运行在 pm2 下的 node 应用的反向代理。


![](/data/attachment/album/201705/09/094125eoba2938fs6bbft8.jpeg)


前提：


* Ubuntu 16.04 - 64bit
* Root 权限


### 第一步 - 安装 Node.js LTS


在这篇指南中，我们会从零开始我们的实验。首先，我们需要在服务器上安装 Node.js。我会使用 Nodejs LTS 6.x 版本，它能从 nodesource 仓库中安装。


从 Ubuntu 仓库安装 `python-software-properties` 软件包并添加 “nodesource” Nodejs 仓库。



```
sudo apt-get install -y python-software-properties 
curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -

```

安装最新版本的 Nodejs LTS：



```
sudo apt-get install -y nodejs

```

安装完成后，查看 node 和 npm 版本。



```
node -v
npm -v

```

![检查 node.js 版本](/data/attachment/album/201705/09/094133atjt617aqa474gn7.png)


### 第二步 - 生成 Express 示例 App


我会使用 `express-generator` 软件包生成的简单 web 应用框架进行示例安装。`express-generator` 可以使用 `npm` 命令安装。


用 `npm`安装 `express-generator`：



```
npm install express-generator -g

```

* `-g` ： 在系统内部安装软件包。


我会以普通用户运行应用程序，而不是 root 或者超级用户。我们首先需要创建一个新的用户。


创建一个名为 `yume` 的用户：



```
useradd -m -s /bin/bash yume
passwd yume

```

使用 `su` 命令登录到新用户：



```
su - yume

```

下一步，用 `express` 命令生成一个新的简单 web 应用程序：



```
express hakase-app

```

命令会创建新项目目录 `hakase-app`。


![用 express-generator 生成应用框架](/data/attachment/album/201705/09/094134eh6pdfw5db5zt36d.png)


进入到项目目录并安装应用需要的所有依赖。



```
cd hakase-app
npm install

```

然后用下面的命令测试并启动一个新的简单应用程序：



```
DEBUG=myapp:* npm start

```

默认情况下，我们的 express 应用会运行在 `3000` 端口。现在访问服务器的 IP 地址：192.168.33.10:3000 ：


![express nodejs 运行在 3000 端口](/data/attachment/album/201705/09/094134xybbltoby405m9tt.png)


这个简单 web 应用框架现在以 'yume' 用户运行在 3000 端口。


### 第三步 - 安装 pm2


pm2 是一个 node 软件包，可以使用 `npm` 命令安装。（用 root 权限，如果你仍然以 yume 用户登录，那么运行命令 `exit` 再次成为 root 用户）：



```
npm install pm2 -g

```

现在我们可以为我们的 web 应用使用 pm2 了。


进入应用目录 `hakase-app`：



```
su - yume
cd ~/hakase-app/

```

这里你可以看到一个名为 `package.json` 的文件，用 `cat` 命令显示它的内容。



```
cat package.json

```

![配置 express nodejs 服务](/data/attachment/album/201705/09/094135od7q91mmsmz781ei.png)


你可以看到 `start` 行有一个 nodejs 用于启动 express 应用的命令。我们会和 pm2 进程管理器一起使用这个命令。


像下面这样使用 `pm2` 命令运行 express 应用：



```
pm2 start ./bin/www

```

现在你可以看到像下面这样的结果：


![使用 pm2 运行 nodejs app](/data/attachment/album/201705/09/094135jq154wgd8044b0mk.png)


我们的 express 应用正在 `pm2` 中运行，名称为 `www`，id 为 `0`。你可以用 show 选项 `show nodeid|name` 获取更多 pm2 下运行的应用的信息。



```
pm2 show www

```

![pm2 服务状态](/data/attachment/album/201705/09/094135ittndmwv8s4wlrfz.png)


如果你想看我们应用的日志，你可以使用 logs 选项。它包括访问和错误日志，你还可以看到应用程序的 HTTP 状态。



```
pm2 logs www

```

![pm2 服务日志](/data/attachment/album/201705/09/094136spevmc3f3mq9e9vd.png)


你可以看到我们的程序正在运行。现在，让我们来让它开机自启动。



```
pm2 startup systemd

```

* `systemd`： Ubuntu 16 使用的是 systemd。


你会看到要用 root 用户运行命令的信息。使用 `exit` 命令回到 root 用户然后运行命令。



```
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u yume --hp /home/yume

```

它会为启动应用程序生成 systemd 配置文件。当你重启服务器的时候，应用程序就会自动运行。


![pm2 添加服务到开机自启动](/data/attachment/album/201705/09/094136a39om17sgc3cddco.png)


### 第四步 - 安装和配置 Nginx 作为反向代理


在这篇指南中，我们会使用 Nginx 作为 node 应用的反向代理。Ubuntu 仓库中有 Nginx，用 `apt` 命令安装它：



```
sudo apt-get install -y nginx

```

下一步，进入到 `sites-available` 目录并创建新的虚拟主机配置文件。



```
cd /etc/nginx/sites-available/
vim hakase-app

```

粘贴下面的配置：



```
upstream hakase-app {
    # Nodejs app upstream
    server 127.0.0.1:3000;
    keepalive 64;
}

# Server on port 80
server {
    listen 80;
    server_name hakase-node.co;
    root /home/yume/hakase-app;

    location / {
        # Proxy_pass configuration
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_set_header X-NginX-Proxy true;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_max_temp_file_size 0;
        proxy_pass http://hakase-app/;
        proxy_redirect off;
        proxy_read_timeout 240s;
    }
}
```

保存文件并退出 vim。


在配置中：


* node 应用使用域名 `hakase-node.co` 运行。
* 所有来自 nginx 的流量都会被转发到运行在 `3000` 端口的 node app。


测试 Nginx 配置确保没有错误。



```
nginx -t

```

启用 Nginx 并使其开机自启动。



```
systemctl start nginx
systemctl enable nginx

```

### 第五步 - 测试


打开你的 web 浏览器并访问域名（我的是）：[http://hakase-app.co](http://hakase-app.co/) 。


你可以看到 express 应用正在 Nginx web 服务器中运行。


![Nodejs app 在 pm2 和 Nginx 中运行](/data/attachment/album/201705/09/094136te6tdg2cg59eeree.png)


下一步，重启你的服务器，确保你的 node app 能开机自启动：



```
pm2 save
sudo reboot

```

如果你再次登录到了你的服务器，检查 node app 进程。以 `yume` 用户运行下面的命令。



```
su - yume
pm2 status www

```

![nodejs 在 pm2 下开机自启动](/data/attachment/album/201705/09/094137rl8ls23l4jijm8z8.png)


Node 应用在 pm2 中运行并使用 Nginx 作为反向代理。


### 链接


* [Ubuntu](https://www.ubuntu.com/)
* [Node.js](https://nodejs.org/en/)
* [Nginx](https://www.nginx.com/)




---


via: <https://www.howtoforge.com/tutorial/how-to-deploy-nodejs-applications-with-pm2-and-nginx-on-ubuntu/>


作者：[Muhammad Arul](https://www.howtoforge.com/tutorial/how-to-deploy-nodejs-applications-with-pm2-and-nginx-on-ubuntu/) 译者：[ictlyh](https://github.com/ictlyh) 校对：[wxy](https://github.com/wxy)


本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出


OK
pm2 is a process manager for Node.js applications, it allows you to keep your apps alive and has a built-in load balancer. It's simple and powerful, you can always restart or reload your node application with zero downtime and it allows you to create a cluster of your node app.

In this tutorial, I will show you how to install and configure pm2 for the simple 'Express' application and then configure Nginx as a reverse proxy for the node application that is running under pm2.

**Prerequisites**

- Ubuntu 16.04 - 64bit
- Root Privileges

## Step 1 - Install Node.js LTS

In this tutorial, we will start our project from scratch. First, we need Nodejs installed on the server. I will use the Nodejs LTS version 6.x which can be installed from the nodesource repository.

Install the package '**python-software-properties**' from the Ubuntu repository and then add the 'nodesource' Nodejs repository.

sudo apt-get install -y python-software-properties

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -

Install the latest Nodejs LTS version.

sudo apt-get install -y nodejs

When the installation succeeded, check node and npm version.

node -v

npm -v

## Step 2 - Generate Express Sample App

I will use simple web application skeleton generated with a package named '**express-generator**' for this example installation. Express-generator can be installed with the npm command.

Install '**express-generator**' with npm:

npm install express-generator -g

**-g:** install package inside the system

We will run the application as a normal user, not a root or super user. So we need to create a new user first.

Create a new user, I name mine '**yume**':

useradd -m -s /bin/bash yume

passwd yume

Login to the new user by using su:

su - yume

Next, generate a new simple web application with the express command:

express hakase-app

The command will create new project directory '**hakase-app**'.

Go to the project directory and install all dependencies needed by the app.

cd hakase-app

npm install

Then test and start a new simple application with the command below:

DEBUG=myapp:* npm start

By default, our express application will run on port **3000**. Now visit server IP address: [192.168.33.10:3000](https://www.howtoforge.com/admin/articles/edit/192.168.33.10:3000)

The simple web application skeleton is running on port 3000, under user 'yume'.

## Step 3 - Install pm2

pm2 is a node package and can be installed with the npm command. So let's install it with npm (with root privileges, when you are still logged in as user hakase, then run the command "exit" ro become root again):

npm install pm2 -g

Now we can use pm2 for our web application.

Go to the app directory '**hakase-app**':

su - hakase

cd ~/hakase-app/

There you can find a file named '**package.json**', display its content with the cat command.

cat package.json

You can see the '**start**' line contains a command that is used by Nodejs to start the express application. This command we will use with the pm2 process manager.

Run the express application with the pm2 command below:

pm2 start ./bin/www

Now you can see the results is below:

Our express application is running under pm2 with name '**www**', id '**0**'. You can get more details about the application running under pm2 with the show option '**show nodeid|name**'.

pm2 show www

If you like to see the log of our application, you can use the logs option. It's just access and error log and you can see the HTTP Status of the application.

pm2 logs www

You can see that our process is running. Now, let's enable it to start at boot time.

pm2 startup systemd

**systemd**: Ubuntu 16 is using systemd.

You will get a message for running a command as root. Back to the root privileges with "exit" and then run that command.

sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u yume --hp /home/yume

It will generate the systemd configuration file for application startup. When you reboot your server, the application will automatically run on startup.

## Step 4 - Install and Configure Nginx as a Reverse proxy

In this tutorial, we will use Nginx as a reverse proxy for the node application. Nginx is available in the Ubuntu repository, install it with the apt command:

sudo apt-get install -y nginx

Next, go to the '**sites-available**' directory and create a new virtual host configuration file.

cd /etc/nginx/sites-available/

vim hakase-app

Paste configuration below:

upstream hakase-app {

# Nodejs app upstream

server 127.0.0.1:3000;

keepalive 64;

}


# Server on port 80

server {

listen 80;

server_name hakase-node.co;

root /home/yume/hakase-app;


location / {

# Proxy_pass configuration

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header Host $http_host;

proxy_set_header X-NginX-Proxy true;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

proxy_max_temp_file_size 0;

proxy_pass http://hakase-app/;

proxy_redirect off;

proxy_read_timeout 240s;

}

}

Save the file and exit vim.

On the configuration:

- The node app is running with domain name '
**hakase-node.co**'. - All traffic from nginx will be forwarded to the node app that is running on port
**3000**.

Activate the configuration by creating a symlink in the sites-enabled directory.

ln -s /etc/nginx/sites-available/hakase-app /etc/nginx/sites-enabled/

Test Nginx configuration and make sure there is no error.

nginx -t

Start Nginx and enable it to start at boot time:

systemctl start nginx

systemctl enable nginx

## Step 5 - Testing

Open your web browser and visit the domain name (mine is):

You will see the express application is running under the nginx web server.

Next, reboot your server, and make sure the node app is running at the boot time:

pm2 save

sudo reboot

If you have logged in again to your server, check the node app process. Run the command below as '**yume**' user.

su - yume

pm2 status www

The Node Application is running under pm2 and Nginx as reverse proxy.