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

[oksgo]

一、XenForo 安装教程​

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/。

2.2. 设置文件权限

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

2.3. 创建 MySQL 数据库

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

3. 开始安装 XenForo​

3.1. 访问安装向导

• 打开浏览器，访问 XenForo 的安装 URL。例如：
  • 如果你将文件上传到根目录：http://yourdomain.com/ (你的网站根目录)
  • 如果是子目录：http://yourdomain.com/forum/

3.2. 输入数据库信息

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

3.3. 设置管理员账号

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

3.4. 完成安装

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

3.5. 登录管理后台

• 安装完成后，你可以通过 http://yourdomain.com/admin.php 或 http://yourdomain.com/forum/admin.php 访问后台管理面板。(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. 进入升级页面

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

3.2. 执行升级

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

3.3. 完成后检查

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

三、常见问题与解决​

1. 安装失败或白屏

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

2. 无法连接数据库

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

3. 升级后出现问题

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

4. 如何还原备份

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

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

 

Tutorial/教程  XenForo 文件哈希值hashes修正方法

Version  XenForo 2.3.3 及附加组件发布