| 1 |
# LBBS - Classical terminal server of LeafOK BBS |
# LBBS - Classical terminal server of LeafOK BBS |
| 2 |
|
|
| 3 |
Copyright (C) 2004-2025 by Leaflet |
中文版本的README.md位于[README.zh_CN.md](README.zh_CN.md) |
|
Email : leaflet@leafok.com |
|
|
Demo site : bbs.fenglin.info (Telnet 2323 / SSH2 2322) |
|
| 4 |
|
|
| 5 |
|
|
| 6 |
Introduction |
Introduction |
| 7 |
================= |
================= |
| 8 |
This software (named as LBBS) aims to providing a telnet-based interface for a pure web-based BBS (named as LeafOK BBS). |
This software aims to providing a telnet-based interface for a pure web-based BBS [leafok_bbs](https://github.com/leafok/leafok_bbs). |
| 9 |
LeafOK BBS (https://github.com/leafok88/leafok_bbs) provides almost all fundamental BBS features as well as many additional plugins. Its major part was written in PHP + MySQL. |
Demo site : fenglin.info (Telnet 2323 / SSH2 2322) |
| 10 |
Thank you for using this software. If you meet any bugs or have any suggestion, please tell me. |
 |
| 11 |
|
 |
| 12 |
|
 |
| 13 |
|
 |
| 14 |
|
|
| 15 |
|
|
| 16 |
System Requirement |
System Requirement |
| 17 |
================== |
================== |
| 18 |
1) GNU C Compiler |
1) GNU C Compiler |
| 19 |
2) PHP ( Version >= 8.2 ) |
2) PHP ( Version >= 8.2 ) |
| 20 |
3) MySQL database ( Version >= 8.4 ) |
3) MySQL database ( Version >= 8.4 ) |
| 21 |
|
|
| 22 |
|
|
| 23 |
Quick Installation |
Installation |
| 24 |
================== |
================== |
| 25 |
To install LBBS quickly, please do the following steps: |
See guide in [INSTALL.md](INSTALL.md) |
| 26 |
|
|
|
0) Prerequisite |
|
| 27 |
|
|
| 28 |
Follow README.md under https://github.com/leafok88/leafok_bbs to initialize the database structure shared by both web version and telnet version. It is highly recommended to finish the configuration steps of web version first and make sure those features could work properly. |
Tutorial |
| 29 |
|
================== |
| 30 |
1) Extract the source files from a tarball or export from GitHub |
Watch demos and keynotes in [Tutorial.md](Tutorial.md) |
|
Run the following command to set up the autoconf/automake environment, |
|
|
sh ./autogen.sh |
|
|
and fix any error if exists. |
|
|
|
|
|
2) Compile source files |
|
|
./configure --prefix=/usr/local/lbbs |
|
|
make |
|
|
|
|
|
3) Create user and group |
|
|
sudo useradd bbs |
|
|
|
|
|
4) Install binary files and data files |
|
|
sudo make install |
|
|
|
|
|
5) Modify following configuration files |
|
|
Default configuration files is saved as *.default, you should rename them first. |
|
|
/usr/local/lbbs/conf/bbsd.conf |
|
|
/usr/local/lbbs/utils/conf/db_conn.inc.php |
|
| 31 |
|
|
|
6) Generate menu configuration file with section data by running the script |
|
|
sudo -u bbs php /usr/local/lbbs/utils/bin/gen_section_menu.php |
|
|
sudo -u bbs php /usr/local/lbbs/utils/bin/gen_ex_list.php |
|
| 32 |
|
|
| 33 |
7) Create or copy SSH2 RSA certificate into /usr/local/lbbs/conf |
Copyright |
| 34 |
ssh-keygen -t rsa -C "Your Server Name" -f ssh_host_rsa_key |
================= |
| 35 |
|
Copyright (C) 2004-2025 Leaflet <leaflet@leafok.com> |
| 36 |
|
|
|
8) Startup |
|
|
sudo /usr/local/lbbs/bin/bbsd |
|
| 37 |
|
|
| 38 |
9) Set up systemd |
License |
| 39 |
Create your own /usr/lib/systemd/system/lbbs.service from the sample at conf/lbbs.service.default, and make any change if necessary. |
================== |
| 40 |
Reload daemon config and start the service. |
This program is free software; you can redistribute it and/or modify |
| 41 |
|
it under the terms of the [GNU General Public License](LICENSE) as published by |
| 42 |
|
the Free Software Foundation; either version 3 of the License, or |
| 43 |
|
(at your option) any later version. |
Parent Directory
| 
Revision Log
| 
Patch