前言

这是一个基于中小型企业或团队的架构设计，不考虑大厂。有充分的理由相信，大厂有绝对的实力来搭建一个相当复杂的环境。

中小型企业或团队是个什么样子？

开发团队人员配置不全，部分人员身兼开发过程上下游的数个职责。没有专职的维护人员，或者维护人员实力不足以完全掌控生产和开发环境。

这种情况下，过于复杂的生产环境设计，规划、安装、调试、修改会牵扯太多的精力。一旦使用过程中出现问题，涉及的技术复杂性会带来不可预估的灾难。

同时，中小型团队的系统，也有其特殊要求，主要表现在：

生产环境的搭建要简单。这个主要是考虑到人员的技术实力。毕竟要求一个开发人员，能熟练安装各种系统的运行环境，是有点太高了。生产环境的扩展性要足够。因为资金原因，通常前期的服务器资源会比较紧张，而一旦有资金进入，用户量会短时间扩大，服务器资源需求也相应扩大，就需要在不改动代码的情况下，通过简单的操作，把生产环境扩展成较大规模的架构。需要充分考虑到开发环境与生产环境的衔接。国内大多数开发团队，是采用windows开发，linux布署的模式。这种模式下，开发和生产环境中各个部分的选择尤为重要。最理想的情况，是开发和生产在不同的操作系统下，同环境同代码，避免代码重编译和移植。

本文就是针对这样的要求，进行的设计。

一、服务器的操作系统

毫无疑问，服务器的操作系统，必须是linux。

很多人选择windows做为服务器操作系统，是因为windows更熟悉，有图形管理界面，比较容易操作。

但实际上，linux做为操作系统的优势更明显：

命令行跟图形界面，仅是输入方式的区别，从功能上没有实质性的区别；命令行更快捷，而且可以形成命令序列，即脚本。装linux一定不要装GUI，这是一个非常重要的习惯，而且会显得很专业Linux是开源免费的，或接近免费的，既不存在版权问题，也不存在成本问题。在相同硬件的情况下，linux更容易获得更高的性能。更容易的意思是，不需要进行太多的配置和调整。在一般使用下，安装完直接使用，性能就很高了。

Linux 有很多发行版。之前通常的选择是CentOS，但随着其消失现在直接选择社区维护的Debian。

建议选择用 Debian 的原因是：稳定，占用硬盘小，占用运行内存少。

至于 Ubunut、Arch Linux、Mint，学习 linux 的时候可以好好用，服务器上就算了。如果 linux您自己本身不熟悉，就别自找麻烦。

至于linux的内核版本，在购买VPS服务器的时候，镜像都是做好的，没多少可选，用最高版本就好。内核的每个升级，都解决了一些问题，也带来了一些问题。如果不清楚这些问题在哪，或者不知道怎么解决这些问题，就假装不知道。操作系统的问题，包括BUG，包括遗留的内容，我们很难遇到的。

最后多说一句，服务器操作系统一定选择x64的版本，即64位的版本。在服务器上安装应用软件，也要优先选择x64的版本。现在的主流硬件，PC都是x64的，更别说服务器了。

Debian官网：

独立的服务器，需要从Debian官网下载ISO进行安装。云服务器，在购买时会先选择安装的镜像。安装的步骤略过，如果需要我可以另开一个贴子写写。

有几个简单的安全方面的内容需要注意：

远程连接服务器时，一定要用ssh。命令是：

ssh username@ipssh username@domain

Windows下没有内建的ssh命令，可以下一个Putty，也要使用ssh模式。

远程登录时，尽量少用root。安装完成后，建一个普通用户，用这个普通用户进行远程登录。进去后，用su升权或用sudo进行操作。上传文件使用ssh通道。命令是：

scp source_file username@ip:~/target_folder/target_filescp source_file username@domain:~/target_folder/target_file

Windows下可以装一个WinScp来上传文件。

小心使用网上建议的任何方式来改动服务器，除非你知道你在做什么。在绝大多数情况下，自己开发的应用跑在服务器上时，如果服务器出现了CPU高或内存满的情况，去查代码，而不是怀疑服务器如何如何，也不是去调整服务器的运行参数。二、数据库的选择

对于一个10W+用户的系统，数据库选择很重要。

一般来说，这个用户量，根据不同的应用，会形成单表年度400W~4000W条的数据量。在这个数据量下，我们需要相对大型的数据库。

可供选择的主流数据库：

类别

数据库

关系型数据库

MySQL, SQL Server for Linux, Oracle, DB2, PostgreDB

NoSQL数据库

Radis, HBase, MongoDB

具体数据库的区别分析，网上有很多文章，这儿就不再多讨论。

在现在讨论的这个架构下，有几个要求：

数据库要是免费的；数据库的安装要简单；数据库的使用要方便。这个使用，包括管理和开发；最重要的一点，是数据后期可扩展成分布式架构，以保证在不改动代码的情况下，支持B、C轮的数据:P。

在这个要求下，我们选择MongoDB作为主数据库。

MongoDB的官网：

MongoDB最新版下载：

community版和professional版本最大的区别是pro版有InMemoryDB模式，可以依托大内存建立存放在内存中的数据库文件。一般应用，社区版足够。

先看看MongoDB的安装有多简单：

第一步：下载数据库，以4.2.6 for Debian版本为例：

wget 

下载完成后，打开压缩包，

tar xvf mongodb-linux-x86_64-debian92-4.2.6.tgz -C /your_folder

我们会得到以下文件，

-rw-r--r-- 1 test test  30608 Apr 17 11:10 LICENSE-Community.txt-rw-r--r-- 1 test test  16726 Apr 17 11:10 MPL-2-rw-r--r-- 1 test test   2617 Apr 17 11:10 README-rw-r--r-- 1 test test  75405 Apr 17 11:10 THIRD-PARTY-NOTICES-rw-r--r-- 1 test test 183512 Apr 17 11:13 THIRD-PARTY-NOTICES.gotoolsdrwxr-xr-x 2 test test   4096 Apr 20 19:29 bin

bin目录中，有以下文件，

-rwxr-xr-x 1 test test 12715648 Apr 17 11:12 bsondump-rwxr-xr-x 1 test test     7694 Apr 17 11:36 install_compass-rwxr-xr-x 1 test test 47998920 Apr 17 11:36 mongo-rwxr-xr-x 1 test test 73240640 Apr 17 11:36 mongod-rwxr-xr-x 1 test test 17526720 Apr 17 11:12 mongodump-rwxr-xr-x 1 test test 17277000 Apr 17 11:12 mongoexport-rwxr-xr-x 1 test test 17242056 Apr 17 11:12 mongofiles-rwxr-xr-x 1 test test 17452192 Apr 17 11:12 mongoimport-rwxr-xr-x 1 test test 17879808 Apr 17 11:13 mongoreplay-rwxr-xr-x 1 test test 17851848 Apr 17 11:12 mongorestore-rwxr-xr-x 1 test test 40628464 Apr 17 11:36 mongos-rwxr-xr-x 1 test test 17029440 Apr 17 11:12 mongostat-rwxr-xr-x 1 test test 16707368 Apr 17 11:12 mongotop

其中：

mongo是个shell，用来操作数据库。

mongod是单个数据库的服务程序，每个数据库都需要一个mongod进程。

mongos是集群的路由和入口，做集群时必须要用到。

别的都是一些管理工具，可以慢慢了解。

第二步：安装&启动

MongoDB本身是一个绿色软件，上一节的下载和解压，就是安装的过程了。

下面是启动数据库。

./mongod --dbpath your_database_folder_path

MongoDB运行，只需要一个数据库文件的存放目录。

当你看到命令执行后，出现一大篇内容，其中有两行：

I  NETWORK  [listener] Listening on 127.0.0.1I  NETWORK  [listener] waiting for connections on port 27017

的时候，恭喜你，数据库已经上线了。

简单不？

但是一定要记着，运行简单并不等于这是个Access一样的小东西。

这是个大型的基于文档的NoSQL数据库！

如果想查询各个命令都有什么参数，可以在命令后边加 --help 来查询。

例如：

./mongod --help

里面有详细的说明。

下面列几个常用的参数：

--config 配置文件。MongoDB除了直接用命令行参数外，也可以把参数写在一个配置文件中，然后在config参数引用这个配置文件

--port MongoDB默认端口是27017，可以改成任何端口

--logpath 默认数据库日志是输出到终端的，可以改为保存到文件（也可以不用这个参数，而在命令行重定向）

--bind_ip MongoDB默认绑定IP是127.0.0.1，可以改成任意IP地址

--db_path 数据库文件的保存目录

下面，我们检查一下数据库的安装是否正确。

我们用mongo连到数据库进行操作：

$ ./mongo localhost:27017MongoDB shell version v4.2.5> use TestDBswitched to db TestDB> db.collection.insert({"user":"test1"})WriteResult({ "nInserted" : 1 })> db.collection.insert({"user":"test2"})WriteResult({ "nInserted" : 1 })> db.collection.find(){ "_id" : ObjectId("5ea0279699857fc83ddf6ef5"), "user" : "test1" }> db.collection.find({"user":"test2"}){ "_id" : ObjectId("5ea029a599857fc83ddf6ef6"), "user" : "test2" }> exit

在这一节的最后，补充两个问题：

扩展性

上面介绍的是单MongoDB数据库的安装。这是最简单的一种形式，也是应用最多的一种形式。

如果数据很重要，为了防止任何情况的数据丢失，可以采用 Master + N Slave 的方式，做主从结构，把同样的多个库放到多个服务器上，互为备份。同时，这种方式还可以实现读写分离。

如果数据量再大，则可以把数据库扩展成集群，用以增加数据库的容量，并提升访问性能。

安全

上面介绍安装的时候，采用的默认端口。在实际使用时，可以改换一个端口，减少被扫描攻击的机率。

另外，数据库默认安装时，是不检查用户的。换言之，就是任何人都可以连到数据库。如果用在生产服务器上，一定要在数据库中建议用户和权限，以保证阻挡非法的访问。

三、WebServer

WebServer在系统中属于重中之重，是一个系统的发动机。文章前半部分我们说过，服务器需要用Linux。

Java在Linux上，一向做得很好。Apache的安装调试，在网上随便找。再不济，还有各种大牛的一键安装，够了。

但是，今天我不说Java，而要说说Microsoft，说说Dotnet Framework和Dotnet core。

很多人想到Dotnet，就会想到IIS，想到这东西需要跑到Windows上。但实际上，这已经是一个很老很过时的概念了。

Dotnet Framework和Dotnet core，几年前就可以在Linux上开发、调试和应用了。

只不过，两个框架在应用上稍有区别。

Framework需要Mono框架的支持，是Windows下编译的DLL，通过Mono框架在LInux下运行。

而Dotnet core，从第一天就是为跨平台而生的。一套代码，可以跑在Windows、Linux、MacOS、Arm下，不需要任何额外的设置。

Nginx可以支持Dotnet在Linux上运行。不过那个安装过程之复杂，是会让高手都眼晕的。

Dotnet core本身有SelfHost功能，可以直接运行。但是，对于复杂一点的系统，会有多个API应用，因为做不到统一管理，后续操作又会麻烦。

今天我们介绍一个神器，叫Jexus。

Jexus官网：

Jexus完整实现了我们对于WebServer的全部期望：

正向代理反向代理负载均衡缓存

同时，实测生产环境的应用，响应效率超过Nginx。

Jexus不仅可以运行在各种版本的Linux下，还可以运行在ARM架构下。国内主流的国产机型，可以完全适用。换句话说，Jexus可以满足国产化的要求。

下面看看Jexus的下载和安装：

可以从官网上直接下载。

另外，贴心的宇大，给了一个更简单的安装脚本：

curl  | sh

脚本会自动从官网下载最新的Jexus，并安装到/usr/jexus。

脚本运行完成后，安装Jexus就完成了。

我们看一下目录：

$ ls /usr/jexus -l-rw-r--r-- 1 root root    1015 Jan  1 03:30 def.py-rwxr-xr-x 1 root root    2691 Jan  1 03:30 jws-rw-r--r-- 1 root root      37 Jan  1 03:30 JwsAspd.exe-rwxr-xr-x 1 root root  334928 Mar 16 09:39 JwsAspd.exe.so-rw-r--r-- 1 root root     688 Jan 30 01:13 jws.conf-rwxr-xr-x 1 root root  515848 Mar 16 09:39 jwsHttpd.exe.so-rwxr-xr-x 1 root root  122560 Mar 16 09:39 jwsLog.exe.so-rwxr-xr-x 1 root root 4861920 Apr 15 15:14 jwssdrwxr-xr-x 2 root root    4096 Apr 15 15:15 log-rw-r--r-- 1 root root    3810 Jan  1 03:30 mime.conf-rwxr-xr-x 1 root root      79 Jan  1 03:30 mozroots-rw-r--r-- 1 root root     211 Apr 27 08:45 os.def-rw-r--r-- 1 root root   21273 Jan  1 03:30 readme.cn.txtdrwxr-xr-x 5 root root    4096 Jan  1 03:30 runtimedrwxr-xr-x 2 root root    4096 Feb 18 15:13 siteconf-rw-r--r-- 1 root root     753 Jan  1 03:30 state4.conf-rw-r--r-- 1 root root        3 Apr 27 08:45 state.pid

这个目录中：

jws 主控程序，网站的启动/停止/重启全靠它

Jws.config 针对操作系统级别的主控程序设置

mime.conf 预定义的mime。绝大多数mime已经定义好了。如果需要，可以直接追加

siteconf 网站应用定义目录。所有的网站应用设置都在这个目录里

log 网站日志目录。各个网站运行的日志都在这里

我们试着启动一下Jexus：

./jws start

一个简单的命令，服务就启动了。

检查网站是否正常运行，可以在浏览器中打开或，如果看到下面的网站，就说明网站正常启动了。

发布应用时，每个应用有一个独立的配置文件。

$ cat /usr/jexus/siteconf/default####################### Web Site: Default ########################################port=80root=/ /var/www/defaulthosts=*    #OR your.com,*.your.com# User=www-data# AspNet.Workers=2  # Set the number of asp.net worker processes. Defauit is 1.# addr=0.0.0.0# CheckQuery=falseNoLog=true# AppHost={cmd=dotnet /usr/local/x/app.dll; root=/usr/local/x; port=5000}# NoFile=/index.aspx# Keep_Alive=false# UseGZIP=false# UseHttps=true# ssl.certificate=/x/xxx.crt  #or pem# ssl.certificatekey=/x/xxx.key# ssl.protocol=TLSv1.0 TLSv1.1 TLSv1.2# ssl.ciphers=ECDHE-RSA-AES256-GCM-SHA384:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4:!DH:!DHE # DenyFrom=192.168.0.233, 192.168.1.*, 192.168.2.0/24# AllowFrom=192.168.*.*# DenyDirs=~/cgi, ~/upfiles# indexes=myindex.aspx# Deny asp ...rewrite=^/.+?\.(asp|cgi|pl|sh|bash|dll)(\?.*|)$  /.deny->$1rewrite=.*/editor/.+                             /.deny->editor# reproxy=/bbs/  host.Redirect=abc.com   301# ResponseHandler.Add=myKey:myValueResponseHandler.Add=X-Frame-Options:SAMEORIGIN# Jexus php fastcgi address is '/var/run/jexus/phpsvr'######################################################## fastcgi.add=php|socket:/var/run/jexus/phpsvr# php-fpm listen address is '127.0.0.1:9000'############################################# fastcgi.add=php|tcp:127.0.0.1:9000

一般应用时，我们需要关注以下几个参数：

port，应用的端口号root，应用的根目录。应用可以放在任何目录，在设置里指向这个目录就成hosts，应用绑定的域名AppHost，专用于Dotnet core的指向，指向到core应用的SelfHostreproxy，用于负载均衡模式时，指向实际服务器UseHttps，决定是否使用https。如果设为true，则下面ssl.certificate和ssl.certificatekey用于设置证书

详细的配置说明，可以参见目录中readme.cn.txt。

看看，WebServer也因为Jexus而变得超级简单。

至此，我们完成了整个架构中主体部分的安装和有效性测试。

四、扩展和延伸

在一个小应用的情况下， 可以直接按上文的内容，做一个简单的架构。

而在应用扩展时，可以依次扩展WebServer和数据库，以达到应用容量的延伸。

扩展Jexus

依托Jexus的反代特性，把Jexus扩展到多个服务器，并用一个Jexus做负载均衡，就完成了WebServer的扩展。

扩展数据库

依托MongoDB的特性，把MongoDB扩展到集群，即可支持海量的数据和毫秒级的响应。

通过这样简单的扩展配置，这个架构很容易就可以扩展到可以支持千万级用户的应用。

五、架构实践

接下来用一个Demo项目，从开发到部署：包括MongoDB数据的访问，用这种方式过一遍这个架构。

Demo项目，我们用Dotnet Core开发。我们选择最新版的Dotnet Core 3.1做为系统的主框架。

开发环境用MacOS + VS Code，生产环境用云服务器。

第一步：环境检查和搭建

先看看各个环境的版本情况

生产环境：

$ cat /proc/versionLinux version 4.9.0-12-amd64 (debian-kernel@lists.debian.org) (gcc version 6.3.0 20170516 (Debian 6.3.0-18+deb9u1) ) #1 SMP Debian 4.9.210-1 (2020-01-20)$ lsb_release -aNo LSB modules are available.Distributor ID:    DebianDescription:    Debian GNU/Linux 9.12 (stretch)Release:    9.12Codename:    stretch

开发环境：

$ cat /System/Library/CoreServices/SystemVersion.plist<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" ";><plist version="1.0"><dict>    <key>ProductBuildVersion</key>    <string>19E287</string>    <key>ProductCopyright</key>    <string>1983-2020 Apple Inc.</string>    <key>ProductName</key>    <string>Mac OS X</string>    <key>ProductUserVisibleVersion</key>    <string>10.15.4</string>    <key>ProductVersion</key>    <string>10.15.4</string>    <key>iOSSupportVersion</key>    <string>13.4</string></dict></plist>

Dotnet Core官方下载地址：

Mac上边是以前装好的，看一下：

$ dotnet --info.NET Core SDK (reflecting any global.json): Version:   3.1.201 Commit:    b1768b4ae7Runtime Environment: OS Name:     Mac OS X OS Version:  10.15 OS Platform: Darwin RID:         osx.10.15-x64 Base Path:   /usr/local/share/dotnet/sdk/3.1.201/Host (useful for support):  Version: 3.1.3  Commit:  4a9f85e9f8.NET Core SDKs installed:  3.1.201 [/usr/local/share/dotnet/sdk].NET Core runtimes installed:  Microsoft.AspNetCore.App 3.1.3 [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.App]  Microsoft.NETCore.App 3.1.3 [/usr/local/share/dotnet/shared/Microsoft.NETCore.App]

生产环境上边，安装步骤如下：

$ wget -O-  | gpg --dearmor > microsoft.asc.gpg$ sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/$ wget  sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list$ sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg$ sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list$ sudo apt-get update$ sudo apt-get install apt-transport-https$ sudo apt-get update$ sudo apt-get install dotnet-sdk-3.1

安装很简单，这要感谢Microsoft，没有误导，也不需要刨坑。

安装完检查一下：

$ dotnet --info.NET Core SDK (reflecting any global.json): Version:   3.1.201 Commit:    b1768b4ae7Runtime Environment: OS Name:     debian OS Version:  9 OS Platform: Linux RID:         debian.9-x64 Base Path:   /usr/share/dotnet/sdk/3.1.201/Host (useful for support):  Version: 3.1.3  Commit:  4a9f85e9f8.NET Core SDKs installed:  3.1.201 [/usr/share/dotnet/sdk].NET Core runtimes installed:  Microsoft.AspNetCore.App 3.1.3 [/usr/share/dotnet/shared/Microsoft.AspNetCore.App]  Microsoft.NETCore.App 3.1.3 [/usr/share/dotnet/shared/Microsoft.NETCore.App]

命令写顺手了，没有分SDK和Runtime，正常应用时，生产环境可以只装Runtime。命令是在最后装Dotnet的一步，用以下命令：

$ sudo apt-get install aspnetcore-runtime-3.1$ sudo apt-get install dotnet-runtime-3.1

详细步骤参见：15分钟从零开始搭建支持10w+用户的生产环境(二)

生产环境安装Jexus

详细步骤参见：15分钟从零开始搭建支持10w+用户的生产环境(三)

第二步：开发环境创建Demo项目

找个目录，创建解决方案（这一步不是必须，不过我习惯这么做。总要有个解决方案来存放工程）：

% dotnet new sln -o demoThe template "Solution File" was created successfully.

这一步完成后，会在当前目录建立一个新目录demo，同时，在demo目录下创建文件demo.sln。

在demo目录下，建立工程：

% dotnet new webapi -o demoThe template "ASP.NET Core Web API" was created successfully.Processing post-creation actions...Running 'dotnet restore' on demo/demo.csproj...  Restore completed in 16.79 ms for /demo/demo/demo.csproj.Restore succeeded.

% dotnet sln add demo/demo.csproj Project `demo/demo.csproj` added to the solution.

其中有一个WeatherForecast，包含两个文件：WeatherForecast.cs和WeatherForecastController.cs，是创建工程时自带的演示类。

现在我们运行一下工程。可以用VSC的「运行」，也可以命令行：

% dotnet run

运行Demo工程。

运行后，从浏览器访问：，会得到一串演示数据。这就是上面这个演示类的效果。

正式项目中，这两个文件要删掉。

到这一步，基础工程就搭好了。

我们要做一个API服务，这个服务里要有几个API，要用到数据库访问。为了测试API，我们需要装个Swagger。当然用Postman也可以，不过我习惯用Swagger。

增加Swagger包引用。在demo.csproj的同级目录下运行：

% dotnet add package Swashbuckle.AspNetCore

Swagger装好后，需要在Startup.cs中注册。

在ConfigureServices中加入以下代码：

services.AddSwaggerGen(c =>{    c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "V1" });});

在Configure中加入以下代码：

app.UseSwagger();app.UseSwaggerUI(c =>{    c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");});

完成后，Startup.cs的代码：

namespace demo{    public class Startup    {        public Startup(IConfiguration configuration)        {            Configuration = configuration;        }        public IConfiguration Configuration { get; }        // This method gets called by the runtime. Use this method to add services to the container.        public void ConfigureServices(IServiceCollection services)        {            services.AddSwaggerGen(c =>            {                c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "V1" });            });            services.AddControllers();        }        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)        {            if (env.IsDevelopment())            {                app.UseDeveloperExceptionPage();            }            app.UseRouting();            app.UseAuthorization();            app.UseSwagger();            app.UseSwaggerUI(c =>            {                c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");            });           app.UseEndpoints(endpoints =>            {                endpoints.MapControllers();            });        }    }}

选择一：引用官方包MongoDB.Driver：

% dotnet add package MongoDB.Driver

后面用包提供的SDK进行开发。

选择二：引用包Lib.Core.Mongodb.Helper：

% dotnet add package Lib.Core.Mongodb.Helper

这是我自己维护的一个Helper开源包，对官方的MongoDB.Driver做了一定程序的包装和简化操作。这个包目前在我公司的生产环境中用着。

这个包的开源地址：

引用完成后，需要在appsettings.json中增加数据库连接串：

"MongoConnection": "mongodb://localhost:27017/admin?wtimeoutMS=2000"

完成后，appsettings.json的代码如下：

{  "MongoConnection": "mongodb://localhost:27017/admin?wtimeoutMS=2000",  "Logging": {    "LogLevel": {      "Default": "Information",      "Microsoft": "Warning",      "Microsoft.Hosting.Lifetime": "Information"    }  },  "AllowedHosts": "*"}

在工程中创建一个目录Models，在目录下创建一个类文件Demo.cs：

using MongoDB.Bson;using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;namespace demo.Models{    public class Demo    {        public const string DATABASE = "DemoDB";        public const string COLLECTION = "DemoCollection";        public ObjectId _id { get; set; }        public string demo_user_name { get; set; }        public int demo_user_age { get; set; }    }}

在同一目录下，再创建另一个Dto类DemoDto.cs：

using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;namespace demo.Models{    public class DemoDto    {        public string demo_user_name { get; set; }        public int demo_user_age { get; set; }    }}

在工程中创建另一个目录DBContext，在目录下创建一个对应Demo类的数据库操作类DemoDBContext.cs：

using demo.Models;using Lib.Core.Mongodb.Helper;using MongoDB.Bson;using MongoDB.Driver;using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;namespace demo.DBContext{    public class DemoDBContext : MongoHelper<Demo>    {          ///创建数据库操作索引        protected override async Task CreateIndexAsync()        {        }        public DemoDBContext() : base(Demo.DATABASE, Demo.COLLECTION)        {        }          ///保存数据到数据库        internal async Task<bool> saveData(DemoDto data)        {            Demo new_item = new Demo()            {                _id = ObjectId.GenerateNewId(),                demo_user_name = data.demo_user_name,                demo_user_age = data.demo_user_age,            };            bool result = await CreateAsync(new_item);            return result;        }          ///从数据库查询全部数据        internal async Task<IEnumerable<DemoDto>> getAllData()        {            var fetch_data = await SelectAllAsync();            List<DemoDto> result_list = new List<DemoDto>();            fetch_data.ForEach(p =>            {                DemoDto new_item = new DemoDto()                {                    demo_user_name = p.demo_user_name,                    demo_user_age = p.demo_user_age,                };                result_list.Add(new_item);            });            return result_list;        }    }}

这三个类的关系是：

Demo类是数据类，对应MongoDB数据库中保存的数据。Demo.DATABASE是数据库中的DB名称，Demo.COLLECTION是数据库中的Collection名称。这个类决定数据在数据库中的保存位置和保存内容。DemoDta是Dta的映射类，在正式使用时，可以用AutoMap与Demo关联。在这个Demo中，我用它来做数据从前端到API的传递。DemoDBContext是对Demo结构数据的数据库操作。这个类派生自Lib.Core.MongoDB.Helper中的父类MongoHelper。所有对Demo数据的操作全在这个类中进行。创建API控制器

在Controller目录中，创建DemoController.cs：

using demo.DBContext;using demo.Models;using Microsoft.AspNetCore.Mvc;using System;using System.Collections.Generic;using System.Linq;using System.Threading.Tasks;namespace demo.Controllers{    [ApiController]    [Route("[controller]")]    public class DemoController : ControllerBase    {        [HttpPost]        [Route("savedata")]        public ActionResult<string> saveData(DemoDto data)        {            DemoDBContext dc = new DemoDBContext();            bool result = dc.saveData(data).GetAwaiter().GetResult();            if(result)                return "OK";            return "ERROR";        }        [HttpGet]        [Route("getdata")]        public IEnumerable<DemoDto> getData()        {            DemoDBContext dc = new DemoDBContext();            return dc.getAllData().GetAwaiter().GetResult();        }    }}

在这个控制器中，做了两个API：

基于POST的savedata，用来写入数据到数据库；基于GET的getdata，用来从数据库读取数据到前端。

数据库的操作，调用了DemoDBContext中写好的两个数据库操作方法。

数据库操作的完整方法，可以参见的详细说明。

检查一下现在的工程目录结构：测试运行

在VSC中点击运行，或者命令行输入：

% dotnet run

等程序加载完成，可以访问，进行访问，并测试两个API。

第三步：发布到生产环境

发布应用

前边说了，开发环境是MAC，生产环境是Debian 9 x64，所以会涉及到一个跨平台的发布。

事实上，跨平台发布也很简单。这个应用的目的环境是Linux-64，所以，发布命令是：

% dotnet publish -r linux-x64

发布完成后，系统会显示发布的目录。这个项目，发布目录在demo/bin/Debug/netcoreapp3.1/linux-x64/publish。

打包传到服务器，并解包到一个目录。在这个演示中，我解包到了服务器的/var/demo。在服务器Jexus中配置网站。

在/usr/jexus/siteconf中建立网站配置文件demo.80（文件名可以随便起，我的习惯是网站名称+端口号）：

####################### Web Site: DEMO########################################port=80root=/ /var/demohosts=*    #OR your.com,*.your.com# User=www-data# AspNet.Workers=2  # Set the number of asp.net worker processes. Defauit is 1.# addr=0.0.0.0# CheckQuery=falseNoLog=trueAppHost={cmd=dotnet demo.dll; root=/var/demo; port=5000}# NoFile=/index.aspx# Keep_Alive=false# UseGZIP=false# UseHttps=true# ssl.certificate=/x/xxx.crt  #or pem# ssl.certificatekey=/x/xxx.key# ssl.protocol=TLSv1.0 TLSv1.1 TLSv1.2# ssl.ciphers=ECDHE-RSA-AES256-GCM-SHA384:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4:!DH:!DHE # DenyFrom=192.168.0.233, 192.168.1.*, 192.168.2.0/24# AllowFrom=192.168.*.*# DenyDirs=~/cgi, ~/upfiles# indexes=myindex.aspx# Deny asp ...rewrite=^/.+?\.(asp|cgi|pl|sh|bash|dll)(\?.*|)$  /.deny->$1rewrite=.*/editor/.+                             /.deny->editor# reproxy=/bbs/  host.Redirect=abc.com   301# ResponseHandler.Add=myKey:myValueResponseHandler.Add=X-Frame-Options:SAMEORIGIN# Jexus php fastcgi address is '/var/run/jexus/phpsvr'######################################################## fastcgi.add=php|socket:/var/run/jexus/phpsvr# php-fpm listen address is '127.0.0.1:9000'############################################# fastcgi.add=php|tcp:127.0.0.1:9000

在这个演示项目里，起作用的配置其实就一行：

AppHost={cmd=dotnet demo.dll; root=/var/demo; port=5000}

这一行配置了三件事：

应用的运行命令是：dotnet demo.dll应用的运行目录是：/var/demo应用的运行端口是：5000

这样配置就完成了。

接下来，启动网站，在/usr/jexus中运行：

$ sudo ./jws start

网站就启动起来了。

第四步：测试

在本地浏览器中，输入：，跟在开发环境测试效果完全一样，可以进行数据库的写入和读取操作。

文章来源：*vKs&new=1