获取授权

安装 CMS.Cndk:IIS、Plesk 与 Linux VPS 指南

上传适用于 Windows 或 Linux 的自包含安装包,打开浏览器中的安装向导,从选择语言一路走到创建管理员账户。

阅读约 1 分钟

安装

一提到安装 CMS,很多人就觉得乐趣到此为止了:要匹配运行时,要核对版本,还有一个谁都不想碰的配置文件。CMS.Cndk 尽量把这一步缩短:您只需上传一个安装包,在浏览器里打开一个页面,剩下的由向导带您完成。

一个安装包,无需安装运行时

CMS.Cndk 以自包含(self-contained)安装包的形式提供,分为 Windows(x64)和 Linux(x64)两个版本。安装包内置 .NET 运行时,因此服务器上不必安装 .NET。这有点像自带炉具的露营套装:您只需要找个地方把它支起来。

那么,可以支在哪里呢?

  • Windows: 任何 IIS 服务器,以及 Plesk Windows 主机。IIS 只需要随 .NET Hosting Bundle 一起安装的 ASP.NET Core Module V2。
  • Linux: 一台 VPS,应用以 systemd 服务运行,前面由 nginx 反向代理提供域名和 HTTPS。
  • 不支持: Linux 共享主机,例如 cPanel 或 Plesk Linux。

数据库有三种选择。SQLite 是默认选项,不需要额外的服务器。如果您更想用数据库服务器,也支持 SQL Server 2019 及以上版本和 PostgreSQL 14 及以上版本。

适合谁

主要是两类人。一类是为客户安装 CMS 的代理公司和 IT 人员,比如一家在同一周里为牙科诊所和面包店搭建网站的网络公司。另一类是在 Windows 主机或 Linux VPS 上自己托管网站、希望把网站握在自己手里的企业。

一步步安装

文件上传后,位于 /cndk-install 的浏览器安装向导会一步步完成安装:语言、数据库、环境要求检查、网站信息、许可证和管理员账户。

  1. 准备服务器。在 Windows/IIS 或 Plesk 上,为网站单独建立一个应用程序池:.NET CLR 版本设为 "No Managed Code",使用集成(Integrated)管道,并关闭 32 位应用程序。把安装包上传到网站根目录,并为该池的实际账户(IIS AppPool\[池名称],或 Plesk 自己的进程账户)授予网站根目录的“修改”(Modify)权限,并应用到子文件夹和文件。在 Linux VPS 上,上传安装包,用一个能写入应用目录和数据目录的独立用户将其作为 systemd 服务运行,并在前面放置启用 HTTPS 的 nginx。
  2. 打开 https://your-domain/cndk-install,选择语言。
  3. 选择数据库。选 SQLite 可以直接继续;选 SQL Server 或 PostgreSQL 时,填写一个空数据库的连接信息,并在继续之前点击 Test connection(测试连接)。
  4. 查看环境要求这一步,它会检查数据目录和网站根目录的写入权限。然后填写网站信息和许可证。
  5. 创建管理员账户。系统会为您生成一个强密码;请把它和最后一屏显示的 superadmin 信息一起保存好。
  6. 在开发模式下准备网站,准备就绪后选择 Make the site live(发布网站)。

第 6 步值得多说几句。新网站从开发模式开始:只有 superadmin 能看到公开网站,访客看到的是一个准备中页面。就像货架还在上货时,贴在橱窗上的那张告示。等内容、菜单、SEO 和备份都准备好后,进入 Superadmin → System(系统),选择 Make the site live。

安装完成后,/cndk-install 这个地址会返回 404。客户面板位于 /cndk-admin,所有者(superadmin)面板位于 /cndk-superadmin。

开始前值得了解

有些事情第一天就做对,比以后再改要容易得多:

  • 慎重选择数据库。 数据库的选择以后无法在面板中更改。
  • 许可证跟着域名走。 许可证绑定域名,所以本地地址和测试地址也需要覆盖它们的许可证。
  • 权限要给整个网站根目录。 以后能在面板中更新,靠的正是网站根目录(而不只是数据目录)上的“修改”权限。
  • 别让 IIS 睡着。 在 IIS 上,空闲的应用可能会被休眠,导致计划任务延迟。请使用 "AlwaysRunning" 和预加载(preload)设置,或者通过计划任务(例如在 Plesk 中)每隔几分钟调用一次 /cndk/cron。
  • 把私密文件锁好。 安装完成后,请确认私密数据文件无法从外部下载。

提示: 如果 IIS 给您的是 "HTTP Error 500.30",先检查应用程序池设置和权限。如果还是找不到原因,就临时打开 stdout 日志,或在 Windows 事件查看器中查找 ASP.NET Core Module 的错误,查完后再把日志关掉。

手头有 Windows 服务器、Plesk 账户或 Linux VPS 吗?上传安装包,打开 /cndk-install,在别人看到之前,看着您的网站在开发模式下一点点成形。如果您不想自己安装任何东西,也可以选择已包含服务器安装的 成品网站。