环境要求

组件最低要求推荐
PHP7.37.4 / 8.0
MySQL5.65.7 / 8.0
PHP 扩展mysqli(必须)
1Panel已安装并正常运行

安装步骤

1

创建网站

登录 1Panel 面板,进入 网站创建网站

  • 主域名:填写你的域名(如 forum.example.com),也可以先用 IP 地址
  • 运行环境:选择 PHP(推荐 PHP 7.4 或 8.0)
  • 数据库:勾选「创建数据库」,选择 MySQL,字符集 utf8mb4
  • 网站目录:使用默认即可(记下路径,后面需要上传文件到这里)

创建完成后,1Panel 会自动生成数据库名称和密码,请记下这些信息。

2

上传文件

进入 1Panel 网站 列表,找到刚创建的网站,点击进入 网站目录

删除默认的 index.php 文件,然后上传 Lume 压缩包并解压:

  1. 点击「上传」,选择 Lume 安装包(.zip)上传
  2. 上传完成后,在文件列表中右键压缩包 → 解压
  3. 解压后,确保所有文件都在网站根目录下(而不是子文件夹中)
提示:如果解压后文件在子目录中,可以选中全部文件,使用「剪切」→「粘贴」移动到根目录。
3

配置数据库连接

在网站目录中找到 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 秒内只能发一次
?>
如何找到数据库信息? 在 1Panel 面板中进入 数据库,找到创建网站时自动生成的数据库,点击「连接信息」即可查看用户名、密码和数据库名称。
4

运行安装程序

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

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

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

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

登录后台

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

  • 用户名admin
  • 密码admin123

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

6

更新旧版(可选)

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

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

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

1Panel 伪静态设置(可选)

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/