| 1 |
sysadm |
1.25 |
# 安装说明
|
| 2 |
sysadm |
1.23 |
|
| 3 |
sysadm |
1.25 |
英文版本的更新日志位于 [INSTALL.md](INSTALL.md)。
|
| 4 |
sysadm |
1.23 |
|
| 5 |
sysadm |
1.25 |
要在 Linux（例如：Debian 13、CentOS Stream 10）上安装 LBBS，请按照以下步骤操作：
|
| 6 |
|
|
|
| 7 |
|
|
## 0. 准备工作
|
| 8 |
|
|
|
| 9 |
|
|
按照 [leafok_bbs](https://github.com/leafok/leafok_bbs) 中的 README.md 说明，初始化 Web 和 Telnet 版本共享的数据库结构。
|
| 10 |
|
|
|
| 11 |
|
|
强烈建议先完成 Web 版本的配置步骤，并确保这些功能正常工作。
|
| 12 |
|
|
|
| 13 |
|
|
## 1. 通用要求
|
| 14 |
|
|
|
| 15 |
|
|
- gcc >= 13.3
|
| 16 |
|
|
- autoconf >= 2.68
|
| 17 |
|
|
- automake >= 1.16
|
| 18 |
|
|
- php >= 8.2
|
| 19 |
|
|
- mysql >= 8.4
|
| 20 |
|
|
|
| 21 |
|
|
### 发行版特定软件包
|
| 22 |
|
|
|
| 23 |
|
|
**Debian / Ubuntu：**
|
| 24 |
|
|
```bash
|
| 25 |
|
|
sudo apt-get install -y libssh-dev libsystemd-dev
|
| 26 |
|
|
```
|
| 27 |
|
|
|
| 28 |
|
|
**CentOS / RHEL：**
|
| 29 |
|
|
```bash
|
| 30 |
|
|
sudo dnf install -y libssh-devel systemd-devel
|
| 31 |
|
|
```
|
| 32 |
|
|
|
| 33 |
|
|
**MSYS2 with MinGW-w64 工具链：**
|
| 34 |
|
|
```bash
|
| 35 |
|
|
pacman -S --needed msys2-runtime-devel libssh libssh-devel pcre2-devel mingw-w64-x86_64-libiconv mingw-w64-x86_64-libmariadbclient
|
| 36 |
|
|
```
|
| 37 |
|
|
|
| 38 |
|
|
## 2. 提取源代码文件
|
| 39 |
|
|
|
| 40 |
|
|
从 tarball 或 GitHub 导出源代码文件。
|
| 41 |
|
|
|
| 42 |
|
|
运行以下命令来设置 autoconf/automake 环境：
|
| 43 |
|
|
```bash
|
| 44 |
|
|
autoreconf --install --force
|
| 45 |
|
|
```
|
| 46 |
|
|
|
| 47 |
|
|
## 3. 编译源代码
|
| 48 |
|
|
|
| 49 |
|
|
```bash
|
| 50 |
|
|
export LBBS_HOME_DIR=/usr/local/lbbs
|
| 51 |
|
|
```
|
| 52 |
|
|
|
| 53 |
|
|
**对于 Linux：**
|
| 54 |
|
|
```bash
|
| 55 |
|
|
./configure --prefix=$LBBS_HOME_DIR
|
| 56 |
|
|
```
|
| 57 |
|
|
|
| 58 |
|
|
**对于 MSYS2 with MinGW-w64 工具链：**
|
| 59 |
|
|
```bash
|
| 60 |
|
|
./configure --prefix=$LBBS_HOME_DIR --disable-shared PKG_CONFIG_PATH=/mingw64/lib/pkgconfig/
|
| 61 |
|
|
```
|
| 62 |
|
|
|
| 63 |
|
|
```bash
|
| 64 |
|
|
make
|
| 65 |
|
|
```
|
| 66 |
|
|
|
| 67 |
|
|
## 4. 创建用户和组
|
| 68 |
|
|
|
| 69 |
|
|
```bash
|
| 70 |
|
|
sudo useradd bbs
|
| 71 |
|
|
```
|
| 72 |
|
|
|
| 73 |
|
|
## 5. 安装二进制和数据文件
|
| 74 |
|
|
|
| 75 |
|
|
```bash
|
| 76 |
|
|
sudo make install
|
| 77 |
|
|
chown -R bbs:bbs $LBBS_HOME_DIR
|
| 78 |
|
|
```
|
| 79 |
|
|
|
| 80 |
|
|
## 6. 修改配置文件
|
| 81 |
|
|
|
| 82 |
|
|
默认配置文件保存为 `*.default`。首先重命名它们：
|
| 83 |
|
|
|
| 84 |
|
|
- `$LBBS_HOME_DIR/conf/bbsd.conf`
|
| 85 |
|
|
- `$LBBS_HOME_DIR/conf/bbsnet.conf`
|
| 86 |
|
|
- `$LBBS_HOME_DIR/conf/badwords.conf`
|
| 87 |
|
|
- `$LBBS_HOME_DIR/utils/conf/db_conn.conf.php`
|
| 88 |
|
|
|
| 89 |
|
|
## 7. 复制 MySQL CA 证书
|
| 90 |
|
|
|
| 91 |
|
|
将 MySQL 服务器的 CA 证书文件复制到 `$LBBS_HOME_DIR/conf/ca_cert.pem`。
|
| 92 |
|
|
|
| 93 |
|
|
## 8. 生成菜单配置文件
|
| 94 |
|
|
|
| 95 |
|
|
运行以下脚本以生成包含版块数据的菜单配置文件：
|
| 96 |
|
|
|
| 97 |
|
|
```bash
|
| 98 |
|
|
sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_section_menu.php
|
| 99 |
|
|
sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_ex_list.php
|
| 100 |
|
|
sudo -u bbs php $LBBS_HOME_DIR/utils/bin/gen_top.php
|
| 101 |
|
|
```
|
| 102 |
|
|
|
| 103 |
|
|
## 9. 创建 SSH2 证书
|
| 104 |
|
|
|
| 105 |
|
|
```bash
|
| 106 |
|
|
ssh-keygen -t rsa -C "您的服务器名称" -N "" -f $LBBS_HOME_DIR/conf/ssh_host_rsa_key
|
| 107 |
|
|
ssh-keygen -t ed25519 -C "您的服务器名称" -N "" -f $LBBS_HOME_DIR/conf/ssh_host_ed25519_key
|
| 108 |
|
|
ssh-keygen -t ecdsa -C "您的服务器名称" -N "" -f $LBBS_HOME_DIR/conf/ssh_host_ecdsa_key
|
| 109 |
|
|
```
|
| 110 |
|
|
|
| 111 |
|
|
## 10. 启动
|
| 112 |
|
|
|
| 113 |
|
|
```bash
|
| 114 |
|
|
sudo -u bbs $LBBS_HOME_DIR/bin/bbsd
|
| 115 |
|
|
```
|
| 116 |
|
|
|
| 117 |
|
|
## 11. （可选）设置 systemd
|
| 118 |
|
|
|
| 119 |
|
|
从 `conf/lbbs.service` 中的示例创建您自己的 `/usr/lib/systemd/system/lbbs.service`，并进行任何必要的更改。
|
| 120 |
|
|
|
| 121 |
|
|
重新加载守护进程配置并启动服务。
|
| 122 |
|
|
|
| 123 |
|
|
## 12. （可选）设置 logrotate
|
| 124 |
|
|
|
| 125 |
|
|
从 `conf/lbbs.logrotate` 中的示例创建您自己的 `/etc/logrotate.d/lbbs`，并进行任何必要的更改。
|
| 126 |
|
|
|
| 127 |
|
|
重新启动 logrotate 服务。
|
| 128 |
|
|
|
| 129 |
|
|
## 13. 服务异常终止时的清理
|
| 130 |
|
|
|
| 131 |
|
|
如果发生意外故障或操作不当导致 LBBS 进程异常终止，在重新启动进程之前可能需要手动清理共享内存/信号量。
|
| 132 |
|
|
|
| 133 |
|
|
首先，使用以下命令检查：
|
| 134 |
|
|
```bash
|
| 135 |
|
|
sudo -u bbs ipcs
|
| 136 |
|
|
```
|
| 137 |
|
|
|
| 138 |
|
|
不应存在属于 `bbs` 的项目。否则，使用以下命令清理：
|
| 139 |
|
|
```bash
|
| 140 |
|
|
sudo -u bbs ipcrm -a
|
| 141 |
|
|
```
|
| 142 |
|
|
|
| 143 |
|
|
# 对于 Docker 用户
|
| 144 |
|
|
|
| 145 |
|
|
您可以通过运行以下命令从源代码构建 Docker 镜像：
|
| 146 |
|
|
```bash
|
| 147 |
|
|
docker compose up --build -d
|
| 148 |
|
|
```
|
| 149 |
|
|
|
| 150 |
|
|
或者通过运行以下命令从 Docker Hub 拉取每个版本的 Docker 镜像：
|
| 151 |
|
|
```bash
|
| 152 |
|
|
docker compose pull
|
| 153 |
|
|
```
|
| 154 |
|
|
|
| 155 |
|
|
您应始终按照上述说明创建/更新本地配置（例如，数据库连接、网络端口）的配置文件。 |
Parent Directory
| 
Revision Log