最简安装流程总结
1. 宝塔添加网站。
2. 创建 MySQL 数据库。
3. 上传并解压 Lume 1.0.zip。
4. 把程序文件放到网站根目录。
5. 修改 config.php 数据库信息。
6. 设置 uploads 可写。
7. 访问 /install.php 安装。
8. 登录后台。
9. 修改管理员密码。
10. 删除 install.php。
11. 根据需要访问 /upgrade.php。
12. 删除 upgrade.php。
老鸟不用看下面是照顾新鸟的
Lume 轻论坛宝塔面板安装方法
一、创建网站
进入宝塔面板：
网站 → 添加站点
填写：
域名：
你的论坛域名，例如 bbs.example.com
根目录：
宝塔会自动生成，一般类似：
/www/wwwroot/bbs.example.com
数据库：
选择创建 MySQL 数据库
PHP 版本：
选择 PHP 8.1 或 PHP 8.2
提交后，宝塔会自动创建：
网站目录
数据库名
数据库用户名
数据库密码
请把数据库信息保存好，后面要写入 config.php。
二、上传程序文件
把 qing_forum.zip 上传到网站根目录。
例如上传到：
/www/wwwroot/bbs.example.com
然后在宝塔文件管理器里解压。
如果解压后目录是：
/www/wwwroot/bbs.example.com/qing_forum
建议把 qing_forum 目录里的所有文件移动到网站根目录。
最终网站根目录里应该能看到这些文件：
config.php
install.php
upgrade.php
index.php
forum.php
thread.php
post.php
db.php
assets
uploads
也就是说，访问下面地址应该能打开安装程序：
https://你的域名/install.php
而不是：
https://你的域名/qing_forum/install.php
除非你本来就想安装在 qing_forum 子目录。
三、修改 config.php
打开网站根目录里的：
config.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', '一款简单干净的轻论坛程序');
保存。
四、设置目录权限
宝塔文件管理器里，确认这些目录可写：
uploads
uploads/avatar
uploads/ads
如果目录不存在，可以手动创建。
推荐权限：
目录权限：755
文件权限：644
所有者：www
如果上传头像或附件失败，可以临时把 uploads 设置为 775。
不要长期设置 777，除非服务器环境特殊且没办法。
五、运行安装程序
浏览器访问：
https://你的域名/install.php
程序会自动创建数据库表和默认管理员账号。
默认管理员：
用户名：admin
密码：admin123
安装完成后，立即登录后台修改管理员密码。
六、删除或改名安装文件
安装成功后，必须删除或改名：
install.php
如果已经运行过升级，也建议删除或改名：
upgrade.php
例如改成：
install_bak_不要访问.php
upgrade_bak_不要访问.php
更推荐直接删除。
七、登录后台
访问：
https://你的域名/login.php
使用默认管理员登录：
admin
admin123
登录后进入：
后台
建议先做这些设置：
修改站点名称
修改网站简介
设置关键词
设置备案信息
设置上传附件大小
设置允许上传后缀
设置验证码
配置七牛云对象存储
配置友情链接
修改管理员密码和头像
八、配置 HTTPS
宝塔面板：
网站 → 你的站点 → SSL
可以申请 Let's Encrypt 免费证书。
开启后建议勾选：
强制 HTTPS
这样用户访问 http 会自动跳到 https。
九、配置七牛云上传
如果你想让帖子图片和附件直接上传到七牛云：
后台管理 → 站点设置 → 七牛云对象存储
填写：
开启七牛云上传：开启
AccessKey：你的七牛 AccessKey
SecretKey：你的七牛 SecretKey
Bucket：你的空间名称
七牛绑定域名：https://你的七牛访问域名
七牛上传地址：https://upload.qiniup.com
注意：
七牛绑定域名必须带 http:// 或 https://
如果你的空间不是华东区域，需要改成对应上传地址：
华东：
https://upload.qiniup.com
华北：
https://upload-z1.qiniup.com
华南：
https://upload-z2.qiniup.com
北美：
https://upload-na0.qiniup.com
东南亚：
https://upload-as0.qiniup.com
十、后续覆盖升级方法
以后拿到新版程序包时，建议这样升级：
第一步：
先备份网站文件和数据库。
第二步：
上传新版压缩包，解压。
第三步：
覆盖新版文件。
通常不要覆盖：
config.php
uploads
因为 config.php 里有你的数据库配置，uploads 里有本地上传文件。
第四步：
如果新版说明里提到数据库升级，访问：
https://你的域名/upgrade.php
第五步：
升级完成后删除或改名：
upgrade.php
十一、安装后常见问题
问题一：
数据库连接失败。
检查：
config.php 里的数据库名、用户名、密码是否正确。
DB_HOST 一般填写 localhost。
数据库用户是否有权限访问该数据库。
问题二：
上传头像或附件失败。
检查：
uploads 目录是否存在。
uploads 是否可写。
PHP 的 upload_max_filesize 是否太小。
后台设置的附件大小是否超过 PHP 限制。
问题三：
验证码图片不显示。
检查：
captcha.php 是否存在。
PHP session 是否正常。
浏览器是否拦截图片。
网站是否有错误的防盗链规则。
问题四：
七牛云上传失败。
检查：
PHP 是否安装 curl 扩展。
AccessKey 是否正确。
SecretKey 是否正确。
Bucket 是否正确。
上传地址是否对应空间区域。
绑定域名是否填写完整，必须带 https:// 或 http://。
问题五：
页面样式不更新。
检查：
浏览器缓存。
Nginx 静态缓存。
OPcache 缓存。
可以尝试：
强制刷新浏览器：Ctrl + F5
重启 PHP
清理宝塔缓存
十二、安装完成后的安全建议
必须修改默认管理员密码。
必须删除 install.php。
建议删除或改名 upgrade.php。
建议开启 HTTPS。
不要把数据库备份放在网站根目录。
不要把旧源码压缩包长期放在网站根目录。
定期备份数据库。
定期备份网站文件。
1. 宝塔添加网站。
2. 创建 MySQL 数据库。
3. 上传并解压 Lume 1.0.zip。
4. 把程序文件放到网站根目录。
5. 修改 config.php 数据库信息。
6. 设置 uploads 可写。
7. 访问 /install.php 安装。
8. 登录后台。
9. 修改管理员密码。
10. 删除 install.php。
11. 根据需要访问 /upgrade.php。
12. 删除 upgrade.php。
老鸟不用看下面是照顾新鸟的
Lume 轻论坛宝塔面板安装方法
一、创建网站
进入宝塔面板：
网站 → 添加站点
填写：
域名：
你的论坛域名，例如 bbs.example.com
根目录：
宝塔会自动生成，一般类似：
/www/wwwroot/bbs.example.com
数据库：
选择创建 MySQL 数据库
PHP 版本：
选择 PHP 8.1 或 PHP 8.2
提交后，宝塔会自动创建：
网站目录
数据库名
数据库用户名
数据库密码
请把数据库信息保存好，后面要写入 config.php。
二、上传程序文件
把 qing_forum.zip 上传到网站根目录。
例如上传到：
/www/wwwroot/bbs.example.com
然后在宝塔文件管理器里解压。
如果解压后目录是：
/www/wwwroot/bbs.example.com/qing_forum
建议把 qing_forum 目录里的所有文件移动到网站根目录。
最终网站根目录里应该能看到这些文件：
config.php
install.php
upgrade.php
index.php
forum.php
thread.php
post.php
db.php
assets
uploads
也就是说，访问下面地址应该能打开安装程序：
https://你的域名/install.php
而不是：
https://你的域名/qing_forum/install.php
除非你本来就想安装在 qing_forum 子目录。
三、修改 config.php
打开网站根目录里的：
config.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', '一款简单干净的轻论坛程序');
保存。
四、设置目录权限
宝塔文件管理器里，确认这些目录可写：
uploads
uploads/avatar
uploads/ads
如果目录不存在，可以手动创建。
推荐权限：
目录权限：755
文件权限：644
所有者：www
如果上传头像或附件失败，可以临时把 uploads 设置为 775。
不要长期设置 777，除非服务器环境特殊且没办法。
五、运行安装程序
浏览器访问：
https://你的域名/install.php
程序会自动创建数据库表和默认管理员账号。
默认管理员：
用户名：admin
密码：admin123
安装完成后，立即登录后台修改管理员密码。
六、删除或改名安装文件
安装成功后，必须删除或改名：
install.php
如果已经运行过升级，也建议删除或改名：
upgrade.php
例如改成：
install_bak_不要访问.php
upgrade_bak_不要访问.php
更推荐直接删除。
七、登录后台
访问：
https://你的域名/login.php
使用默认管理员登录：
admin
admin123
登录后进入：
后台
建议先做这些设置：
修改站点名称
修改网站简介
设置关键词
设置备案信息
设置上传附件大小
设置允许上传后缀
设置验证码
配置七牛云对象存储
配置友情链接
修改管理员密码和头像
八、配置 HTTPS
宝塔面板：
网站 → 你的站点 → SSL
可以申请 Let's Encrypt 免费证书。
开启后建议勾选：
强制 HTTPS
这样用户访问 http 会自动跳到 https。
九、配置七牛云上传
如果你想让帖子图片和附件直接上传到七牛云：
后台管理 → 站点设置 → 七牛云对象存储
填写：
开启七牛云上传：开启
AccessKey：你的七牛 AccessKey
SecretKey：你的七牛 SecretKey
Bucket：你的空间名称
七牛绑定域名：https://你的七牛访问域名
七牛上传地址：https://upload.qiniup.com
注意：
七牛绑定域名必须带 http:// 或 https://
如果你的空间不是华东区域，需要改成对应上传地址：
华东：
https://upload.qiniup.com
华北：
https://upload-z1.qiniup.com
华南：
https://upload-z2.qiniup.com
北美：
https://upload-na0.qiniup.com
东南亚：
https://upload-as0.qiniup.com
十、后续覆盖升级方法
以后拿到新版程序包时，建议这样升级：
第一步：
先备份网站文件和数据库。
第二步：
上传新版压缩包，解压。
第三步：
覆盖新版文件。
通常不要覆盖：
config.php
uploads
因为 config.php 里有你的数据库配置，uploads 里有本地上传文件。
第四步：
如果新版说明里提到数据库升级，访问：
https://你的域名/upgrade.php
第五步：
升级完成后删除或改名：
upgrade.php
十一、安装后常见问题
问题一：
数据库连接失败。
检查：
config.php 里的数据库名、用户名、密码是否正确。
DB_HOST 一般填写 localhost。
数据库用户是否有权限访问该数据库。
问题二：
上传头像或附件失败。
检查：
uploads 目录是否存在。
uploads 是否可写。
PHP 的 upload_max_filesize 是否太小。
后台设置的附件大小是否超过 PHP 限制。
问题三：
验证码图片不显示。
检查：
captcha.php 是否存在。
PHP session 是否正常。
浏览器是否拦截图片。
网站是否有错误的防盗链规则。
问题四：
七牛云上传失败。
检查：
PHP 是否安装 curl 扩展。
AccessKey 是否正确。
SecretKey 是否正确。
Bucket 是否正确。
上传地址是否对应空间区域。
绑定域名是否填写完整，必须带 https:// 或 http://。
问题五：
页面样式不更新。
检查：
浏览器缓存。
Nginx 静态缓存。
OPcache 缓存。
可以尝试：
强制刷新浏览器：Ctrl + F5
重启 PHP
清理宝塔缓存
十二、安装完成后的安全建议
必须修改默认管理员密码。
必须删除 install.php。
建议删除或改名 upgrade.php。
建议开启 HTTPS。
不要把数据库备份放在网站根目录。
不要把旧源码压缩包长期放在网站根目录。
定期备份数据库。
定期备份网站文件。