PolyCMS 安装指南：从零到上线

Last updated on Jun 24, 2026 03:00

欢迎来到 PolyCMS – 现代内容管理和电子商务平台，旨在帮助每个人，从个人博主和创作者，到自由网页设计师、代理机构和大型企业，构建快速、安全且经过 SEO 优化的网站。

无论您是要推出个人博客、作为自由职业者构建客户的投资组合，还是为企业部署复杂的电子商务商店，本指南都将引导您在短短几分钟内完成在服务器上设置 PolyCMS。

对于非技术用户： 如果您不熟悉服务器或源代码，请不要担心！您只需将本指南的链接直接发送给您的网络托管提供商或 IT 支持团队即可。他们将能够为您处理安装。

系统要求

为了确保 PolyCMS 顺利运行，您的服务器（托管或 VPS）必须满足以下基本要求：

PHP：版本 8.3 或更高版本。

Node.js：版本 20.19+ 或 22.12+（编译高速前端资源所需）。

数据库：PostgreSQL（推荐以获得最佳性能）或 MySQL。

包管理器：Composer 和 NPM。

3 个简单的安装步骤

PolyCMS 具有适合初学者的 Web 安装程序。您不需要接触任何代码或使用终端来运行您的网站。

第 1 步：上传源代码

要获取 PolyCMS 源代码，根据您的技术偏好，您有两种选择：

下载预打包版本（推荐）： 您可以直接从 GitHub 版本页面下载最新的、可立即安装的软件包 (polycms-ce.zip)。该 zip 包包含所有预编译的资源，可以立即部署。
从源克隆和重建： 开发人员和高级用户可以从 github.com/PolyXGO/polycms 克隆存储库来自定义代码并手动构建/编译资产。

准备好包裹后：

登录到您的网络托管控制面板（如 cPanel 或 DirectAdmin）或通过 FTP 连接。

将“.zip”文件上传到您的公共 Web 目录（通常为“public_html”或“www”）。

将 zip 文件的内容直接提取到该目录中。

第 2 步：创建数据库

在运行安装程序之前，您的网站需要一个位置来存储其数据。

选项 A：通过主机控制面板（推荐）

在您的主机控制面板中，找到 数据库 部分（例如 MySQL 数据库）。

创建一个新数据库（例如“polycms”）。

创建一个新的数据库用户（例如“polycms_user”）并分配一个强密码。

使用 所有权限 将用户添加到数据库。

选项 B：通过 SQL（phpMyAdmin 或命令行）

如果您更喜欢使用 SQL 或者您的托管面板没有向导：

CREATE DATABASE polycms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'polycms_user'@'localhost' IDENTIFIED BY 'your_password_here';
GRANT ALL PRIVILEGES ON polycms.* TO 'polycms_user'@'localhost';
FLUSH PRIVILEGES;

重要：MySQL 主机匹配

创建数据库用户时，注意host部分：

如果您的 Web 服务器和数据库位于同一台计算机（大多数共享主机），请使用“polycms_user”@“localhost”。

仅当您的数据库位于单独的服务器上时，才使用“polycms_user”@“%”。

如果您使用“@'%'”创建了用户，但安装程序显示“User@localhost 的访问被拒绝”，您还需要为“localhost”创建用户：

CREATE USER 'polycms_user'@'localhost' IDENTIFIED BY 'your_password_here';
GRANT ALL PRIVILEGES ON polycms.* TO 'polycms_user'@'localhost';
FLUSH PRIVILEGES;

这是因为 MySQL 将“localhost”（Unix 套接字）和“%”（TCP 通配符）视为不同的主机。 “%”通配符不匹配“localhost”连接。

请保留您的数据库名称、用户名和密码，以供下一步使用。

步骤 3：运行 Web 设置向导

打开您最喜欢的网络浏览器并导航到您网站的域名（例如https://<a href="//polycms.org" target="_blank" rel="nofollow">polycms.org</a>）。

PolyCMS 设置向导将自动出现并欢迎您。

按照屏幕上的说明进行操作：

系统检查： 安装程序将验证您的服务器是否满足所有要求。 * 数据库配置： 输入您在步骤 2 中创建的数据库名称、用户名和密码。 * 站点信息： 提供您的站点标题并创建您的管理员帐户（电子邮件和密码）。

单击“安装 PolyCMS”。

系统将在后台自动设置数据库、配置环境并完成安装。

欢迎来到您的仪表板

设置完成后，您将被重定向到登录页面。使用您刚刚创建的管理员电子邮件和密码访问管理面板。

需要更多帮助吗？

您是代理机构吗？ 查看主题和模块开发部分，为您的客户深度定制系统。

想要开始销售吗？ 前往电子商务商店配置开始列出您的产品。