/[LeafOK_CVS]/fenglin/README.zh_CN.md
ViewVC logotype

Diff of /fenglin/README.zh_CN.md

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.1 by sysadm, Thu Jan 8 08:15:53 2026 UTC Revision 1.7 by sysadm, Fri Jan 23 12:08:09 2026 UTC
# Line 2  Line 2 
2    
3  英文版本: [README.md](README.md)  英文版本: [README.md](README.md)
4    
5    ## 目录
6    - [程序简介](#程序简介)
7    - [安装和使用说明](#安装和使用说明)
8      - [前置条件和所需库](#1-前置条件和所需库)
9      - [数据库设置](#2-数据库设置)
10      - [配置文件](#3-配置文件)
11      - [站点个性化配置](#4-站点个性化配置)
12      - [目录权限](#5-目录权限)
13      - [账户创建](#6-账户创建)
14      - [附加数据库设置](#7-数据库设置附加)
15      - [管理和后台作业](#8-管理和后台作业)
16    - [Docker部署](#docker部署)
17      - [快速开始](#快速开始)
18      - [从源代码构建](#从源代码构建)
19      - [使用预构建镜像](#使用预构建镜像)
20      - [Docker配置](#docker配置)
21      - [持久化数据](#持久化数据)
22    - [版权信息](#版权信息)
23    - [授权许可](#授权许可)
24    
25  ## 程序简介  ## 程序简介
26    
27  **开发语言：** PHP (8.2) + MySQL (8.4)    **开发语言：** PHP (8.2) + MySQL (8.4)  
# Line 12  英文版本: [README.md](README.md) Line 32  英文版本: [README.md](README.md)
32  - 基于Web的文章浏览、发表、查找等基本功能和其它各种实用功能  - 基于Web的文章浏览、发表、查找等基本功能和其它各种实用功能
33  - 支持多类别多版块，各版块分设讨论区、文摘区、精华区  - 支持多类别多版块，各版块分设讨论区、文摘区、精华区
34  - 提供全面的版主管理支持  - 提供全面的版主管理支持
35    - **高级搜索功能：**
36      - 支持中文的Solr全文搜索
37    - **现代架构：**
38      - 重构的轻量级标记语言（LML）渲染器，性能更优
39      - 支持用户时区，本地化日期/时间显示
40      - 主要功能支持主题定制
41  - 可选Telnet方式的登陆访问、文章查看、游戏等功能（详见[lbbs](https://github.com/leafok/lbbs)）  - 可选Telnet方式的登陆访问、文章查看、游戏等功能（详见[lbbs](https://github.com/leafok/lbbs)）
42    
43  **演示站点：** https://fenglin.info/bbs/  **演示站点：** https://fenglin.info/bbs/
44    
45  ## 安装和使用说明  ## 安装和使用说明
46    
47  ### 1. 数据库设置  ### 1. 前置条件和所需库
48    - **PHP 8.2+** 和 **MySQL 8.4+** 已安装
49    - 使用包管理器安装 Composer（例如 `apt`、`yum`）
50    - 在项目根目录运行以下命令：
51    ```bash
52    composer install --prefer-dist --no-scripts --no-progress
53    ```
54    
55    ### 2. 数据库设置
56  - 导入数据库结构文件 `TODO/sql/db_stru.sql`  - 导入数据库结构文件 `TODO/sql/db_stru.sql`
57  - *(可选)* 导入测试数据 `TODO/sql/sample_data.sql`  - *(可选)* 导入测试数据 `TODO/sql/sample_data.sql`
58    - 测试账户：`sysop`    - 测试账户：`sysop`
59    - 临时密码（登陆时需修改）：`3anzHaNg`    - 临时密码（首次登陆时需修改）：`3anzHaNg`
60    
61  ### 2. 配置文件  ### 3. 配置文件
62  - 将 `TODO/conf/` 目录下的文件复制到 `conf` 目录下（如不存在）  - 将 `TODO/conf/` 目录下的文件复制到 `conf` 目录下（如不存在）
63  - 修改以下文件：  - 修改以下文件：
64      - 站点信息：编辑 `conf/site.conf.php`
65    - 数据库连接：编辑 `conf/db_conn.conf.php`    - 数据库连接：编辑 `conf/db_conn.conf.php`
66    - 邮件发送：编辑 `conf/smtp.conf.php`（支持SMTP和本地sendmail两种方式）    - 邮件发送：编辑 `conf/smtp.conf.php`（支持SMTP和本地sendmail两种方式）
67    - **Solr搜索**（可选）：如需使用Solr进行高级搜索，编辑 `conf/solr.conf.php`
68      - 默认配置假设Solr运行在 `localhost:8983`，核心为 `lbbs`
69      - 根据需要更新主机名、端口、认证信息和路径
70      - 将 `TODO/solr/schema.json` 中的架构导入到核心 `lbbs`
71      - 使用PHP扩展安装工具PIE安装pecl/solr扩展
72    
73  ### 3. 站点个性化配置  ### 4. 站点个性化配置
74  - 修改 `lib/common.inc.php` 文件  - 修改 `lib/common.inc.php` 文件
75    
76  ### 4. 目录权限  ### 5. 目录权限
77  - 创建目录（如果不存在）：  - 创建目录（如果不存在）：
78    - `bbs/cache`    - `bbs/cache`
79    - `bbs/upload`    - `bbs/upload`
80      - `export_xml`
81    - `stat`    - `stat`
82  - 确保Web服务器运行账户对以下目录有写权限：  - 确保Web服务器运行账户对以下目录有写权限：
83    - `bbs/cache`    - `bbs/cache`
84    - `bbs/upload`    - `bbs/upload`
85      - `export_xml`
86    - `gen_ex`    - `gen_ex`
87    - `stat`    - `stat`
88    
89  ### 5. 账户创建  ### 6. 账户创建
90  - 通过注册页面创建管理员账号等初始账号  - 通过注册页面创建管理员账号等初始账号
91  - *注意：* 涉及多张数据表，不建议直接在数据库中创建  - *注意：* 涉及多张数据表，不建议直接在数据库中创建
92    
93  ### 6. 数据库设置（附加）  ### 7. 数据库设置（附加）
94  - 在数据库中添加管理员帐号、栏目、版块等  - 在数据库中添加管理员帐号、栏目、版块等
95  - 相关数据表：`admin_config`、`section_class`、`section_config`  - 相关数据表：`admin_config`、`section_class`、`section_config`
96    
97  ### 7. 管理和后台作业  ### 8. 管理和后台作业
98  - 管理程序位于 `manage` 目录下  - 管理程序位于 `manage` 目录下
99  - 定时后台作业需要自行添加crontab  - 定时后台作业需要自行添加crontab
100    
101  ## Docker用户  ## Docker部署
102    
103    ### 快速开始
104    ```bash
105    # 克隆仓库
106    git clone https://github.com/leafok/leafok_bbs.git
107    cd leafok_bbs
108    
109    # 使用 Docker Compose 启动
110    docker compose up -d
111    ```
112    
113  ### 从源代码构建  ### 从源代码构建
114  ```bash  ```bash
115  docker compose up --build -d  docker compose up --build -d
116  ```  ```
117    
118  ### 从Docker Hub下载  ### 使用预构建镜像
119  ```bash  ```bash
120    # 从 Docker Hub 拉取最新镜像
121  docker compose pull  docker compose pull
122    
123    # 启动容器
124    docker compose up -d
125  ```  ```
126    
127  ### 配置  ### Docker配置
128  在容器的 `/var/www/html/conf` 目录下，修改或导入配置文件。  1. Web 应用将在 `http://localhost:8080` 可用
129    2. 配置文件应放置在 `conf/` 目录（在容器中挂载到 `/var/www/html/conf`）
130    3. 修改配置：
131       - 将文件从 `TODO/conf/` 复制到 `conf/` 目录
132       - 根据需要编辑配置文件
133       - 重启容器：`docker compose restart`
134    
135    ### 持久化数据
136    - 数据库数据存储在 Docker 卷中（`leafok_bbs_db_data`）
137    - 上传的文件和缓存存储在挂载的主机目录中
138    
139  ## 版权信息  ## 版权信息
140  版权所有 (C) 2004-2026 Leaflet <leaflet@leafok.com>  版权所有 (C) 2001-2026 Leaflet <leaflet@leafok.com>
141    
142  ## 授权许可  ## 授权许可
143  本程序是自由软件；您可以按照自由软件基金会发布的[GNU通用发布许可](LICENSE)的第三版或后续版本的条款，分发和/或修改本程序。  本程序是自由软件；您可以按照自由软件基金会发布的[GNU通用发布许可](LICENSE)的第三版或后续版本的条款，分发和/或修改本程序。

Legend:
Removed lines/characters  
Changed lines/characters
  Added lines/characters
webmaster@leafok.com
 ViewVC Help
Powered by ViewVC 1.3.0-beta1