马谷迷你论坛 使用说明文档

一、简介

马谷迷你论坛是一款基于 PHP 开发的轻量级社区论坛系统。
对比 Discuz! 等重型论坛程序，本系统体积精简、代码结构清晰、服务器资源占用极低，适配以下使用场景：

1.      个人站长、小众兴趣爱好者社群；

2.      小型团队、内部测试圈子、私密交流群组；

3.      低配 VPS、虚拟主机、1 核 1G 低配置服务器；

4.      需快速搭建上线、支持后续按需拓展功能的站点。

系统采用单入口 + 插件扩展架构：核心仅保留论坛基础必备功能，邀请码、商城支付、私信等高级能力均以插件形式独立提供，按需安装启用，杜绝无用功能占用服务器资源。

二、产品核心优势

1.      轻量高效：无冗余重型框架依赖，页面响应速度快，内存占用低，低配服务器可稳定承载；

2.      部署极简：仅需上传完整源码，访问install/安装向导可视化完成部署，无需复杂命令行操作；

3.      插件化拓展：所有扩展功能后台一键安装、启用、卸载，可根据自身业务自由搭配；

4.      精细化权限管控：支持自定义用户组、板块访问隔离，针对发帖、上传、付费内容等配置细分操作权限；

5.      原生安全防护：内置垃圾信息拦截、CSRF 令牌校验、上传文件安全策略、全站点操作日志等安全机制；

6.      多主题自定义：前台主题独立分离，支持访客切换、后台统一配置；

7.      多语言适配：自带中文、英文两套语言包，前台、管理后台均可自由切换。

三、运行环境要求

最低运行标准

•        PHP：8.4 及以上正式发行版（不推荐 Debug 调试版本）

•        数据库：MySQL 5.7 及以上版本

四、安装与升级部署流程

（一）全新安装步骤

1.      将完整论坛源码上传至网站根目录或子目录（例：域名/forum/）；

2.      浏览器访问地址：/install/，进入可视化安装向导；

3.      依次完成：环境兼容性检测 → 数据库信息配置 → 管理员账号创建 → 安装完成；

4.      安全强制要求：安装结束后，删除或重命名install安装目录，避免恶意重复安装；

5.      登录后台，进入「论坛设置」完善站点名称、域名、邮件发信配置等基础信息。

（二）版本升级

持续关注官方更新公告，按照配套更新文档指引执行升级操作即可。

五、核心功能总览

5.1 论坛基础模块

1.      板块分类管理：支持多级板块创建、自定义排序、板块描述、按用户组控制可见范围；

2.      主题与回复：发帖、编辑、删除、移动帖子，支持单板块置顶、全站置顶；

3.      多列表展示：树状视图、表格视图等多种帖子浏览模式；

4.      阅读状态标记：自动区分已读 / 未读帖子，可自定义状态过期清理规则；

5.      标签 Tag：可选开启，用于内容归类、检索分流；

6.      RSS 订阅：后台开关控制是否开放订阅、自定义展示条目数量；

7.      全文检索：支持关键词匹配检索站内帖子；

8.      帖子书签：用户可收藏感兴趣主题，快速回看。

5.2 用户体系与权限管理

1.      账号基础功能：注册、登录、密码找回；

2.      自定义用户组：自由创建分组，独立配置分组名称、简介、每日操作限额；

3.      细分权限控制（按用户组独立配置）：

￮       发帖、回复帖子权限；

￮       图片上传、附件上传 / 下载权限；

￮       发布付费内容、隐藏可见内容权限；

￮       视频嵌入发布权限；

￮       后台管理、版主审核权限；

4.      板块访问隔离：限制指定用户组仅能浏览对应板块；

5.      账号运维：管理员可锁定、激活、编辑、批量删除用户账号。

5.3 内容发布与编辑器

1.      富文本编辑器（所见即所得）：

￮       文字排版、列表、表格、超链接基础格式；

￮       本地图片上传、外链图片引入；

￮       表情库、多语法代码块高亮；

￮       分组可见隐藏内容区块；

￮       视频嵌入插入（配套权限管控）；

2.      附件系统：分片大文件上传，限制文件格式、单文件大小；搭配金钱插件可实现付费附件；

3.      付费阅读帖：支持自定义积分 / 金币阅读门槛（需配套货币插件）。

5.4 积分系统（核心内置）

1.      后台可视化配置积分增减规则：登录、发帖、回帖、上传文件等行为自动奖惩；

2.      搭配「金钱系统」插件，可分离积分、金币两套独立站内货币。

5.5 独立页面

1.      后台可视化创建独立页面，适用于《关于我们》《社区规范》《隐私政策》等固定内容；

2.      富文本编辑页面内容，支持挂载至站点顶部导航栏。

5.6 前台配套功能

用户资料主页、个人发帖记录、全站用户列表；
新回复邮件通知（依赖服务器邮件发送能力）；
联系管理员入口；
帖子举报功能（联动防垃圾插件自动处理违规内容）。

六、后台管理模块说明

登录管理员账号后，通过「管理→后台管理」进入控制面板，各模块功能如下：

模块名称	核心功能说明
论坛设置	配置站点名称、域名、注册方式、时区、默认主题、RSS、帖子编辑时效等全局参数
高级设置	分页条数、上传文件限制、BBCode 开关、Session 前缀等底层参数
插件管理	插件安装、启用、禁用、卸载，进入各插件独立配置页面
板块管理	新增、编辑、删除板块，自定义板块排序
用户管理	用户全量列表、账号信息编辑、锁定封禁、批量删除、手动注册账号
用户组管理	创建自定义用户分组，配置分组操作权限、板块访问权限
积分规则	配置各类用户行为对应的积分增减数值
表情管理	上传、删除、排序前台发帖表情素材
静态页面	管理站点独立自定义页面
上传图库	查看、批量清理用户上传的全部图片资源
垃圾信息审核	查看、标记、批量处理垃圾帖子（依赖防垃圾插件）
操作日志	记录账号登录、安全事件、管理员后台操作，全程可追溯
在线会话	实时查看当前在线用户，支持强制下线操作
数据备份	一键导出数据库备份文件，最多留存 15 份，文件存储路径files/backups/
版本更新	查看官方更新日志、升级指引

七、内置安全与合规机制

安全能力	防护说明
CSRF 跨站请求防护	登录、发帖、后台操作、文件上传等所有写入操作强制校验安全令牌
Session 会话加固	Cookie 开启 HttpOnly、SameSite=Strict；HTTPS 站点自动启用 Secure 加密标识
文件上传防护	图片自动 GD 重编码清洗、文件后缀 + MIME 双重校验、分片上传、临时目录隔离存储
XSS 跨站脚本防护	富文本内容采用 HTML 白名单过滤，自动清理恶意脚本代码
垃圾信息拦截	登录验证码、操作频率限流、关键词黑名单，可通过插件拓展更多拦截规则
全量操作日志	登录失败记录、安全异常事件、管理员修改操作完整留存，便于溯源排查
备份文件保护	数据库备份文件禁止外网直接访问，避免数据泄露