SSCMS 7.3 Documentation

https://sscms.com/docs/v7
Admin
SSCMS 7.3 is a content management system chosen by over 500,000 websites. This documentation covers...
Tokens:199,965
Snippets:941
Trust Score:10
Update:1 year ago
Show doc for...
Tokens:
Raw
### Start and Enable Nginx Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Commands to start the Nginx service and configure it to launch automatically on system boot. Assumes Nginx is already installed.

```shell
systemctl start nginx
systemctl enable nginx
```

--------------------------------

### Install and Enable Nginx

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Installs the Nginx web server using yum and then starts the Nginx service, enabling it to start automatically on system boot.

```bash
# 安装nginx
sudo yum install nginx

# 启动nginx（需要先确保80端口未被其他程序占用）
systemctl start nginx

# 设为开机启动
systemctl enable nginx
```

--------------------------------

### Start and Enable Nginx Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Commands to start the Nginx service and configure it to launch automatically on system boot. Assumes Nginx is already installed.

```shell
systemctl start nginx
systemctl enable nginx
```

--------------------------------

### SSCMS v7 Getting Started: Creating a Site

Source: https://sscms.com/docs/v7/getting-started/how-to/create-site

Step-by-step guide on how to create a new website within the SSCMS v7 platform. It details navigating the system, selecting templates, configuring site properties, and the site creation process.

```markdown
# 创建站点

SSCMS 是站群管理系统，即多个站点可以在后台进行统一管理。

接下来我们介绍在 SSCMS 系统中创建新站点的具体步骤。

## 1、进入创建站点菜单

点击 `系统管理` -> `创建新站点`，进入创建新站点界面：

![创建站点](/docs/v7/images/getting-started/how-to/create-site/01.png)

如上图所示，有三种创建站点的方式，在此我们以 `使用在线站点模板创建站点` 来讲解如何创建一个站点。

## 2、选择站点模板

点击 `使用在线站点模板创建站点` 按钮，进入在线站点模板选择界面：

![创建站点](/docs/v7/images/getting-started/how-to/create-site/02.png)

SSCMS 提供了许多在线站点模板以供选择，选中我们希望创建的站点模板，点击 `创建站点` 按钮，进入下一步。

## 3、填写站点属性

选完站点模板之后，进入新站点属性设置界面，如下图所示：

![创建站点](/docs/v7/images/getting-started/how-to/create-site/03.png)

在界面中设置好站点名称、站点类型、站点级别、上级站点、文件夹名称以及数据导入选项，点击 `创建站点` 按钮，开始创建站点。

## 4、创建站点

我们可以看到新站点创建进度，如下图所示：

![创建站点](/docs/v7/images/getting-started/how-to/create-site/04.png)

系统会自动进行站点创建以及数据导入工作，等待新站点创建完成后，系统会自动跳转至新创建站点的管理界面，如下图所示：

![创建站点](/docs/v7/images/getting-started/how-to/create-site/05.png)

在上图红框可以看到，当前站点是刚刚创建的 `我的站点`，至此，新站点的创建工作就全部结束了。

上次更新: 2021/11/3 下午4:15:36

←
[登录 SSCMS](/docs/v7/getting-started/how-to/login-cms.html) [切换站点进行管理](/docs/v7/getting-started/how-to/switch-site.html)
→
```

--------------------------------

### Install and Manage Nginx on Rocky Linux

Source: https://sscms.com/docs/v7/getting-started/using-linux-rocky

Installs the Nginx web server using dnf, starts the Nginx service, and configures it to start on boot.

```bash
# 安装nginx
sudo dnf install nginx

# 启动nginx（需要先确保80端口未被其他程序占用）
systemctl start nginx

# 设为开机启动
systemctl enable nginx
```

--------------------------------

### Install and Enable Nginx

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

Installs the Nginx web server using dnf and configures it to start automatically on system boot. Assumes port 80 is available.

```bash
# Install Nginx
sudo dnf install nginx

# Start Nginx (ensure port 80 is free)
systemctl start nginx

# Enable Nginx to start on boot
systemctl enable nginx
```

--------------------------------

### Full Nginx Configuration Example

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

A comprehensive Nginx configuration file including worker processes, logging, MIME types, and the server block for SSCMS reverse proxying. This serves as a complete setup for an Nginx server.

```nginx
user  nginx;
worker_processes  auto;

error_log  /var/log/nginx/error.log notice;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;
    sendfile        on;
    keepalive_timeout  65;
    client_max_body_size 500m;

    # SSCMS Nginx Config ...
    server {
        listen        80;
        server_name  _;
        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;
            proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header   X-Forwarded-Proto $scheme;
            proxy_set_header   X-Real-IP $remote_addr;
            proxy_connect_timeout       600;
            proxy_send_timeout          600;
            proxy_read_timeout          600;
            send_timeout                600;
        }
    }
}
```

--------------------------------

### SSCMS Systemd Service Status Example

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Example output showing the status of the SSCMS systemd service, indicating that it is loaded, enabled, and actively running.

```bash
● sscms.service - SSCMS
   Loaded: loaded (/etc/systemd/system/sscms.service; enabled; vendor preset: disabled)
   Active: active (running) since Sun 2020-08-30 04:40:33 CST; 9s ago
 Main PID: 17983 (dotnet)
   CGroup: /system.slice/sscms.service
           └─17983 /usr/bin/dotnet /var/www/SSCMS.Web.dll
```

--------------------------------

### .NET 8 Hosting Bundle Installer

Source: https://sscms.com/docs/v7/getting-started/using-windows

Download link for the .NET 8 Hosting Bundle installer required for SSCMS on Windows.

```url
https://dotnet.microsoft.com/zh-cn/download/dotnet/thank-you/runtime-aspnetcore-8.0.2-windows-hosting-bundle-installer
```

--------------------------------

### Complete Nginx Configuration Example

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

A full Nginx configuration file incorporating worker processes, logging, MIME types, keepalive settings, client body size limits, and the reverse proxy server block for SSCMS.

```nginx
user  nginx;
worker_processes  auto;

error_log  /var/log/nginx/error.log notice;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;
    sendfile        on;
    keepalive_timeout  65;
    client_max_body_size 500m;

    # SSCMS Nginx Config ...
    server {
        listen        80;
        server_name  _;
        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;
            proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header   X-Forwarded-Proto $scheme;
            proxy_set_header   X-Real-IP $remote_addr;
            proxy_connect_timeout       600;
            proxy_send_timeout          600;
            proxy_read_timeout          600;
            send_timeout                600;
        }
    }
}
```

--------------------------------

### Full Nginx Configuration Example

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

A comprehensive Nginx configuration file including worker processes, logging, MIME types, and the server block for SSCMS reverse proxying. This serves as a complete setup for an Nginx server.

```nginx
user  nginx;
worker_processes  auto;

error_log  /var/log/nginx/error.log notice;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;
    sendfile        on;
    keepalive_timeout  65;
    client_max_body_size 500m;

    # SSCMS Nginx Config ...
    server {
        listen        80;
        server_name  _;
        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;
            proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header   X-Forwarded-Proto $scheme;
            proxy_set_header   X-Real-IP $remote_addr;
            proxy_connect_timeout       600;
            proxy_send_timeout          600;
            proxy_read_timeout          600;
            send_timeout                600;
        }
    }
}
```

--------------------------------

### Complete Nginx Configuration Example

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

A full Nginx configuration file incorporating worker processes, logging, MIME types, keepalive settings, client body size limits, and the reverse proxy server block for SSCMS.

```nginx
user  nginx;
worker_processes  auto;

error_log  /var/log/nginx/error.log notice;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;
    sendfile        on;
    keepalive_timeout  65;
    client_max_body_size 500m;

    # SSCMS Nginx Config ...
    server {
        listen        80;
        server_name  _;
        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;
            proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header   X-Forwarded-Proto $scheme;
            proxy_set_header   X-Real-IP $remote_addr;
            proxy_connect_timeout       600;
            proxy_send_timeout          600;
            proxy_read_timeout          600;
            send_timeout                600;
        }
    }
}
```

--------------------------------

### Run SSCMS Application

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Commands to navigate to the SSCMS application directory and execute the main application DLL using the dotnet runtime. This starts the SSCMS backend service.

```bash
cd /var/www
dotnet SSCMS.Web.dll
```

--------------------------------

### Manage SSCMS Systemd Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Commands to enable the SSCMS systemd service for automatic startup, start the service immediately, and check its current status.

```shell
sudo systemctl enable sscms.service
sudo systemctl start sscms.service
sudo systemctl status sscms.service
```

--------------------------------

### Install .NET Core Runtime (X64) on NeoKylin

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Installs the Microsoft package repository and the ASP.NET Core runtime for .NET 8.0 on X64 architecture systems. Includes verification step.

```bash
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install aspnetcore-runtime-8.0
dotnet --info
```

--------------------------------

### Install ASP.NET Core Runtime and Verify

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Installs the ASP.NET Core 8.0 runtime, which is recommended for SSCMS. It also includes a command to verify the .NET Core installation.

```bash
sudo yum install aspnetcore-runtime-8.0

# 验证dotnet core runtime是否安装成功
dotnet --info
```

--------------------------------

### SSCMS Windows Installer Download Links

Source: https://sscms.com/docs/v7/getting-started/using-windows

Direct download links for the SSCMS 7.3 Windows installation packages for 64-bit and 32-bit operating systems.

```url
https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-win-x64.zip
```

```url
https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-win-x86.zip
```

--------------------------------

### SSCMS Systemd Service Status Example

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

Example output showing the status of the SSCMS systemd service, indicating that it is loaded, enabled, and actively running.

```bash
● sscms.service - SSCMS
   Loaded: loaded (/etc/systemd/system/sscms.service; enabled; vendor preset: disabled)
   Active: active (running) since Sun 2020-08-30 04:40:33 CST; 9s ago
 Main PID: 17983 (dotnet)
   CGroup: /system.slice/sscms.service
           └─17983 /usr/bin/dotnet /var/www/SSCMS.Web.dll
```

--------------------------------

### Enable and Start SSCMS Systemd Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Commands to enable the SSCMS service to start automatically on boot and to start the service immediately. Also includes a command to check the status of the running service.

```bash
sudo systemctl enable sscms.service
sudo systemctl start sscms.service
sudo systemctl status sscms.service
```

--------------------------------

### Install .NET Core Runtime (ARM64) on NeoKylin

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Installs the .NET Core runtime for ARM64 architecture by downloading binaries. It involves creating a directory, extracting the archive, and setting environment variables for the current session.

```bash
mkdir -p $HOME/dotnet && tar zxf aspnetcore-runtime-8.0.2-linux-arm64.tar.gz -C $HOME/dotnet
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet
```

--------------------------------

### Run SSCMS Application

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

Commands to navigate to the SSCMS application directory and execute the main application DLL using the dotnet runtime. This starts the SSCMS backend service.

```bash
cd /var/www
dotnet SSCMS.Web.dll
```

--------------------------------

### SSCMS Installation Wizard Access

Source: https://sscms.com/docs/v7/getting-started/using-mac

Access the SSCMS system's web-based installation interface by navigating to the specified URL in a web browser. This wizard guides users through environment checks, database setup, cache configuration, and administrator account creation.

```APIDOC
Access SSCMS Installation:
  URL: http://<IP地址或域名>/ss-admin/install

Installation Steps:
1. Agree to terms and conditions.
2. Environment detection.
3. Database settings (e.g., SQLite, MySQL, PostgreSQL).
4. Cache configuration (e.g., Default Cache, Redis).
5. Administrator account setup.
6. Installation completion.
```

--------------------------------

### Manage SSCMS Systemd Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Commands to enable the SSCMS systemd service for automatic startup, start the service immediately, and check its current status.

```shell
sudo systemctl enable sscms.service
sudo systemctl start sscms.service
sudo systemctl status sscms.service
```

--------------------------------

### Enable and Start SSCMS Systemd Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

Commands to enable the SSCMS service to start automatically on boot and to start the service immediately. Also includes a command to check the status of the running service.

```bash
sudo systemctl enable sscms.service
sudo systemctl start sscms.service
sudo systemctl status sscms.service
```

--------------------------------

### Install .NET Core Runtime (ARM64) on KylinOS

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Installs the .NET Core runtime for ARM64 architecture on KylinOS by downloading binaries. It involves creating a directory, extracting the archive, setting environment variables for the current session, and instructions for persistent configuration.

```bash
mkdir -p $HOME/dotnet && tar zxf aspnetcore-runtime-8.0.2-linux-arm64.tar.gz -C $HOME/dotnet
export DOTNET_ROOT=$HOME/dotnet
export PATH=$PATH:$HOME/dotnet

# 编辑 ~/.bash_profile 或 ~/.bashrc 文件，将 :$HOME/dotnet 添加到 PATH 语句末尾
```

--------------------------------

### Install .NET Core Runtime (X64) on KylinOS

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Installs the .NET Core runtime for X64 architecture on KylinOS. This involves adding Microsoft's package repository and installing the aspnetcore-runtime package. It also includes a verification step using 'dotnet --info'.

```bash
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install aspnetcore-runtime-8.0

# 验证dotnet core runtime是否安装成功
dotnet --info
```

--------------------------------

### Download SSCMS Installation Package

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Downloads the SSCMS installation package for Linux x64. It provides options using both wget and curl commands.

```bash
wget https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz
# 或者
curl -O https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz
```

--------------------------------

### Install .NET Core Runtime on CentOS/RHEL

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

Installs the Microsoft package repository and the ASP.NET Core runtime 8.0, essential for running SSCMS applications. Includes verification command.

```bash
sudo rpm -Uvh https://packages.microsoft.com/config/centos/8/packages-microsoft-prod.rpm

sudo dnf install aspnetcore-runtime-8.0

# Verify dotnet core runtime installation
dotnet --info
```

--------------------------------

### Install Nginx on NeoKylin

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Installs Nginx on NeoKylin by first adding the official Nginx repository for CentOS 7, then proceeding with the Nginx installation using yum.

```bash
sudo rpm -Uvh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
# 安装nginx
sudo yum install nginx
```

--------------------------------

### Test Nginx Configuration Syntax

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Command to test the syntax of Nginx configuration files before applying them. This helps prevent Nginx from failing to start due to configuration errors.

```bash
sudo nginx -t
```

--------------------------------

### Test Nginx Configuration Syntax

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

Command to test the syntax of Nginx configuration files before applying them. This helps prevent Nginx from failing to start due to configuration errors.

```bash
sudo nginx -t
```

--------------------------------

### Run SSCMS Application

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Commands to navigate to the SSCMS application directory and execute the main application DLL using the .NET runtime.

```shell
cd /var/www
dotnet SSCMS.Web.dll
```

--------------------------------

### Download and Extract SSCMS (X64) on NeoKylin

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Downloads the SSCMS installation package for X64 architecture using wget or curl, then extracts it to the specified directory and removes the archive.

```bash
mkdir -m 666 /var/www/
cd /var/www/

wget https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz
# 或者
curl -O https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz

tar -xzf sscms-7.3.0-linux-x64.tar.gz
rm sscms-7.3.0-linux-x64.tar.gz -f
```

--------------------------------

### SSCMS CLI Installation Commands

Source: https://sscms.com/docs/v7/cli/commands/register

Commands related to the installation process of SSCMS, including database setup and downloading installation packages.

```APIDOC
sscms install database
  Description: Installs the database for SSCMS.

sscms install download
  Description: Downloads the SSCMS installation package.
```

--------------------------------

### Run SSCMS Application

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Commands to navigate to the SSCMS application directory and execute the main application DLL using the .NET runtime.

```shell
cd /var/www
dotnet SSCMS.Web.dll
```

--------------------------------

### Download and Extract SSCMS (ARM64) on NeoKylin

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Downloads the SSCMS installation package for ARM64 architecture using wget or curl, then extracts it to the specified directory and removes the archive.

```bash
mkdir -m 666 /var/www/
cd /var/www/

wget https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-arm64.tar.gz
# 或者
curl -O https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-arm64.tar.gz

tar -xzf sscms-7.3.0-linux-arm64.tar.gz
rm sscms-7.3.0-linux-arm64.tar.gz -f
```

--------------------------------

### Download and Extract SSCMS Package (X64) on KylinOS

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Downloads the SSCMS installation package for X64 architecture using wget or curl, extracts it to a specified directory (e.g., /var/www), and then removes the downloaded archive. Assumes the target directory is created.

```bash
mkdir -m 666 /var/www/
cd /var/www

wget https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz
# 或者
curl -O https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz

tar -xzf sscms-7.3.0-linux-x64.tar.gz
rm sscms-7.3.0-linux-x64.tar.gz -f
```

--------------------------------

### Install Microsoft Package Repository for CentOS

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Adds the Microsoft package signing key and repository to your CentOS system. This is a prerequisite for installing .NET Core runtimes.

```bash
sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
```

--------------------------------

### Restart IIS Commands

Source: https://sscms.com/docs/v7/getting-started/using-windows

Commands to restart IIS services after installing the .NET Core Hosting Bundle to apply system PATH changes.

```shell
net stop was /y
net start w3svc
```

--------------------------------

### Complete SSCMS Nginx Configuration Example

Source: https://sscms.com/docs/v7/getting-started/using-linux-open-euler

A comprehensive Nginx configuration file for SSCMS, including global settings like worker processes, logs, MIME types, and the server block for reverse proxying.

```nginx
user  nginx;
worker_processes  auto;

error_log  /var/log/nginx/error.log notice;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;
    sendfile        on;
    keepalive_timeout  65;
    client_max_body_size 500m;

    # SSCMS Nginx Config ...
    server {
        listen        80;
        server_name  _;
        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;
            proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header   X-Forwarded-Proto $scheme;
            proxy_set_header   X-Real-IP $remote_addr;
            proxy_connect_timeout       600;
            proxy_send_timeout          600;
            proxy_read_timeout          600;
            send_timeout                600;
        }
    }
}
```

--------------------------------

### Start SSCMS Systemd Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-open-euler

Command to start the SSCMS service immediately. This command is used after enabling the service or for manual service management.

```bash
sudo systemctl start sscms.service
```

--------------------------------

### Run SSCMS Application Directly

Source: https://sscms.com/docs/v7/getting-started/using-linux-open-euler

Commands to navigate to the SSCMS application directory and start the application using the .NET runtime. This is often used for initial testing or manual execution.

```bash
cd /var/www
dotnet SSCMS.Web.dll
```

--------------------------------

### Download and Extract SSCMS Package (ARM64) on KylinOS

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Downloads the SSCMS installation package for ARM64 architecture using wget or curl, extracts it to a specified directory (e.g., /var/www), and then removes the downloaded archive. Assumes the target directory is created.

```bash
mkdir -m 666 /var/www/
cd /var/www

wget https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-arm64.tar.gz
# 或者
curl -O https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-arm64.tar.gz

tar -xzf sscms-7.3.0-linux-arm64.tar.gz
rm sscms-7.3.0-linux-arm64.tar.gz -f
```

--------------------------------

### Download and Extract SSCMS Package

Source: https://sscms.com/docs/v7/getting-started/using-linux-rhel

Creates a directory for SSCMS, downloads the latest Linux x64 package using wget or curl, extracts the archive, and cleans up the downloaded file.

```bash
# Create and enter SSCMS directory
mkdir -m 666 /var/www/
cd /var/www

# Download SSCMS package (replace with latest URL from official website)
# Using wget:
# wget https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz
# Or using curl:
curl -O https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz

# Extract and remove the archive
tar -xzf sscms-7.3.0-linux-x64.tar.gz
rm sscms-7.3.0-linux-x64.tar.gz -f
```

--------------------------------

### Database Connection Configuration Example (sscms.json)

Source: https://sscms.com/docs/v7/cli/advanced/older-version-upgrade

Example JSON structure for specifying database connection details for the new SSCMS version, used by the 'sscms data restore' command.

```json
{
  "Database": {
    "Type": "SqlServer",
    "ConnectionString": "Server=(local);Uid=sa;Pwd=123456;Database=cms7;"
  }
}
```

--------------------------------

### Test Nginx Configuration Syntax

Source: https://sscms.com/docs/v7/getting-started/using-linux-open-euler

Command to verify the syntax of the Nginx configuration files before applying them. This helps prevent Nginx from failing to start due to configuration errors.

```bash
sudo nginx -t
```

--------------------------------

### Enable SSCMS Systemd Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-open-euler

Command to configure the systemd service manager to start the SSCMS service automatically when the system boots up.

```bash
sudo systemctl enable sscms.service
```

--------------------------------

### Database Connection Configuration Example (old.json)

Source: https://sscms.com/docs/v7/cli/advanced/older-version-upgrade

Example JSON structure for specifying database connection details for older SSCMS versions, used by the 'sscms data backup' command.

```json
{
  "Database": {
    "Type": "SqlServer",
    "ConnectionString": "Server=(local);Uid=sa;Pwd=123456;Database=cms6;"
  }
}
```

--------------------------------

### SSCMS Systemd Service Definition

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Defines a systemd service for SSCMS, specifying the working directory, the command to execute, restart policies, and user context. This ensures SSCMS runs reliably in the background.

```systemd
[Unit]
Description=SSCMS

[Service]
WorkingDirectory=/var/www
ExecStart=/usr/bin/dotnet /var/www/SSCMS.Web.dll
Restart=always
# Restart service after 10 seconds if the sscms service crashes:
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=sscms
User=root
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target
```

--------------------------------

### Run SSCMS Application

Source: https://sscms.com/docs/v7/cli/commands/install-database

This snippet shows how to run the SSCMS system using the 'sscms run' command. It includes example output logs detailing the application startup process, listening address, and environment details. Note that the 'run' command is intended for experience and quick startup, not formal deployment.

```shell
sscms run
Starting SSCMS...
[09:26:45 WRN] Unknown element with name 'doc' found in keyring, skipping. <s:Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager>
[09:26:45 INF] Creating key {b1e20d90-5e72-4717-b137-dd1974171a6f} with creation date 2023-09-16 01:26:45Z, activation date 2023-09-16 01:26:45Z, and expiration date 2023-12-15 01:26:45Z. <s:Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager>
[09:26:45 WRN] No XML encryptor configured. Key {b1e20d90-5e72-4717-b137-dd1974171a6f} may be persisted to storage in unencrypted form. <s:Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager>
[09:26:45 INF] Writing data to file '/var/www/key-b1e20d90-5e72-4717-b137-dd1974171a6f.xml'. <s:Microsoft.AspNetCore.DataProtection.Repositories.FileSystemXmlRepository>
[09:26:45 WRN] Unknown element with name 'doc' found in keyring, skipping. <s:Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager>
[09:26:46 INF] Now listening on: http://localhost:5000 <s:Microsoft.Hosting.Lifetime>
[09:26:46 INF] Application started. Press Ctrl+C to shut down. <s:Microsoft.Hosting.Lifetime>
[09:26:46 INF] Hosting environment: Production <s:Microsoft.Hosting.Lifetime>
[09:26:46 INF] Content root path: /var/www <s:Microsoft.Hosting.Lifetime>
```

--------------------------------

### Hello World Plugin Startup

Source: https://sscms.com/docs/v7/plugin/plugin-anatomy

Example of a basic plugin startup class inheriting the IPluginExtension interface for SSCMS.

```C#
using SSCMS.Plugins;

namespace Demo.HelloWorld
{
    public class Startup : IPluginExtension
    {
    }
}
```

--------------------------------

### SSCMS CLI: Run Command

Source: https://sscms.com/docs/v7/cli/commands/install-download

Starts the SSCMS system. This command is typically used for testing or quick startup, not for formal deployment.

```APIDOC
sscms run

  Starts the SSCMS system.

  Usage:
    sscms run

  Example Output:
    Starting SSCMS...
    [09:26:45 WRN] Unknown element with name 'doc' found in keyring, skipping. <s:Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager>
    [09:26:45 INF] Now listening on: http://localhost:5000 <s:Microsoft.Hosting.Lifetime>
    [09:26:46 INF] Application started. Press Ctrl+C to shut down. <s:Microsoft.Hosting.Lifetime>

  Note:
    This command is generally for testing and quick startup. For formal deployments, use other methods.
```

--------------------------------

### SSCMS CLI Commands Overview

Source: https://sscms.com/docs/v7/cli/commands/install-database

Lists available SSCMS CLI commands for system management, data operations, plugin development, and theme deployment.

```APIDOC
SSCMS CLI Commands:

- build: Generates build artifacts.
- data backup: Backs up SSCMS data.
- data restore: Restores SSCMS data from a backup.
- data sync: Synchronizes SSCMS data.
- data update: Updates SSCMS data.
- install database: Installs the SSCMS database.
- install download: Downloads SSCMS installation packages.
- login: Logs into the SSCMS system.
- logout: Logs out of the SSCMS system.
- plugin new: Creates a new SSCMS plugin.
- plugin package: Packages an SSCMS plugin.
- plugin publish: Publishes an SSCMS plugin.
- plugin unpublish: Unpublishes an SSCMS plugin.
- register: Registers a new user or component.
- run: Executes SSCMS processes.
- status: Checks the status of SSCMS services.
- theme package: Packages an SSCMS theme.
- theme publish: Publishes an SSCMS theme.
- theme unpublish: Unpublishes an SSCMS theme.
- update: Updates the SSCMS system.
```

--------------------------------

### Set Nginx Client Max Body Size

Source: https://sscms.com/docs/v7/getting-started/using-linux-neo-kylin

Directive to increase the maximum allowed size for client request bodies, commonly used to permit larger file uploads through Nginx. Set to 500MB in this example.

```nginx
client_max_body_size 500m;
```

--------------------------------

### Set Nginx Client Max Body Size

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Directive to increase the maximum allowed size for client request bodies, commonly used to permit larger file uploads through Nginx. Set to 500MB in this example.

```nginx
client_max_body_size 500m;
```

--------------------------------

### SSCMS CLI Build Command Examples

Source: https://sscms.com/docs/v7/cli/commands/build

Provides practical examples of how to use the 'sscms build' command, demonstrating generation for a specific site, all sites, and with a repeat interval.

```APIDOC
Example 1: Generate all files for the 'grace' site folder.
sscms build -d grace

Output:
Database type: SQLite
Database connection string: Data Source=~/database.sqlite;Version=3;
site: Grace
SUCCESS create pages successfully!

Example 2: Generate all sites.
sscms build -a

Example 3: Generate all sites daily.
sscms build -a -r 1d
```

--------------------------------

### Get Single Data Entity (C#)

Source: https://sscms.com/docs/v7/plugin/datory/select

Demonstrates how to retrieve a single data entity using the GetAsync method. It shows examples for fetching by ID, by GUID, and by a custom Query object, including handling cases where no data is found.

```csharp
var repository = new Repository<DataModel>(settingsManager.Database, settingsManager.Redis);
var dataModel = await repository.GetAsync(10);
```

```csharp
var repository = new Repository<DataModel>(settingsManager.Database, settingsManager.Redis);
var dataModel = await repository.GetAsync(Q
  .Where("SiteId", 1)
  .OrderByDesc("Taxis")
);
```

--------------------------------

### SSCMS v7 Site Creation Methods Overview

Source: https://sscms.com/docs/v7/handbook/settings/sitesAdd

This section outlines the different approaches available for creating new websites in SSCMS v7, providing a high-level overview of each method.

```APIDOC
SSCMS v7 Site Creation:

1.  **Create Empty Site**:
    -   Manually configure all site settings.
    -   Allows detailed control over site name, level, folder, and content table.

2.  **Create Site Using Local Site Template**:
    -   Utilizes templates stored in the `sitefiles/sitetemplates` directory.
    -   Select a template and configure site-specific details.
    -   Includes options for importing specific data categories from the template.

3.  **Create Site Using Online Site Template**:
    -   Accesses templates from the official SSCMS template center.
    -   Supports both free and purchased templates.
    -   Configuration mirrors 'Create Empty Site' after template selection.

4.  **Create Site Importing Site Template**:
    -   Uploads a site template packaged as a ZIP file.
    -   System processes the uploaded template and allows configuration similar to other methods.
```

--------------------------------

### Extract SSCMS Installation Package

Source: https://sscms.com/docs/v7/getting-started/using-linux-centos

Extracts the downloaded SSCMS tarball to the current directory and then removes the installation archive file.

```bash
tar -xzf sscms-7.3.0-linux-x64.tar.gz
rm sscms-7.3.0-linux-x64.tar.gz -f
```

--------------------------------

### Enable and Start SSCMS Systemd Service

Source: https://sscms.com/docs/v7/getting-started/using-linux-rocky

Commands to enable the SSCMS service to start on boot and to start the service immediately. Also shows how to check its status.

```bash
sudo systemctl enable sscms.service
sudo systemctl start sscms.service
sudo systemctl status sscms.service
```

--------------------------------

### Install Nginx on KylinOS

Source: https://sscms.com/docs/v7/getting-started/using-linux-kylin-os

Installs the Nginx web server on KylinOS. This involves adding the Nginx repository configuration for CentOS 7 and then using yum to install the Nginx package. It notes that custom modules might require building from source.

```bash
sudo rpm -Uvh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm

# 安装nginx
sudo yum install nginx
```

--------------------------------

### Web.config Database Connection String Example

Source: https://sscms.com/docs/v7/cli/advanced/older-version-upgrade

Example of how database connection information is typically stored in the Web.config file for SSCMS.

```xml
<add key="DatabaseType" value="SqlServer" />
<add key="ConnectionString" value="Server=(local);Uid=sa;Pwd=123456;Database=cms6;" />
```

--------------------------------

### Fix Dameng Database Installation Redirect

Source: https://sscms.com/docs/v7/updates/v7_3_0

Resolves an issue where installation would always redirect to the setup interface when using Dameng database, referencing issue #3638.

```Database
// Fix: Dameng database installation redirecting to setup interface (#3638)
```

--------------------------------

### Advertisement Plugin Startup with Service Registration

Source: https://sscms.com/docs/v7/plugin/plugin-anatomy

Demonstrates a plugin startup class inheriting IPluginConfigureServices to register custom services with dependency injection.

```C#
using Microsoft.Extensions.DependencyInjection;
using SSCMS.Advertisement.Abstractions;
using SSCMS.Advertisement.Core;
using SSCMS.Plugins;

namespace SSCMS.Advertisement
{
    public class Startup : IPluginConfigureServices
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddScoped<IAdvertisementRepository, AdvertisementRepository>();
        }
    }
}
```

--------------------------------

### Download and Extract SSCMS Package on Linux

Source: https://sscms.com/docs/v7/getting-started/using-linux-rocky

Steps to create a directory, download the SSCMS Linux package using wget or curl, extract the archive, and clean up the installer file.

```bash
mkdir -m 666 /var/www/
cd /var/www

wget https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz
# 或者
curl -O https://dl.sscms.com/cms/7.3.0/sscms-7.3.0-linux-x64.tar.gz

tar -xzf sscms-7.3.0-linux-x64.tar.gz
rm sscms-7.3.0-linux-x64.tar.gz -f
```

--------------------------------

### SSCMS CLI: install download command

Source: https://sscms.com/docs/v7/cli/commands/run

Downloads the SSCMS installation package. It prompts for the installation directory and then proceeds with the download. After successful download, it suggests running the 'install database' command.

```shell
sscms install download
Do you want to install SSCMS in /var/www ? [Y/n] Y
Downloading SSCMS 7.3.0...
SUCCESS  7.3.0 download successfully!
Database type(mysql,sqlserver,postgresql,sqlite): sqlite
Protect settings in sscms.json? [Y/n] n
SUCCESS  SSCMS was download and ready for install, please run: sscms install database
```

--------------------------------

### Verify .NET Core Runtime Installation

Source: https://sscms.com/docs/v7/getting-started/using-mac

This command verifies if the .NET Core runtime has been successfully installed on the system, which is a prerequisite for running SSCMS.

```bash
dotnet --info
```

--------------------------------

### Run SSCMS Application Directly

Source: https://sscms.com/docs/v7/getting-started/using-linux-rocky

Commands to navigate to the SSCMS application directory and start the application using the dotnet CLI.

```bash
cd /var/www
dotnet SSCMS.Web.dll
```

--------------------------------

### SSCMS CLI: install database Command

Source: https://sscms.com/docs/v7/cli/commands/plugin-unpublish

The `install database` command is used to install or set up the system's database.

```APIDOC
sscms install database
    [options]

Description:
  Installs the database.
```

--------------------------------

### SSCMS CLI: Plugin Management Commands

Source: https://sscms.com/docs/v7/cli/commands/install-download

Provides commands for managing plugins, including creating, packaging, publishing, and unpublishing them.

```APIDOC
sscms plugin new
  Creates a new plugin.

sscms plugin package
  Packages an existing plugin.

sscms plugin publish
  Publishes a plugin to the official repository.

sscms plugin unpublish
  Removes a plugin from the official repository.
```
Tokens:
Raw