环境要求

组件最低要求推荐
PHP7.37.4 / 8.0
MySQL5.65.7 / 8.0
Web 服务器Nginx(推荐)或 Apache
PHP 扩展mysqli(必须)、fileinfombstringopenssl
宝塔面板已安装并正常运行

安装步骤

1

安装运行环境

登录宝塔面板,进入 软件商店,确保已安装以下软件:

  • Nginx(或 Apache)
  • MySQL 5.7 或 8.0
  • PHP 7.4 或 8.0

安装完成后,点击 PHP 右侧的 设置安装扩展,确认安装了 mysqlifileinfombstringopenssl 扩展。

提示:如果要用邮件验证功能,还需安装 sockets 扩展(SMTP 发信需要)。
2

创建网站

进入宝塔面板 网站添加站点

  • 域名:填写你的域名(如 forum.example.com),如果暂时没有域名可以填 IP 地址
  • FTP:可以不创建
  • 数据库:选择 MySQL,字符集选择 utf8mb4
  • PHP 版本:选择已安装的 PHP 7.4 或 8.0

创建完成后,宝塔会自动生成数据库名称、用户名和密码,请记下这些信息。

3

上传文件

进入宝塔面板 文件,找到网站根目录(默认路径为 /www/wwwroot/你的域名/)。

  1. 删除根目录下默认的 index.html404.html 等文件
  2. 点击「上传」,选择 Lume 安装包(.zip)上传
  3. 上传完成后,右键压缩包 → 解压
  4. 解压后,确保所有 PHP 文件都在网站根目录下(不在子文件夹中)
提示:如果解压后文件在子目录中,可以选中全部文件,使用「剪切」→「粘贴」移动到根目录,然后删除空的子目录。
4

配置数据库连接

在网站根目录找到 config.php 文件,右键 → 编辑,修改以下内容:

<?php
define('DB_HOST', 'localhost');        // 通常不需要改
define('DB_USER', '你的数据库用户名');   // 宝塔自动生成的数据库用户名
define('DB_PASS', '你的数据库密码');     // 宝塔自动生成的数据库密码
define('DB_NAME', '你的数据库名称');     // 宝塔自动生成的数据库名称
define('DB_CHARSET', 'utf8mb4');       // 保持默认

define('SITE_NAME', 'Lume');           // 可以改成你的站点名称
define('SITE_DESC', '简单干净,一目了然的轻量论坛');
define('POST_INTERVAL', 10);           // 发帖间隔(秒),10 表示 10 秒内只能发一次
?>
如何找到数据库信息? 在宝塔面板中进入 数据库,找到创建网站时自动生成的数据库,点击「管理」即可查看用户名、密码和数据库名称。
5

设置网站运行目录

进入宝塔面板 网站,找到你的站点,点击 设置网站目录

  • 运行目录:保持为 /(根目录)
  • 防跨站攻击:建议开启(默认)

进入 PHP 版本,确认已选择正确的 PHP 版本。

6

运行安装程序

在浏览器中访问你的网站,加上 /install.php

https://你的域名/install.php

页面会自动创建所有数据库表。如果显示安装成功,说明数据库配置正确。

重要:安装完成后,务必删除 install.php 文件,防止被他人恶意利用重置数据库。
7

登录后台

访问网站首页,使用默认管理员账号登录:

  • 用户名admin
  • 密码admin123

登录后请尽快修改密码:进入 资料 页面,输入新密码后保存。

8

更新旧版(可选)

如果你之前安装过旧版本,上传覆盖文件后,不要再次运行 install.php

改为访问 /upgrade.php,它会自动创建新增的数据库表(如附件表、设置表、关注表等),不会覆盖已有数据。

升级成功后也建议删除 upgrade.php

宝塔伪静态设置(可选)

Lume 默认使用 PHP 动态 URL,无需伪静态。如需开启伪静态美化 URL:

进入宝塔面板 网站 → 站点右侧 伪静态 → 填入以下规则:

if (!-d $request_filename) {
    rewrite ^/(.*)$ /index.php/$1 last;
}

保存后即可生效。

开启 HTTPS(推荐)

宝塔面板支持一键申请免费 SSL 证书:

  1. 进入 网站 → 站点右侧 设置SSL
  2. 选择 Let's Encrypt → 勾选域名 → 点击「申请」
  3. 申请成功后,勾选「强制 HTTPS」
注意:申请 SSL 证书需要域名已正确解析到服务器 IP,且网站端口 80 可以正常访问。

常见问题

问题解决方法
数据库连接失败 检查 config.php 中的数据库用户名、密码、数据库名称是否与宝塔「数据库」中一致
安装后页面空白 检查 PHP 是否安装了 mysqli 扩展。在宝塔中进入 PHP 设置 → 安装扩展,开启 mysqli
上传附件失败 确保 uploads/ 目录有写入权限(755)。宝塔默认已设置正确权限,如仍报错请在文件管理器中右键目录 → 权限 → 755
邮件验证码无法发送 在后台「邮箱验证」区块配置 SMTP 信息,并在 PHP 设置中确认 sockets 扩展已安装
忘记管理员密码 在宝塔中进入数据库 → 管理,找到 qf_users 表,编辑 admin 用户的 password 字段。可先注册一个新用户,复制其 password 哈希值到 admin 行
502 Bad Gateway 检查 PHP 版本是否与网站设置一致,尝试重启 PHP 服务
上传文件大小受限 在 PHP 设置中修改 upload_max_filesizepost_max_size(默认 50M,可根据需要调大)

快速参考

项目说明
默认管理员admin / admin123
后台入口/admin.php
站点设置/admin_settings.php
安装程序/install.php(安装后删除)
升级程序/upgrade.php(升级后删除)
配置文件/config.php
网站根目录/www/wwwroot/你的域名/
附件目录/uploads/