适用于已安装宝塔面板的 Linux 服务器
| 组件 | 最低要求 | 推荐 |
|---|---|---|
| PHP | 7.3 | 7.4 / 8.0 |
| MySQL | 5.6 | 5.7 / 8.0 |
| Web 服务器 | Nginx(推荐)或 Apache | |
| PHP 扩展 | mysqli(必须)、fileinfo、mbstring、openssl | |
| 宝塔面板 | 已安装并正常运行 | |
登录宝塔面板,进入 软件商店,确保已安装以下软件:
安装完成后,点击 PHP 右侧的 设置 → 安装扩展,确认安装了 mysqli、fileinfo、mbstring、openssl 扩展。
sockets 扩展(SMTP 发信需要)。
进入宝塔面板 网站 → 添加站点。
utf8mb4创建完成后,宝塔会自动生成数据库名称、用户名和密码,请记下这些信息。
进入宝塔面板 文件,找到网站根目录(默认路径为 /www/wwwroot/你的域名/)。
index.html 和 404.html 等文件在网站根目录找到 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 秒内只能发一次
?>
进入宝塔面板 网站,找到你的站点,点击 设置 → 网站目录:
/(根目录)进入 PHP 版本,确认已选择正确的 PHP 版本。
在浏览器中访问你的网站,加上 /install.php:
https://你的域名/install.php
页面会自动创建所有数据库表。如果显示安装成功,说明数据库配置正确。
访问网站首页,使用默认管理员账号登录:
adminadmin123登录后请尽快修改密码:进入 资料 页面,输入新密码后保存。
如果你之前安装过旧版本,上传覆盖文件后,不要再次运行 install.php。
改为访问 /upgrade.php,它会自动创建新增的数据库表(如附件表、设置表、关注表等),不会覆盖已有数据。
upgrade.php。
Lume 默认使用 PHP 动态 URL,无需伪静态。如需开启伪静态美化 URL:
进入宝塔面板 网站 → 站点右侧 伪静态 → 填入以下规则:
if (!-d $request_filename) {
rewrite ^/(.*)$ /index.php/$1 last;
}
保存后即可生效。
宝塔面板支持一键申请免费 SSL 证书:
| 问题 | 解决方法 |
|---|---|
| 数据库连接失败 | 检查 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_filesize 和 post_max_size(默认 50M,可根据需要调大) |
| 项目 | 说明 |
|---|---|
| 默认管理员 | admin / admin123 |
| 后台入口 | /admin.php |
| 站点设置 | /admin_settings.php |
| 安装程序 | /install.php(安装后删除) |
| 升级程序 | /upgrade.php(升级后删除) |
| 配置文件 | /config.php |
| 网站根目录 | /www/wwwroot/你的域名/ |
| 附件目录 | /uploads/ |