适用于已安装 1Panel 面板的 Linux 服务器
| 组件 | 最低要求 | 推荐 |
|---|---|---|
| PHP | 7.3 | 7.4 / 8.0 |
| MySQL | 5.6 | 5.7 / 8.0 |
| PHP 扩展 | mysqli(必须) | |
| 1Panel | 已安装并正常运行 | |
登录 1Panel 面板,进入 网站 → 创建网站。
utf8mb4创建完成后,1Panel 会自动生成数据库名称和密码,请记下这些信息。
进入 1Panel 网站 列表,找到刚创建的网站,点击进入 网站目录。
删除默认的 index.php 文件,然后上传 Lume 压缩包并解压:
在网站目录中找到 config.php 文件,点击编辑,修改以下内容:
<?php
define('DB_HOST', 'localhost'); // 通常不需要改
define('DB_USER', '你的数据库用户名'); // 1Panel 自动生成的数据库用户名
define('DB_PASS', '你的数据库密码'); // 1Panel 自动生成的数据库密码
define('DB_NAME', '你的数据库名称'); // 1Panel 自动生成的数据库名称
define('DB_CHARSET', 'utf8mb4'); // 保持默认
define('SITE_NAME', 'Lume'); // 可以改成你的站点名称
define('SITE_DESC', '简单干净,一目了然的轻量论坛');
define('POST_INTERVAL', 10); // 发帖间隔(秒),10 表示 10 秒内只能发一次
?>
在浏览器中访问你的网站,加上 /install.php:
https://你的域名/install.php
页面会自动创建数据库表。如果显示安装成功,说明数据库配置正确。
访问网站首页,使用默认管理员账号登录:
adminadmin123登录后请尽快修改密码:进入 资料 页面,输入新密码后保存。
如果你之前安装过旧版本,上传覆盖文件后,不要再次运行 install.php。
改为访问 /upgrade.php,它会自动创建新增的数据库表(如附件表、设置表、关注表等),不会覆盖已有数据。
upgrade.php。
Lume 默认使用 PHP 动态 URL,无需伪静态。如需开启伪静态美化 URL,可在 1Panel 中设置:
进入网站 → 伪静态 → 选择 thinkphp 模板,或填入以下规则:
if (!-d $request_filename) {
rewrite ^/(.*)$ /index.php/$1 last;
}
| 问题 | 解决方法 |
|---|---|
| 数据库连接失败 | 检查 config.php 中的数据库用户名、密码、数据库名称是否与 1Panel 中一致 |
| 安装后页面空白 | 检查 PHP 是否安装了 mysqli 扩展。在 1Panel 中进入网站 → PHP 设置 → 扩展,开启 mysqli |
| 上传附件失败 | 确保 uploads/ 目录有写入权限(755 或 777) |
| 邮件验证码无法发送 | 在后台「邮箱验证」区块配置 SMTP 信息,QQ邮箱需使用授权码 |
| 忘记管理员密码 | 在 1Panel 中进入数据库管理,找到 qf_users 表,编辑 admin 用户的 password 字段,重置为新密码的哈希值 |
| 项目 | 说明 |
|---|---|
| 默认管理员 | admin / admin123 |
| 后台入口 | /admin.php |
| 站点设置 | /admin_settings.php |
| 安装程序 | /install.php(安装后删除) |
| 升级程序 | /upgrade.php(升级后删除) |
| 配置文件 | /config.php |
| 附件目录 | /uploads/ |