使用 Nginx 在 Ubuntu 16.04 上託管 ASP.NET Core

使用 Nginx 在 Ubuntu 16.04 上託管 ASP.NET Core

---

準備工做

服務器主機：騰訊雲主機 Ubuntu 16.04 64位
客戶端軟件：putty.exe; WinSCP 5.13.2

在 Ubuntu 中安裝 ASP.NET Core

微軟在 .NET Core指南 提供了在不一樣操做系統中安裝運行 ASP.NET Core 的幫助文檔，請選擇 linux-prerequisites 部分，並找到和本身服務器所安裝操做系統相同的內容進行安裝便可。

註冊Microsoft密鑰爲被信任的

在Linux環境中運行ASP.NET Core網站，咱們須要安裝.NET Core運行時（固然也能夠本身實現.NET Core程序的宿主）。
在安裝 .NET 以前，須要註冊Microsoft密鑰，註冊產品存儲庫，並安裝所需的依賴項。這隻須要在每臺機器上完成一次。
打開命令提示符並運行如下命令:

wget -q packages-microsoft-prod.deb https://packages.microsoft.com/config/ubuntu/16.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

.NET Core Runtime 和 .NET Core SDK 的區別：

• .NET Core = 應用運行依賴的 .NET Core Runtime
• .NET Core SDK = 使用 .NET Core 開發應用 .NET Core Runtime 和 SDK+CLI(Software Development Kit/Command Line Interface) 工具

安裝 .NET Core SDK

更新可用於安裝的產品，而後安裝 .NET SDK。
在命令提示符中，運行如下命令:

sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.1.105

.NET Core SDK 可能會發布新的版本，將 dotnet-sdk-2.1.105 更新爲對應的版本號便可。

檢查安裝狀況

在終端輸入如下命令檢查安裝是否成功：

dotnet --version

ASP.NET Core 示例程序

建立程序目錄

在用戶的主目錄(/home/ubuntu/)中建立新目錄 firstapp，而後進入該目錄：

mkdir firstapp
cd firstapp

建立示例程序

直接使用 .NET Core 的命令建立一個 ASP.NET Core 示例網站應用程序，在目錄 /home/ubuntu/firstapp 執行命令：

dotnet new mvc

命令運行結果:

The template "ASP.NET Core Web App (Model-View-Controller)" was created successfully.
This template contains technologies from parties other than Microsoft, see https://aka.ms/template-3pn for details.

Processing post-creation actions...
Running 'dotnet restore' on /home/ubuntu/firstapp/firstapp.csproj...
  Restoring packages for /home/ubuntu/firstapp/firstapp.csproj...
  Generating MSBuild file /home/ubuntu/firstapp/obj/firstapp.csproj.nuget.g.props.
  Generating MSBuild file /home/ubuntu/firstapp/obj/firstapp.csproj.nuget.g.targets.
  Restore completed in 857.05 ms for /home/ubuntu/firstapp/firstapp.csproj.
  Restore completed in 24.33 ms for /home/ubuntu/firstapp/firstapp.csproj.

Restore succeeded.

還原整個項目的依賴庫

執行命令：

dotnet restore

命令運行結果：

Restore completed in 59.28 ms for /home/ubuntu/firstapp/firstapp.csproj.
Restore completed in 10.83 ms for /home/ubuntu/firstapp/firstapp.csproj.

更改 MVC 項目默認端口號

爲防止衝突，先將 ASP.NET Core MVC 程序的默認端口號改成9000。更改端口號的辦法:打開項目的 program.cs 文件，添加如下有註釋的兩行：

public class Program
    {
        public static void Main(string[] args)
        {
            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseUrls("http://*:9000")   //指定端口號
                .UseKestrel()  //使用 Kestrel 服務器
                .Build();
    }

發佈項目

執行命令：

dotnet publish -c release

命令運行結果：

Microsoft (R) Build Engine version 15.7.177.53362 for .NET Core
Copyright (C) Microsoft Corporation. All rights reserved.

  Restore completed in 62.23 ms for /home/ubuntu/firstapp/firstapp.csproj.
  Restore completed in 11.54 ms for /home/ubuntu/firstapp/firstapp.csproj.
  firstapp -> /home/ubuntu/firstapp/bin/release/netcoreapp2.0/firstapp.dll
  firstapp -> /home/ubuntu/firstapp/bin/release/netcoreapp2.0/publish/

命令執行完畢後，項目被髮布到 /home/ubuntu/firstapp/bin/release/netcoreapp2.0/publish/ 目錄下，這個路徑太長，訪問的時候比較不方便，因此能夠建立一個項目運行的目錄：/var/www/firstapp/，並將剛纔項目發佈後的內容複製到該目錄中。
建立項目運行目錄，執行命令：

sudo mkdir /var/www/firstapp

將發佈後的結果複製到運行目錄中，執行命令：

sudo scp -r /home/ubuntu/firstapp/bin/release/netcoreapp2.0/publish/* /var/www/firstapp

進入運行目錄，運行、測試項目：

cd /var/www/firstapp
 dotnet firstapp.dll

程序運行結果：

Hosting environment: Production
Content root path: /var/www/firstapp
Now listening on: http://[::]:9000
Application started. Press Ctrl+C to shut down.

根據以上提示，經過地址 http://localhost:9000/ 或 http://127.0.0.1:9000 就能夠訪問到網站。可是，這個只能在服務器網站內部訪問，經過外網並不能訪問的。

使用 Nginx 反向代理

反向代理是爲動態 web 應用程序提供服務的常見設置。 反向代理終止 HTTP 請求，並將其轉發到 ASP.NET 核心應用程序。

安裝 Nginx

安裝命令：

sudo apt-get install nginx

由於是首次安裝 Nginx，經過運行如下命令顯式啓動：

sudo service nginx start

在瀏覽器地址欄中輸入相似於 http://192.168.XXX.XXX:9000 的IP地址或 http://域名:9000 就能夠顯示 Nginx 的默認登錄頁了。

配置 Nginx

若要將 Nginx 配置爲轉發請求向 ASP.NET Core 應用程序的反向代理，修改 /etc/nginx/sites-available/default。 在文本編輯器中打開它，並將內容替換爲如下內容：

server {
    listen        80;
    server_name   example.com *.example.com;
    location / {
        proxy_pass         http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection keep-alive;
        proxy_set_header   Host $http_host;
        proxy_cache_bypass $http_upgrade;
    }
}

Nginx 接受主機標頭使用的端口 80 上的公共流量, Nginx 將匹配的請求轉發到在 Kestrel http://localhost:9000。
測試配置：

sudo nginx -t

顯示結果以下所示：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

從新加載配置：

sudo nginx -s reload

在瀏覽器中直接輸入你的服務器IP地址並訪問，就能夠看到 ASP.NET Core MVC 應用程序運行的結果了。

監視應用程序

服務器已設置爲轉發到發出的請求 http://<serveraddress>:80 Kestrel 在上運行 ASP.NET Core 應用到 http://127.0.0.1:9000。 可是，Nginx 未設置來管理 Kestrel 過程。 systemd能夠用於建立服務文件以啓動和監視基礎的 web 應用。 systemd 是一個 init 系統，能夠提供用於啓動、中止和管理進程的許多強大的功能。

建立服務文件

建立服務定義文件：

sudo nano /etc/systemd/system/kestrel-firstapp.service

下面是應用程序的示例服務文件：

[Unit]
Description=firstapp .NET MVC App running on Ubuntu

[Service]
WorkingDirectory=/var/www/firstapp
ExecStart=/usr/bin/dotnet /var/www/firstapp.dll
Restart=always
RestartSec=10  # Restart service after 10 seconds if dotnet service crashes
SyslogIdentifier=dotnet-example
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

保存該文件並啓用該服務。

sudo systemctl enable kestrel-firstapp.service

啓動服務並驗證它正在運行。

sudo systemctl start kestrel-firstapp.service
sudo systemctl status kestrel-firstapp.service

啓動一個服務：systemctl start nginx.service
關閉一個服務：systemctl stop postfix.service
重啓一個服務：systemctl restart nginx.service
顯示一個服務的狀態：systemctl status postfix.service
在開機時啓用一個服務：systemctl enable nginx.service
在開機時禁用一個服務：systemctl disable nginx.service
查看服務是否開機啓動：systemctl is-enabled nginx.service
查看已啓動的服務列表：systemctl list-unit-files|grep enabled

查看啓動失敗的服務列表：systemctl --failed

使用 WinSCP 管理服務器

騰訊雲主機提供了 Web 界的命令窗口，不過這個窗口不支持粘貼，因此在編輯須要輸入不少內容的配置文件時，比較不方便。雖然使用 putty.exe 能夠進行復制粘貼，但使用 Linux 的 vi/vim 進行文本編輯估計也是不少不熟悉終端操做方式的人的惡夢。
WinSCP 是一個 Windows 環境下使用 SSH 的開源圖形化 SFTP 客戶端。同時支持 SCP 協議，它的主要功能就是在本地與遠程計算機間安全的複製文件，同時也能夠在 WinSCP 上直接對 Ubuntu 中的文件進行編輯。

WinSCP 中的管理員限

在編輯 Ubuntu 中某些服務的配置文件、或是上傳文件到非用戶目錄時，須要使用 root 權限，比較簡單的作法是開啓 root 帳號，在須要使用管理員權限的地方使用 root 登陸進行操做

啓用 root 帳號

執行命令：

sudo passwd root

按提示輸入 root 帳號的密碼，若是不怕安全問題，可使用和 ubuntu 帳號同樣的密碼，方便使用。

Password: //輸入密碼
Enter new UNIX password: //提示輸入新的root賬戶密碼
Retype new UNIX password:  //再輸入一次確認密碼

修改爲功以後你就可使用root帳號了.
若是鏈接時遇到拒絕訪問的提示，則還須要修改ssh的配置文件。
修改ssh配置文件：

/etc/ssh/sshd_config 修改該配置文件：

# Authentication:
LoginGraceTime 120
PermitRootLogin without-password
StrictModes yes

將 PermitRootLogin without-password （或 PermitRootLogin prohibit-password ） 修改成 PermitRootLogin yes，以下：

# Authentication:
LoginGraceTime 120
PermitRootLogin yes
StrictModes yes

從新啓動後就可使用 root 進行鏈接了。

WinSCP 使用 root 鏈接服務器

在 WinSCP 中編輯配置文件

配置文件的編輯窗口

管理服務器中的文件

使用 root 帳號登陸，左邊窗口定位到要上傳文件（如在 Visual Studio 中編輯併發布的項目），右邊窗口選到服務器中上傳的目錄，把文件從左邊拖到右邊就能夠 。