MODX是一款基于PHP的开源内容管理系统（CMS）和内容管理框架（CMF）。与WordPress不同，它不强制使用固定的文章/页面/分类结构，而是采用灵活的资源（Resource）模型，让开发者可以自由定义URL结构、模板和内容结构。当前版本为MODX Revolution 3.x。

MODX可以通过Softaculous自动安装吗？

不可以。MODX不在Softaculous自动安装器中。您需要从modx.com下载安装包，通过文件管理器或FTP上传至主机，解压文件后在浏览器中运行Web安装程序。整个过程大约需要15-20分钟。

MODX和WordPress有什么区别？

WordPress使用固定的文章/页面/分类层次结构，适合博客和普通网站。MODX使用灵活的资源模型，允许完全自定义URL结构、完全控制模板，更适合需要独特内容架构的企业网站、作品集和自定义Web应用程序。

MODX支持中文吗？

完全支持中文。只需将MySQL排序规则设置为utf8mb4_unicode_ci，并将PHP默认字符集设置为UTF-8，即可完美支持中文及所有Unicode字符。

MODX有免费的扩展（Extra）可用吗？

有许多免费扩展。MODX包管理器提供modx.com/extras上的众多免费扩展，如pdoTools（高级数据库查询）、Wayfinder（导航菜单）、FormIt（表单处理）、getPage（分页）和GoogleSiteMap（XML站点地图）。

在DirectAdmin主机上安装MODX CMS：比WordPress更灵活的建站方案

Q: MODX需要什么PHP版本？

MODX Revolution 3.x至少需要PHP 7.4，推荐使用PHP 8.1或8.2以获得最佳性能和安全性。还需要MySQL 5.6+（InnoDB引擎）以及PHP扩展：pdo_mysql、curl、gd、zlib和mbstring。

Q: AsiaGB主机支持MODX吗？

完全支持。AsiaGB主机提供PHP 8.x、InnoDB MySQL、Apache mod_rewrite，均可通过DirectAdmin控制面板管理。SSD存储、99%正常运行时间保证，套餐起价500泰铢/月，为MODX安装提供坚实基础。

🔧

MODX Revolution 3 · DirectAdmin · PHP 8

1. MODX CMS是什么？

MODX是一款基于PHP的开源内容管理系统（CMS）和内容管理框架（CMF），最初于2004年发布。当前版本为MODX Revolution 3.x，这是一次重大重写，旨在让开发者对网站结构拥有完全的控制权。

与WordPress不同，MODX不强制使用固定的"文章/页面/分类"层次结构，而是采用资源（Resource）模型——开发者可以独立定义URL结构、模板分配和所有内容字段。这使MODX非常适合企业官网、作品集、自定义Web应用程序以及任何需要非标准内容架构的项目。

✅ MODX Revolution 3.x是当前的稳定版本，支持PHP 8.x并持续提供安全更新——新项目请始终使用此版本。

MODX核心架构

资源（Resource）：基本内容单元（类似WordPress的页面，但更灵活）
模板（Template）：定义页面布局，通过占位符从资源中获取数据
区块（Chunk）：可复用的HTML片段（类似include文件）
代码片段（Snippet）：可在模板中调用的PHP代码（类似WordPress短代码）
扩展（Extra）：通过MODX包管理器安装的扩展包（类似WordPress插件）

2. MODX与WordPress对比

了解MODX和WordPress之间的主要差异，有助于您为项目选择最合适的工具。

功能	MODX Revolution 3	WordPress 6.x
URL结构	100%自定义	固定的文章/页面层次
模板灵活性	非常高——完全控制HTML	依赖主题
市场份额	小众，面向开发者	最高（约占全球43%）
插件/扩展	较少，经过精选	超过60,000个插件
安全攻击面	较低（目标度较低）	频繁被攻击
非开发者易用性	学习曲线较陡	初学者友好
PHP要求	7.4+（推荐8.1/8.2）	7.4+（推荐8.1+）
安装包大小	约20 MB	约22 MB
Softaculous自动安装	❌ 不支持	✅ 支持

⚠️ 适用场景：当您需要完全控制HTML/CSS、自定义URL架构或非标准内容结构时，选择MODX。当团队缺乏HTML知识、需要简单博客或依赖大型插件生态系统时，选择WordPress。

3. 安装前的系统要求

在DirectAdmin主机上安装MODX之前，请确认您的主机套餐满足以下所有要求。

组件	最低要求	推荐配置
PHP	7.4	8.1 或 8.2
MySQL / MariaDB	5.6（InnoDB）	8.0 / MariaDB 10.6
PHP扩展	pdo_mysql、curl、gd、zlib	+ intl、mbstring
Apache模块	mod_rewrite	mod_rewrite + AllowOverride All
磁盘空间	100 MB	1 GB或以上
PHP内存限制	128 MB	256 MB或以上

✅ AsiaGB主机已预装PHP 8.x、MySQL（InnoDB）和Apache mod_rewrite，均可通过DirectAdmin控制面板轻松管理。安装MODX前无需额外的服务器配置。SSD存储，99%正常运行时间保证。

在DirectAdmin中验证PHP扩展

进入DirectAdmin → 扩展功能 → PHP配置（或创建phpinfo.php文件），确认以下扩展已启用：pdo_mysql、curl、gd、zlib、json、mbstring。

4. 下载并上传MODX文件

由于MODX不在Softaculous中，您需要手动下载并上传安装包。

4.1 下载MODX

访问 modx.com/download 或官方GitHub发布页面
选择最新的 MODX Revolution 版本（3.x）
下载文件 modx-3.x.x-pl.zip

4.2 通过DirectAdmin文件管理器上传

登录DirectAdmin → 文件 → 文件管理器
导航至 public_html/（或您的目标目录）
点击上传文件 → 选择下载的.zip文件
上传后，在文件管理器中点击解压该zip文件
将所有解压的文件移动到 public_html/ 根目录

# 上传解压后的文件结构
public_html/
├── setup/          ← Web安装程序（安装后立即删除）
├── core/           ← 核心系统（可移至webroot外）
├── manager/        ← 管理后台
├── connectors/     ← API连接器
├── assets/         ← 媒体文件和扩展包
├── index.php
└── .htaccess
  

5. 在DirectAdmin中创建MySQL数据库

MODX需要配置 utf8mb4 字符集的MySQL数据库，以正确支持中文字符和Emoji表情。

5.1 创建新数据库

进入DirectAdmin → 扩展功能 → MySQL管理
点击创建新数据库
输入数据库名称，例如 modx_db
创建数据库用户并设置强密码
授予该用户对新数据库的所有权限

⚠️ 请记录数据库名称、用户名和密码。在接下来的Web安装程序步骤中需要这些信息。

5.2 设置字符排序规则（推荐）

打开phpMyAdmin → 选择新数据库 → 点击"操作"标签 → 将排序规则更改为 utf8mb4_unicode_ci → 点击"执行"。

6. 运行Web安装程序

文件上传完毕且数据库创建好后，即可从浏览器启动Web安装程序。

打开浏览器，访问 https://yourdomain.com/setup/
选择您的首选语言（推荐英文以确保稳定性）
选择新安装
输入数据库凭据：主机（localhost）、数据库名称、用户名、密码
设置数据表前缀（默认：modx_）
创建管理员账户：用户名、强密码、邮箱
点击安装，等待2-5分钟
安装成功后，立即删除 setup/ 文件夹

✅ 安装完成后立即删除setup/文件夹。保留该文件夹存在安全风险——任何人都可能重新运行安装程序并覆盖您的配置。

访问MODX管理后台

安装成功后，在 https://yourdomain.com/manager/ 使用您创建的凭据登录管理后台。

7. 安装后配置

安装完成后，应立即进行以下重要配置，以提高安全性和性能。

7.1 更改管理器路径（推荐）

默认管理器路径 /manager/ 是众所周知的，建议将其重命名以降低暴力破解攻击的风险。

系统 → 系统设置 → 搜索 manager_path
设置新路径，例如 /admin2026/
在文件管理器中将 manager/ 文件夹重命名为匹配的名称

7.2 网站核心设置

site_name：您的网站名称
site_url：网站基础URL（含https://）
default_template：新资源的默认模板ID
error_page：404错误页面的资源ID
cache_disabled：开发阶段设为是，以立即看到更改效果

7.3 配置电子邮件（SMTP）

进入系统 → 系统设置，搜索 emailfrom 和 mail_smtp_host，配置SMTP以启用系统邮件通知功能。

8. 创建资源、模板和区块

MODX内容管理围绕三个核心概念展开：资源（页面）、模板（布局）和区块（可复用HTML）。在添加内容之前，理解这些概念至关重要。

8.1 创建模板

元素 → 模板 → 新建模板
为模板命名，例如"Main Layout"
编写页面HTML布局，并插入动态内容占位符
保存模板

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <title>[[*pagetitle]] | [[++site_name]]</title>
  <meta charset="UTF-8">
</head>
<body>
  [[$header]]   <!-- 区块：页眉 -->
  <main>[[*content]]</main>
  [[$footer]]   <!-- 区块：页脚 -->
</body>
</html>

8.2 创建资源（内容页面）

资源 → 新建资源
输入资源标题，选择您的模板
设置别名（URL路径），例如 about
在内容选项卡中编写内容
保存——资源将立即在其URL上可访问

8.3 创建区块（可复用HTML片段）

元素 → 区块 → 新建区块
为其命名，例如"header"、"footer"、"sidebar"
编写该部分的HTML代码
在模板中使用 [[$chunkName]] 调用它

9. MODX与SEO：配置友好URL

MODX通过Apache的mod_rewrite支持SEO友好URL，需要同时配置 .htaccess 文件和系统设置。

9.1 激活.htaccess

MODX附带一个名为 ht.access 的文件（尚未激活）。在文件管理器中将其重命名为 .htaccess，并确认主机上已启用mod_rewrite。

# MODX .htaccess 关键部分
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?q=$1 [L,QSA]

9.2 在系统设置中启用友好URL

系统 → 系统设置 → 搜索 friendly_urls → 设为是
搜索 friendly_alias_urls → 设为是
搜索 use_alias_path → 设为是（启用/父级/子级/层级URL）

9.3 MODX中的SEO最佳实践

通过模板变量（TV）管理每个资源的meta描述和自定义标题
使用SEO Pro或tagManager扩展进行高级Meta标签管理
设置包含目标关键词的有意义的资源别名
使用GoogleSiteMap扩展生成XML站点地图
使用Minify扩展压缩JS和CSS，加快页面加载速度

💡 MODX的SEO优势：页面不会因不必要的插件而变得臃肿，天然快速加载。完全的URL控制意味着您可以从一开始就构建含有关键词的URL结构。

10. 总结与常见问题

MODX CMS是希望完全控制网站架构、不受WordPress固定内容模型约束的开发者的绝佳选择。在DirectAdmin主机上安装大约需要20-30分钟，不需要自动安装器。

关键步骤回顾：

从modx.com下载MODX并上传至public_html
通过DirectAdmin的MySQL管理创建数据库
在/setup/运行Web安装程序并输入数据库凭据
安装完成后立即删除setup/文件夹
配置友好URL并开始构建模板、资源和区块

常见问题解答

MODX CMS是什么？

MODX是一款开源PHP CMS/CMF，允许开发者完全自定义URL结构、模板和内容架构，而不受WordPress固定文章/页面模型的限制。

MODX需要什么PHP版本？

MODX Revolution 3.x至少需要PHP 7.4。推荐PHP 8.1或8.2以获得最佳性能和安全性。必需的扩展包括pdo_mysql、curl、gd和zlib。

MODX可以通过Softaculous安装吗？

不可以。MODX必须从modx.com手动下载，通过文件管理器上传，并通过/setup/的Web安装程序进行安装。整个过程约需15-20分钟。

AsiaGB主机支持MODX吗？

支持。AsiaGB主机提供PHP 8.x、InnoDB MySQL、Apache mod_rewrite和DirectAdmin控制面板——MODX所需的一切都已就位。SSD存储，99%正常运行时间保证，套餐起价500泰铢/月。

MODX支持中文网站吗？

支持。将MySQL排序规则设置为utf8mb4_unicode_ci，PHP默认字符集设置为UTF-8，即可完美支持中文及所有Unicode字符。还可通过Context系统构建完整的中文多语言网站。

MODX有免费扩展（Extra）可用吗？

有很多。MODX包管理器提供modx.com/extras上的众多免费扩展，包括pdoTools、Wayfinder、FormIt、getPage和GoogleSiteMap，涵盖导航、表单、分页和站点地图等功能。

每月两次自动备份是什么？

AsiaGB主机提供每月两次自动备份（每月1日和15日），为您的MODX网站数据提供基础保护。建议同时配合Softaculous备份或手动备份功能，以实现更频繁的数据保护。

准备好在AsiaGB主机上安装MODX了吗？

SSD主机 · PHP 8.x · DirectAdmin · 99%正常运行时间 · 起价500泰铢/月

查看主机套餐

在DirectAdmin主机上安装MODX CMS比WordPress更灵活的建站方案

1. MODX CMS是什么？

MODX核心架构

2. MODX与WordPress对比

3. 安装前的系统要求

在DirectAdmin中验证PHP扩展

4. 下载并上传MODX文件

4.1 下载MODX

4.2 通过DirectAdmin文件管理器上传

5. 在DirectAdmin中创建MySQL数据库

5.1 创建新数据库

5.2 设置字符排序规则（推荐）

6. 运行Web安装程序

访问MODX管理后台

7. 安装后配置

7.1 更改管理器路径（推荐）

7.2 网站核心设置

7.3 配置电子邮件（SMTP）

8. 创建资源、模板和区块

8.1 创建模板

8.2 创建资源（内容页面）

8.3 创建区块（可复用HTML片段）

9. MODX与SEO：配置友好URL

9.1 激活.htaccess

9.2 在系统设置中启用友好URL

9.3 MODX中的SEO最佳实践

10. 总结与常见问题

常见问题解答

MODX CMS是什么？

MODX需要什么PHP版本？

MODX可以通过Softaculous安装吗？

AsiaGB主机支持MODX吗？

MODX支持中文网站吗？

MODX有免费扩展（Extra）可用吗？

每月两次自动备份是什么？

准备好在AsiaGB主机上安装MODX了吗？

相关文章

Ghost CMS是什么？

在主机上安装Joomla

修复500、403、404错误

在DirectAdmin中更改PHP版本

在DirectAdmin主机上安装MODX CMS
比WordPress更灵活的建站方案