| 1 |
sysadm |
1.1 |
# LeafOK BBS
|
| 2 |
|
|
|
| 3 |
|
|
英文版本: [README.md](README.md)
|
| 4 |
|
|
|
| 5 |
|
|
## 程序简介
|
| 6 |
|
|
|
| 7 |
|
|
**开发语言:** PHP (8.2) + MySQL (8.4)
|
| 8 |
|
|
**运行平台:** Linux / Windows
|
| 9 |
|
|
**授权许可:** 源代码采用 GNU GPL 授权发布
|
| 10 |
|
|
|
| 11 |
|
|
**功能说明:**
|
| 12 |
|
|
- 基于Web的文章浏览、发表、查找等基本功能和其它各种实用功能
|
| 13 |
|
|
- 支持多类别多版块,各版块分设讨论区、文摘区、精华区
|
| 14 |
|
|
- 提供全面的版主管理支持
|
| 15 |
|
|
- 可选Telnet方式的登陆访问、文章查看、游戏等功能(详见[lbbs](https://github.com/leafok/lbbs))
|
| 16 |
|
|
|
| 17 |
|
|
**演示站点:** https://fenglin.info/bbs/
|
| 18 |
|
|
|
| 19 |
|
|
## 安装和使用说明
|
| 20 |
|
|
|
| 21 |
|
|
### 1. 数据库设置
|
| 22 |
|
|
- 导入数据库结构文件 `TODO/sql/db_stru.sql`
|
| 23 |
|
|
- *(可选)* 导入测试数据 `TODO/sql/sample_data.sql`
|
| 24 |
|
|
- 测试账户:`sysop`
|
| 25 |
|
|
- 临时密码(登陆时需修改):`3anzHaNg`
|
| 26 |
|
|
|
| 27 |
|
|
### 2. 配置文件
|
| 28 |
|
|
- 将 `TODO/conf/` 目录下的文件复制到 `conf` 目录下(如不存在)
|
| 29 |
|
|
- 修改以下文件:
|
| 30 |
|
|
- 数据库连接:编辑 `conf/db_conn.conf.php`
|
| 31 |
|
|
- 邮件发送:编辑 `conf/smtp.conf.php`(支持SMTP和本地sendmail两种方式)
|
| 32 |
|
|
|
| 33 |
|
|
### 3. 站点个性化配置
|
| 34 |
|
|
- 修改 `lib/common.inc.php` 文件
|
| 35 |
|
|
|
| 36 |
|
|
### 4. 目录权限
|
| 37 |
|
|
- 创建目录(如果不存在):
|
| 38 |
|
|
- `bbs/cache`
|
| 39 |
|
|
- `bbs/upload`
|
| 40 |
|
|
- `stat`
|
| 41 |
|
|
- 确保Web服务器运行账户对以下目录有写权限:
|
| 42 |
|
|
- `bbs/cache`
|
| 43 |
|
|
- `bbs/upload`
|
| 44 |
|
|
- `gen_ex`
|
| 45 |
|
|
- `stat`
|
| 46 |
|
|
|
| 47 |
|
|
### 5. 账户创建
|
| 48 |
|
|
- 通过注册页面创建管理员账号等初始账号
|
| 49 |
|
|
- *注意:* 涉及多张数据表,不建议直接在数据库中创建
|
| 50 |
|
|
|
| 51 |
|
|
### 6. 数据库设置(附加)
|
| 52 |
|
|
- 在数据库中添加管理员帐号、栏目、版块等
|
| 53 |
|
|
- 相关数据表:`admin_config`、`section_class`、`section_config`
|
| 54 |
|
|
|
| 55 |
|
|
### 7. 管理和后台作业
|
| 56 |
|
|
- 管理程序位于 `manage` 目录下
|
| 57 |
|
|
- 定时后台作业需要自行添加crontab
|
| 58 |
|
|
|
| 59 |
|
|
## Docker用户
|
| 60 |
|
|
|
| 61 |
|
|
### 从源代码构建
|
| 62 |
|
|
```bash
|
| 63 |
|
|
docker compose up --build -d
|
| 64 |
|
|
```
|
| 65 |
|
|
|
| 66 |
|
|
### 从Docker Hub下载
|
| 67 |
|
|
```bash
|
| 68 |
|
|
docker compose pull
|
| 69 |
|
|
```
|
| 70 |
|
|
|
| 71 |
|
|
### 配置
|
| 72 |
|
|
在容器的 `/var/www/html/conf` 目录下,修改或导入配置文件。
|
| 73 |
|
|
|
| 74 |
|
|
## 版权信息
|
| 75 |
|
|
版权所有 (C) 2004-2026 Leaflet <leaflet@leafok.com>
|
| 76 |
|
|
|
| 77 |
|
|
## 授权许可
|
| 78 |
|
|
本程序是自由软件;您可以按照自由软件基金会发布的[GNU通用发布许可](LICENSE)的第三版或后续版本的条款,分发和/或修改本程序。 |