中文

网站托管

在 Plesk 上安装 Joomla

在您的 Plesk 托管空间上安装 Joomla:PHP 和数据库要求、上传官方安装包、安装向导、友好 URL 以及常见错误的解决方法。

阅读约 6 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何使用官方安装包在您的 Plesk 托管空间上安装 Joomla,然后确认网站及其管理后台运行正常。

前提条件

  • 能够访问您的 Plesk 面板(参见连接到 Plesk 界面)。
  • 一个已绑定到您的托管空间并指向该空间的域名。
  • 一个空的 httpdocs 目录;如果其中已有网站,请先备份。

本指南使用 httpdocs,这是主域名通常使用的目录。附加域名的目录可能不同:请在 主机与 DNS > 主机 中查看 文档根目录。

以下是 Joomla 6 的官方要求,这是撰写本指南时的当前版本分支。如果您要安装更高版本,请在 Joomla 手册中进行核实。

项目 支持的最低版本 推荐版本
PHP 8.3.0 8.4
MySQL 8.0.13 8.4
MariaDB 10.6(绝对最低为 10.4) 12.0

需要 PHP 模块 json、simplexml、dom、zlib、gd 以及 mysqlnd 或 pdo_mysql,并建议启用 mbstring。请预留至少 256 MB 的内存限制。

步骤 1:配置 PHP

  1. 进入 网站与域名,找到您的域名。

  2. 打开 PHP(或 PHP 设置,取决于您的 Plesk 版本)。

  3. 选择 PHP 8.3 或更高版本。

  4. 至少应用以下值:

    设置 值
    memory_limit 256M
    upload_max_filesize 64M
    post_max_size 64M
    max_execution_time 30
  5. 保存。

步骤 2:创建数据库

请按照创建数据库指南创建数据库和专用用户。记下数据库名称、用户名、密码,以及该数据库连接信息中显示的主机名(通常为 localhost)。

您可以从 数据库 页面打开 phpMyAdmin,查看数据库服务器的版本。

步骤 3:下载 Joomla

在官方下载页面获取 .zip 格式的 Full Package。撰写本指南时,最新版本为 6.2.0。

步骤 4:上传并提取文件

  1. 在 Plesk 中打开 文件,然后进入 httpdocs 目录。
  2. 如果其中有默认页面 index.html,请将其删除。否则,显示的将是该页面,而不是安装向导。
  3. 上传 Joomla 压缩包。
  4. 勾选该压缩包,然后点击 提取文件。
  5. 确认 index.php 和 installation 目录直接位于 httpdocs 中,而不是在某个子目录中。
  6. 删除压缩包。

如果您更愿意使用 FTP 客户端(参见更改 FTP 密码),请先在您的计算机上解压压缩包,然后上传其中的内容。

步骤 5:启动安装向导

在浏览器中打开 https://您的域名.com/。如果您的域名还没有有效的 SSL 证书,请暂时使用 http://。

语言和网站名称

选择安装语言,输入网站名称,然后点击 设置登录信息。

超级用户账户

请填写:

  • 您的真实姓名;
  • 用户名,最好不要使用 admin;
  • 至少 12 个字符的密码;
  • 您能够访问的电子邮件地址,可用于找回账户。

然后点击 设置数据库连接。

数据库

字段 值
数据库类型 MySQLi
主机名 localhost,或 Plesk 显示的值
用户名 步骤 2 中创建的用户
密码 该用户的密码,而不是超级用户的密码
数据库名称 步骤 2 中创建的数据库
表前缀 保留生成的值,包括末尾的 _
连接加密 保留默认值

点击 安装 并等待完成。

完成安装

恭喜! 页面表示安装已完成。您可以在此添加语言,然后通过 完成并打开前台 打开网站,或通过 完成并打开后台 打开管理后台。

Joomla 会自行删除 installation 目录。不过仍请检查 httpdocs:如果该目录仍然存在,请将其删除。

步骤 6:启用友好 URL

此步骤为可选操作,它会将 index.php 从页面地址中去除。

  1. 在 文件 中打开 httpdocs,将 htaccess.txt 重命名为 .htaccess。
  2. 登录管理后台,然后打开 系统(System)> 全局配置(Global Configuration)。
  3. 在 网站(Site)选项卡中,启用 URL 重写(Use URL Rewriting)。
  4. 保存,然后打开网站的几个页面进行查看。

检查结果

  1. https://您的域名.com/ 显示您的网站首页。
  2. https://您的域名.com/administrator/ 显示登录页面,并且您的超级用户凭据可以正常登录。
  3. httpdocs 中已不存在 installation 目录。
  4. 仪表板未提示有待安装的安全更新。

故障排除

显示 Plesk 默认页面

index.html 文件的优先级高于 index.php。请将其从 httpdocs 中删除或重命名,然后绕过浏览器缓存重新加载页面。

抱歉,PHP 版本不支持。

该域名的 PHP 版本过旧。请在 PHP 中选择 PHP 8.3 或更高版本,然后重新加载页面。

需要 MariaDB ... 或更高版本才能继续安装

数据库服务器不符合此 Joomla 版本的要求。消息中会显示所需版本和当前版本。请通过您的客户区联系技术支持,了解可行的解决方案。

提供的数据库信息不正确 和/或 未填写。

请检查主机名、用户名、密码和数据库名称。请从 Plesk 复制数据库名称,因为它可能带有前缀。

Joomla 要求删除一个文件以确认您是网站所有者

当数据库服务器不在本地时,会出现此验证。如果您的数据库确实位于同一托管空间,请使用 localhost。否则,请从 installation 目录中删除消息里提到的文件,然后重新执行该步骤。

无法删除 "..." 目录。请手动删除该文件夹。

请通过 文件 或 FTP 删除 installation 目录。如果该目录仍然存在,Joomla 可能会将您重新引导到安装向导。

除首页外的所有页面都出现 404 错误

已启用 URL 重写,但 .htaccess 文件不存在或不受支持。请检查文件的确切名称,包括开头的点号。如果问题仍然存在,请在全局配置中停用该选项,并联系技术支持。

创建 .htaccess 后出现 500 错误

请暂时重命名 .htaccess,以确认问题是否由它引起。Joomla 指南提到,Options +FollowSymlinks 这一行在某些服务器上可能导致问题:请尝试在该行开头添加 # 将其注释掉。

空白页面或一般性错误

请查看该域名的 日志 和 administrator/logs 目录。要获取更多详细信息,请在 configuration.php 中暂时将 $error_reporting 设为 'maximum',诊断完成后再改回 'default'。

扩展或文件上传失败

请在 PHP 中增大 upload_max_filesize 和 post_max_size。后者至少应等于前者。