快速搭建CentOS+ASP.NET Core環境支持WebSocket


以前用python,go嘗試在linux下做web服務,python沒有強類型支持與高性能,go又沒有很好的集成開發環境(還有強迫症的語法),回頭看了幾次.net,都沒有時間嘗試,現終於實現了這些想法,與大家分享。做web大項目,做工程,必須要有稱手的工具幫我調試、測試、開發。工程化很重要,VS是一個稱職好選手。

環境:CentOS 7.x,.net core 2

以下.net core 2安裝操作為官方方法。如果你使用Docker,那么更簡單了,只需要docker pull microsoft/dotnet就可以了。如果你使用Bash On Windows,那么與實際對應的Linux子系統安裝完全相同。

https://www.microsoft.com/net/learn/get-started/linux/centos

CentOS安裝.net core(其他系統在這個頁面都可以選擇,包括:RHEL、Ubuntu、Debian、Fedora、openSUSE):

依次執行(root下沒有sudo也可以):

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[packages-microsoft-com-prod]\nname=packages-microsoft-com-prod \nbaseurl= https://packages.microsoft.com/yumrepos/microsoft-rhel7.3-prod\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/dotnetdev.repo'

sudo yum update
sudo yum install libunwind libicu
sudo yum install dotnet-sdk-2.1.101

 

只需要這幾部,.net core 2就安裝好了。

用dotnet命令創建空web項目,編譯測試:

dotnet new web -o wstest
dotnet build wstest
dotnet run --project wstest

注:dotnet new 命令會幫你創建項目,包括文件夾,必要的項目文件。build與run命令之前可以cd wstest,這樣就可以免去后面的參數,把當前目錄當作操作對象。

注:可以再簡潔點:dotnet run -p wstest。編譯運行一起完成。

無意外的話,項目已經啟動,並且在localhost(端口默認是5000)開始監聽http請求。做這些事情的方便快捷是python、go、node.js、PHP、JAVA等等不能比的。當然,如果你在Windows下,就更快了,包括后續的編碼、調試、測試。

接下來,我們進入WebSocket階段。

1、我們先創建一個html文件,放到項目的wwwroot目錄下,用於測試WebSocket。

<!DOCTYPE html>
<html>
<body>
    <div id="out"></div>
    <script>
        var ws = new WebSocket("ws://127.0.0.1:5000/ws")
        ws.onopen = function () {
            log("open")
        }
        ws.onmessage = function (ev) {
            log(ev.data)
        }
        function log(text) {
            out.innerHTML+="<div>"+text+"</div>"
        }
    </script>
</body>
</html>

2、開啟asp.net的靜態文件訪問與WebSocket支持。Linux下的asp.net宿主服務Kestrel已經支持WebSocket,可以直接運行。

在Startup.cs的public Configure成員函數中添加:

app.UseWebSockets();
app.UseStaticFiles();

3、為Startup.cs的Startup類添加WebSocket處理方法(成員函數):

        async Task Echo(HttpContext ctx, WebSocket ws)
        {
            var bytes = System.Text.UTF8Encoding.UTF8.GetBytes("ok");
            var buff = new ArraySegment<byte>(bytes);
            await ws.SendAsync(buff, WebSocketMessageType.Text, true, System.Threading.CancellationToken.None);
        }

4、再為Startup.cs的public Configure成員函數添加處理函數,可選擇去掉app.Run的調用:

            app.Use(async (context, next) =>
            {
                if (context.WebSockets.IsWebSocketRequest)
                {
                    WebSocket ws = await context.WebSockets.AcceptWebSocketAsync();
                    await Echo(context, ws);
                }
                else
                    await next();
            });

5、Startup.cs文件的頭部添加引用:

using System.Net.WebSockets;

 

代碼就這么多了。接下來驗證結果。

 

注意:

1、如果你放到華為雲、騰訊雲,這樣有安全組的服務器上,你需要開啟之前提到的端口TCP轉入權限。

2、test.html中的websocket地址請更換為實際的服務器地址與端口。

3、動態IP支持的雲主機自己是不知道自己的外網IP地址的,所以只能監聽0.0.0.0端口或者內網綁定的端口。

4、注意自己的防火牆是否放行對應的端口,可用iptables或firewall-cmd查詢,CentOS7默認采用firewall-cmd作為防火牆的操作端。iptables也可以,但是不能保存。可安裝iptables-services解決。

 

dotnet run以后,你可以找個瀏覽器訪問你的http服務了。

如果順利,你可以看到頁面輸出ok字樣。說明,asp.net core的靜態頁面已經輸出,並且此頁面用WebSocket協議訪問我們的http服務。

 

不順利的可能基本是監聽的IP地址無法訪問或端口未開放。

另一個原因是dotnet創建的項目里沒有項目配置文件,你可能不知道怎么配置監聽ip與端口。下面是launchSettings.json文件。你應該把它放到項目的Properties文件夾中。它是我從VisualStudio向導生成的文件中提取的。

{
  "profiles": {
    "anyname": {
      "commandName": "Project",
      "launchBrowser": true,
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      },
      "applicationUrl": "http://0.0.0.0:5000/"
    }
  }
}

 

好了,祝你順利!


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM