Tutorial/教程 XenForo 安装/升级详细教程

[oksgo]

一、XenForo 安装教程​

要安装 XenForo，您需要以下内容：

1. 您的 XenForo 安装文件
2. FTP 客户端（例如FileZilla或WinSCP）
3. 您的服务器的 FTP 登录详细信息
4. 服务器上的一个空的 MySQL 数据库以及访问它的详细信息

1. 环境准备​

1.1. 检查服务器配置确保你的服务器满足 XenForo 的系统要求：

• 操作系统：Linux（推荐），Windows 或 Mac OS 也可以使用。
• Web 服务器：Apache 2.4 或 Nginx 1.18 及以上版本。
• PHP：支持 PHP 7.4 至 PHP 8.2（推荐 PHP 8.0 或 8.1）。
  • 扩展要求：PDO、MySQLi、mbstring、gd、cURL、SimpleXML、json、openssl、dom、gmp、bcma 等。
• 数据库：MySQL 5.5 及以上版本或 MariaDB 10.2 及以上版本（推荐 MySQL 5.7+ 或 MariaDB 10.3+）。

1.2. 获取 XenForo

• 注册并登录 OKSGO 网站。
• 在资源区域下载最新的 XenForo 安装包。

2. 安装前准备​

2.1. 上传 XenForo 文件

• 将下载的 XenForo 压缩包文件解压缩。
• 使用 FTP 客户端（如 FileZilla）或通过 SFTP，将解压后的文件上传到你的服务器上的目标目录。例如：
  • 根目录安装：上传文件到 public_html/ 或 www/ 目录。
  • 子目录安装：上传到 public_html/forum/ 或 www/forum/

上传​

在您的计算机上，解压您在步骤 1 中下载的文件。在其中，您将看到一个upload目录。您将把此目录的内容上传到您的服务器（而不是目录本身）。

现在使用您的 FTP 客户端连接到您的服务器并创建您想要安装 XenForo 的目录。例如，如果您想通过 访问 XenForo example.com/community/，您将community在您的 webroot（例如您的public_html目录）内创建一个目录。您需要记下这对应的 URL 以用于下一步。这将被称为您的“XenForo 根 URL”。

笔记

如果您想在域的根目录下安装 XenForo，通常不需要创建目录。但是，必须将 XenForo 安装到尚未用于显示页面的目录中。
使用 FTP 客户端将之前解压的 zip 中包含的目录内容上传upload到您刚刚在服务器上创建的目录中。确保所有文件和子目录都已上传。如果操作正确，上传后，您应该会在您在服务器上创建的目录中直接看到诸如admin.php和 css.php的文件。

上传可能需要一些时间。请在上传完成前不要继续。保持 FTP 客户端打开，因为下一步可能需要它。

3. 安装​

现在您几乎可以开始安装 XenForo 了。

将浏览器指向install XenForo 根 URL 下的目录。例如，如果您的 XenForo 根 URL 是www.example.com/community/，则应将浏览器指向www.example.com/community/install/。如果您有正确的 URL，您应该会看到 XenForo 安装程序。

根据服务器配置，您可能会收到有关某些目录不可写入的错误。如果是这样，请按照“设置目录权限”步骤操作。如果您收到任何其他错误消息，则表示您的服务器不符合 XenForo 的要求，您的主机将需要更改其 PHP 配置。

设置目录权限

根据您的 PHP 配置，您可能需要手动使某些目录可写。如果需要，启动安装时将显示一条消息。

如果您收到此消息，请打开 FTP 客户端并导航到 XenForo 根目录（您之前创建的目录）。您应该看到data和internal_data目录。您需要更改这两个目录的权限。

在 Linux 中，这些应该是“chmod 0777”。通常，您可以通过 FTP 客户端执行此操作，方法是确保目录对用户、组和世界具有读取、写入和执行权限。在 Windows/IIS 中，您需要向该IUSR_帐户授予“完全控制”权限。

完成后，刷新安装程序。如果更改正确，有关目录不可写的错误消息应该会消失。
如果没有显示其他错误，您可以开始 XenForo 安装过程。在早期步骤中，您将被要求提供有关数据库服务器的详细信息。如果您不知道此处要使用什么值，则需要联系您的主机以获取正确的值。

一旦数据库配置通过验证，如果可能的话，它将自动写入您的服务器。如果这不可能，您将需要下载生成的配置文件并手动上传。

上传生成的配置文件

如果无法自动写入配置文件，您将看到一个按钮，用于将文件下载到您的计算机。单击此按钮。

打开您的 FTP 客户端并导航到您的 XenForo 根目录。在此目录中，您应该会看到一个名为的子目录src。打开该目录并上传config.php您刚刚下载的文件。您现在可以继续安装。
要完成安装，请按照屏幕上的说明进行操作，直到完成。XenForo 现已安装，您可以开始配置它。

2.2. 设置文件权限

• 确保以下目录和文件具有写入权限，这样 XenForo 才能正常运行：
  • data/
  • internal_data/
  • src/config.php
• 方法：你可以使用 FTP 客户端右键点击这些目录/文件，选择“文件权限”（CHMOD），设置为 0777 或 0755。

2.3. 创建 MySQL 数据库

• 登录到你的数据库管理工具（如 phpMyAdmin 或命令行）。
• 创建一个新的 MySQL 数据库，并为其分配一个用户。记录数据库名称、用户名和密码，这是接下来安装过程中需要用到的信息。

3. 开始安装 XenForo​

3.2. 输入数据库信息

• 安装向导会要求你输入数据库的详细信息：
  • 数据库名称：你刚刚创建的数据库名称。
  • 数据库用户名：数据库用户的用户名。
  • 数据库密码：数据库用户的密码。
• 输入完成后，点击“继续”按钮。

3.3. 设置管理员账号

• 安装过程中，系统会提示你创建一个管理员账号。输入以下信息：
  • 用户名：管理员的用户名。
  • 密码：管理员的密码。
  • 邮箱地址：用于接收系统通知的邮箱。
• 确认信息无误后，点击“继续”。

3.4. 完成安装

• 系统将会自动完成安装过程，安装成功后会提示你登录后台管理面板。

3.5. 登录管理后台

• 安装完成后，你可以通过 yourdomain.com 或 yourdomain.com 访问后台管理面板。(yourdomain.com 为你的网站域名)

3.6. 基本配置

• 登录后台后，你可以在“选项”中配置站点基本信息，如站点名称、时区、语言等。

二、XenForo 升级教程​

1. 升级前准备​

1.1. 备份数据

• 备份数据库：使用 phpMyAdmin 导出你的 XenForo 数据库。选择所有表，并导出为 .sql 文件。
• 备份文件：通过 FTP 或其他工具下载整个 XenForo 目录，保存一份完整的文件备份。

1.2. 检查兼容性

• 升级前，确认所有插件、模板和定制化代码与新版本兼容。访问插件开发者或主题作者的官方网站，查看是否有新版本。

2. 下载和上传升级文件​

2.1. 下载升级包

• 登录网站，下载最新版本的升级包。

2.2. 上传升级文件

• 解压缩升级包。
• 使用 FTP 或 SFTP，将解压后的文件上传到 XenForo 安装目录中，覆盖现有文件。
  • 注意：避免覆盖 src/config.php 文件，以免丢失数据库连接信息。

3. 运行升级脚本​

3.1. 进入升级页面

• 打开浏览器，访问 yourdomain.com 或 yourdomain.com 进入升级页面。

3.2. 执行升级

• 点击“Begin Upgrade”按钮，系统将自动执行升级过程。
• 升级完成后，系统会提示你已成功升级。

3.3. 完成后检查

• 升级完成后，登录到后台管理面板，检查是否有报错或插件不兼容的情况。
• 清理缓存，确保系统正常运行。

三、常见问题与解决​

1. 安装失败或白屏

• 原因：可能是文件上传不完整或权限设置问题。
• 解决：重新上传文件，确保权限设置正确。

2. 无法连接数据库

• 原因：数据库信息填写错误。
• 解决：检查 src/config.php 文件，确保数据库名称、用户名和密码正确无误。

3. 升级后出现问题

• 原因：插件或主题不兼容。
• 解决：禁用不兼容的插件，联系插件开发者获取更新。

4. 如何还原备份

• 还原数据库：通过 phpMyAdmin 导入之前备份的 .sql 文件。
• 还原文件：上传备份的文件，覆盖现有文件。

通过这个详细的步骤，你应该能够顺利完成 XenForo 的安装和升级。如果在操作过程中遇到任何问题，建议访问 XenForo 官方社区，寻找解决方案或寻求帮助。

 

Tutorial/教程  滚动合作伙伴小部件