Tutorial|教程 宝塔面板安装 XenForo 2.x 入门级完整教程

[oksgo]

🖥️ 宝塔面板安装 XenForo 2.x 入门级完整教程​

适用版本：XenForo 2.2 / 2.3 | 环境：宝塔面板（BT Panel）

---

📋 一、准备工作​

服务器推荐配置：

• 系统：Ubuntu 22.04 / Debian 12（推荐）或 CentOS 7/8
• 内存：≥ 1 GB RAM
• 硬盘：≥ 10 GB（含附件空间）
• 已绑定域名并解析到服务器 IP

软件包需要提前准备：

1. 从 本站 下载 xenforo_2.x.x_full.zip
2. 宝塔面板已安装完毕并可以登录

---

🔧 二、宝塔面板环境配置​

第一步：安装运行环境​

登录宝塔面板，点击左侧 软件商店，搜索并安装以下组件：

• Nginx 1.22+（推荐，不要安装 Apache）
• MySQL 8.0（推荐）或 5.7
• PHP 8.2（XF 2.3 要求 PHP 8.0+）

隐藏: 📸 安装界面说明

宝塔 → 软件商店 → 运行环境 → 分别点击 Nginx / MySQL / PHP 右侧的"安装"按钮，等待安装完成即可。

第二步：安装必要的 PHP 扩展​

宝塔面板 → 软件商店 → 找到 PHP 8.2 → 点击设置 → 进入安装扩展选项卡

确保以下扩展已安装（打勾表示已安装）：

• fileinfo ✅
• mbstring ✅
• curl ✅
• gd ✅（图片处理，必须）
• imagick ✅（推荐安装，头像/图片处理更好）
• xml ✅
• zip ✅
• intl ✅
• opcache ✅（性能优化，强烈推荐）

第三步：调整 PHP 配置​

宝塔 → 软件商店 → PHP 8.2 → 设置 → 配置修改，找到并修改以下参数：

memory_limit = 256M
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 60

修改后点击保存。

---

🌐 三、创建网站​

第四步：添加站点​

宝塔面板 → 网站 → 添加站点

填写信息如下：

• 域名：填写你的域名，如 forum.example.com
• 根目录：默认即可（宝塔会自动创建，如 /www/wwwroot/forum.example.com）
• PHP 版本：选择 8.2
• 数据库：勾选"创建数据库"
  • 数据库名：xenforo
  • 用户名：xenforo
  • 密码：点击"随机"生成强密码，务必记录下来

点击提交，网站创建完成。

第五步：配置 SSL 证书（强烈推荐）​

宝塔 → 网站 → 找到你的站点 → 点击设置 → SSL 选项卡

选择 Let's Encrypt，勾选你的域名，点击申请，等待几秒即可。

申请成功后，开启强制 HTTPS 开关。

---

📁 四、上传 XenForo 文件​

第六步：上传安装包​

宝塔面板 → 文件 → 进入网站根目录（如 /www/wwwroot/forum.example.com）

1. 点击右上角上传，将 xenforo_2.x.x_full.zip 上传到该目录
2. 上传完成后，点击压缩包右侧的解压
3. 解压后你会看到一个 upload 文件夹
4. 进入 upload 文件夹，全选所有文件 → 点击剪切
5. 返回上一级（网站根目录），点击粘贴
6. 删除空的 upload 文件夹和压缩包

完成后根目录下应直接可以看到 index.php、install/、src/ 等文件。

第七步：设置目录权限​

宝塔面板 → 文件 → 在根目录找到 data 文件夹 → 右键 → 权限 → 设置为 755，勾选递归子目录

同样操作 internal_data 文件夹，设置权限为 755。

如果后续安装提示目录不可写，可将这两个目录权限改为 775。

---

⚙️ 五、配置 Nginx 伪静态​

宝塔 → 网站 → 你的站点 → 设置 → 伪静态 选项卡

清空内容，粘贴以下规则，点击保存：

location / {
    try_files $uri $uri/ /index.php?$uri&$args;
}

location ~ /internal_data/ {
    deny all;
    return 403;
}

location ~ /library/ {
    deny all;
    return 403;
}

---

🚀 六、运行 Web 安装程序​

打开浏览器，访问：

https://你的域名/install/

安装步骤​

1. 欢迎页面：点击 Proceed with Installation
2. 许可协议：勾选同意，点击 Continue
3. 环境检测：确认所有项目均为绿色 ✅，有红色请参考下方常见问题
4. 数据库配置：
   • MySQL Server：localhost
   • MySQL Port：3306
   • Username：第四步创建的数据库用户名
   • Password：第四步创建的数据库密码
   • Database：xenforo
   • Table Prefix：xf_（默认即可）
5. 基本配置：
   • Board Title：论坛名称（中文可以）
   • Board URL：https://你的域名（末尾不加斜杠）
6. 创建管理员账号：填写用户名、邮箱、密码（请使用强密码）
7. 开始安装：等待数据库初始化，约 30-60 秒
8. 安装完成：看到成功提示，点击进入后台或论坛首页 🎉

---

✅ 七、安装完成后必做事项​

1. 删除安装目录（重要！）​

宝塔 → 文件 → 网站根目录 → 找到 install 文件夹 → 右键删除

⚠️ 必须删除！否则任何人都可以重新安装覆盖你的论坛。

2. 设置定时任务（Cron）​

宝塔面板 → 计划任务 → 添加任务：

• 任务类型：Shell 脚本
• 任务名称：XenForo Cron
• 执行周期：每 1 分钟
• 脚本内容：

/www/server/php/82/bin/php /www/wwwroot/你的域名/cmd.php xf:run-jobs > /dev/null 2>&1

PHP 路径根据宝塔实际安装路径确认，通常 PHP 8.2 的路径是 /www/server/php/82/bin/php

3. 后台基本设置​

访问后台：https://你的域名/admin.php

• 邮件设置：后台 → Setup → Email → 配置 SMTP（推荐，避免邮件进垃圾箱）
• 开启 Friendly URL：后台 → Setup → Basic Board Information → Use Full Friendly URLs → 打开

---

❓ 常见问题​

隐藏: 环境检测有红色项目怎么办？

GD 或 Imagick 未安装：
宝塔 → 软件商店 → PHP 8.2 → 设置 → 安装扩展 → 安装 gd 和 imagick

data / internal_data 不可写：
宝塔 → 文件 → 右键对应目录 → 权限 → 改为 775

隐藏: 安装完成后页面样式错乱（全是文字）？

1. 确认 Nginx 伪静态规则已保存
2. 登录宝塔面板 → 网站 → 找到你的站点 → 设置 → 伪静态 → 确认规则存在
3. 后台 → 开启 Friendly URL

隐藏: 上传附件失败？

检查 PHP 配置中的 upload_max_filesize 和 post_max_size 是否足够大（建议 50M+）。

宝塔 → PHP 8.2 → 设置 → 配置修改 → 搜索对应参数修改保存。

隐藏: 数据库连接失败？

• 检查用户名/密码是否填写正确
• 宝塔 → 数据库 → 确认数据库状态正常
• 数据库用户的权限是否是"所有权限"

---

本教程适用于宝塔面板环境下的标准 XenForo 安装，如有问题欢迎回帖。

 

Tutorial|教程  积分使用完全指南 —— 如何赚取积分与使用积分

Tutorial|教程  XenForo 主题（Style）完整安装教程