在CentOS上使用Jexus托管运行 ZKEACMS

ZKEACMS Core 是基于 .net core 开发的，能够在 windows, linux, mac 上跨平台运行，接下来咱们来看看如何在 CentOS 上使用Jexus托管运行 ZKEACMS，一般咱们在Linux部署ASP.NET Core应用，按照微软的官方文档，咱们一般须要Nginx 搭配 Systemd （https://docs.microsoft.com/en-us/aspnet/core/publishing/linuxproduction）， Nginx并无接管Kestrel 进程，咱们须要维护2个进程，增长了复杂度。若是你把asp.net core部署于windows上，咱们能够用IIS来接管Kestrel进程，咱们在Linux上也能够用Jexus来达到IIS同样的体验。

安装 .Net Core 运行时

按照官方文档https://www.microsoft.com/net/core#linuxcentos ：运行如下命令，安装 .Net Core Runtime

sudo yum install libunwind libicu
curl -sSL -o dotnet.tar.gz https://go.microsoft.com/fwlink/?linkid=843421
sudo mkdir -p /usr/local/dotnet && sudo tar zxf dotnet.tar.gz -C /usr/local/dotnet
sudo ln -s /usr/local/dotnet/dotnet /usr/local/bin

安装 Jexus

按照《CentOS 7.2下安装Mono 5.0》安装好了Mono 5, 我这里是安装通用版的Jexus，通用版的Jeuxs 才能使用到咱们本身安装的最新版的Mono 5。安装 Jexus 直接使用一下命令便可(须要在root身份下执行):

curl https://jexus.org/release/install | sh

安装成功后会提示：OK, Jexus has been installed in /usr/jexus.

备注： 

    你能够直接安装独立版的Jexus，独立版的Jexus自带Mono，使用的是Mono的稳定版本4.8，安装命令也是一个命令就能够搞定：curl https://jexus.org/release/x64/install.sh|sh

发布 ZKEACMS.Core

数据库 MySql

我使用的是腾讯云的云数据库MySQL（Cloud Database for MySQL）是腾讯云基于全球最受欢迎的开源数据库MySQL专业打造的高性能分布式数据存储服务，100%彻底兼容MySQL 协议，适用于面向关系型数据库的场景。ZKEACMS Core 默认使用的是Oracle官方的Mysql驱动，因为Oracle官方的mysql驱动有不少问题，目前仍是beta版本，最近也不见更新，我在生产环境使用的是Pomelo.EntityFrameworkCore.MySql ，我ZKEACMS的MySQL驱动更改成Pomelo.EntityFrameworkCore.MySql，经测试工做良好，我已经把相关修改pull 给ZKEACMS。 MySQL for .NET Core - Pomelo 扩展包系列 包括Pomelo.Data.MySql 和 Pomelo.EntityFrameworkCore.MySql ，推荐你们使用，通过了实际项目的检验。

ZKEACMS Core 的数据库脚本只有SQL Server, 将SQL Server数据库转换为MySQL的工具很是多，这里不作具体介绍了。

发布 ZKEACMS.Core

发布 ZKEACMS.Core 比较简单，双击 Publish.cmd 便可

生成的文件在目录 ZKEACMS.Core\src\ZKEACMS.WebHost\bin\Release\PublishOutput

修改链接字符串

打开 appsettings.json，加入 MySQL的数据库链接字符串，结果以下

{
  "ConnectionStrings": {
    "DefaultConnection": "",
    "Sqlite": "",
    "MySql": "Server=10.66.241.199;Database=ZKEACMS_Core;User Id=root;Password=xxxxxxx;"
  },
  "ApplicationInsights": {
    "InstrumentationKey": ""
  },
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Debug",
      "System": "Information",
      "Microsoft": "Information"
    }
  },
  "CDN": {
    "Enable": true,
    "Url": "http://cdn.zkeasoft.com/core"
  },
  "Culture": "zh-CN"
}

上传服务器

咱们将发布好的程序同winscp 程序上传到服务器/var/www/csharpkit 目录，具体操做可参考文章《使用WinSCP软件在windows和Linux中进行文件传输》

配置Jexus运行ZKEACMS Core

定位到目录，而后使用 dotnet 命令运行

cd /var/www/csharpkit 

dotnet ZKEACMS.WebHost.dll

运行成功之后，就可使用您服务器的IP或者域名访问了，默认访问的端口是5000 退出SSH远程链接客户端后，发现访问不了，这是由于 dotnet 也退出了。下面咱们就经过Jexus来管理咱们服务进程。

使用如下命令：

一、切换到Jexus配置文件目录

cd /usr/jexus/siteconf

二、复制默认的配置文件为test

cp default csharpkit

三、编辑csharpkit配置文件

nano csharpkit

######################
# Web Site: csharpkit
########################################

port=80
root=/ /var/www/csharpkit
hosts=www.csharpkit.com    #OR your.com,*.your.com

AppHost={
cmd=dotnet /var/www/csharpkit/ZKEACMS.WebHost.dll;
root=/var/www/csharpkit;
port=0;
}

配置的重点就在于AppHost中，须要注意的是在AppHost中的port（端口号）不表明Jexus对外服务的port(端口号),而是指要转发的 Asp.Net Core应用程序的端口号，若是在程序中使用了UsrUrls自定义端口则使用UsrUrls中填写的端口(不建议使用UsrUrls自定义端口),在没有使用UsrUrls自定义端口的状况下端口号设置为 0，Jexus会在运行时与Asp.Net Core进行"协商"具体使用的端口号，避免多个应用分配，端口的麻烦和冲突的风险。 简单来讲就是会将外部的请求转发到这个端口，由这个端口对应的Asp.Net Core应用程序对请求进行处理。

四、启动/重启 Jexus

当配置文件编辑完成后使用如下命令对Jexus进行 启动/重启

# 若是已启动 Jexus：
sh /usr/jexus/jws restart

# 若是未启动 Jexus：
sh /usr/jexus/jws start

启动/重启成功后，在浏览器中输入  ip地址/域名:端口号 例如(http://www.csharpkit.com/)  便可访问Asp.Net Core应用程序

以上便是Jexus托管Asp.Net Core应用程序的配置全过程