在Debian上安装部署纸壳CMS

ZKEASOFT June 30, 2021

1. 安装 .Net运行时

首先下载纸壳CMS所需的运行时：

wget -O dotnet.tar.gz http://www.zkea.net/dotnet-runtime-linux

然后将运行时提取到$HOME/dotnet目录：

mkdir -p "$HOME/dotnet" && tar zxf dotnet.tar.gz -C "$HOME/dotnet"

在安装完成运行时之后，还需要安装libicu-dev和libgdiplus：

apt update
apt install libicu-dev -y

2. 安装nginx

我们使用nginx来做反向代理，安装nginx很简单，在SSH端输入以下命令即可。

apt install nginx

安装完成以后，用服务器IP访问一下，如果可以正常访问，说明nginx已经正常运行了。

3. 配置nginx

需要要设置nginx反向代理到CMS的本地监听端口，修改默认配置文件 /etc/nginx/sites-available/default

vi /etc/nginx/sites-available/default

使用以下内容替换原有内容（按键盘I或者Insert开启编辑模式）：

server {
    listen 80;
    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 $host;
        proxy_cache_bypass $http_upgrade;
    }
}

修改完成后，按ESC键退出编辑模式，然后按组合键shift+:，然后输入wq，回车进行保存。

重启nginx

systemctl restart nginx

4. 安装ZKEACMS

使用wget命令下载CMS程序

wget https://cloud.zkeasoft.com/file/zkeasoft/cms.zip

安装unzip命令，用于解压cms.zip：

apt install unzip -y

然后使用unzip命令将CMS解压到/root/cms 目录下，使用以下命令解压

unzip cms.zip -d cms

5. 添加服务运行ZKEACMS

添加一个zkeacms服务

vi /etc/systemd/system/zkeacms.service

输入以下内容保存

[Unit]
Description=ZKEACMS

[Service]
WorkingDirectory=/root/cms
ExecStart=/root/dotnet/dotnet ZKEACMS.WebHost.dll
Restart=always
RestartSec=10
SyslogIdentifier=zkeacms
User=root
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

注意：ExecStart=/root/dotnet/dotnet ZKEACMS.WebHost.dll中/root/dotnet/dotnet为dotnet程序的路径，即$HOME/dotnet/dotnet。具体路径与当前登录用户有关，可以使用以下命令查询安装路径：

printf "$HOME/dotnet/dotnet\n"

启动网站

systemctl start zkeacms

网站启动以后，就可以尝试使用域名或者IP进行访问了。

如果网站不能访问，可以先查询一下纸壳CMS的运行状态是否正常：

systemctl status zkeacms

服务开机启动

设置服务开机启动，不然每一次重启服务器都要手动启动cms服务

systemctl enable zkeacms

常见问题

验证码无法显示