/[LeafOK_CVS]/lbbs/INSTALL.zh_CN.md
ViewVC logotype

Diff of /lbbs/INSTALL.zh_CN.md

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

Revision 1.25 by sysadm, Thu Jan 8 03:18:58 2026 UTC Revision 1.26 by sysadm, Sat Jan 10 06:53:26 2026 UTC
# Line 1  Line 1 
1  # 安装说明  # 安装说明
2    
3  英文版本的更新日志位于 [INSTALL.md](INSTALL.md)。  英文版本的安装说明位于 [INSTALL.md](INSTALL.md)。
4    
5  要在 Linux（例如：Debian 13、CentOS Stream 10）上安装 LBBS，请按照以下步骤操作：  要在 Linux（例如：Debian 13、CentOS Stream 10）上安装 LBBS，请按照以下步骤操作：
6    
# Line 79  chown -R bbs:bbs $LBBS_HOME_DIR Line 79  chown -R bbs:bbs $LBBS_HOME_DIR
79    
80  ## 6. 修改配置文件  ## 6. 修改配置文件
81    
82  默认配置文件保存为 `*.default`。首先重命名它们：  默认配置文件保存为 `*.default`。首先复制并重命名它们：
83    
84  - `$LBBS_HOME_DIR/conf/bbsd.conf`  ```bash
85  - `$LBBS_HOME_DIR/conf/bbsnet.conf`  cd $LBBS_HOME_DIR
86  - `$LBBS_HOME_DIR/conf/badwords.conf`  cp conf/bbsd.conf.default conf/bbsd.conf
87  - `$LBBS_HOME_DIR/utils/conf/db_conn.conf.php`  cp conf/bbsnet.conf.default conf/bbsnet.conf
88    cp conf/badwords.conf.default conf/badwords.conf
89    cp utils/conf/db_conn.conf.php.default utils/conf/db_conn.conf.php
90    ```
91    
92    然后编辑每个文件以匹配您的环境：
93    
94    ### bbsd.conf
95    需要调整的关键设置：
96    - `db_host`, `db_username`, `db_password`, `db_database`: MySQL 连接详情
97    - `bbs_server`, `bbs_port`, `bbs_ssh_port`: 网络设置
98    - `bbs_name`: 您的 BBS 名称
99    - `bbs_max_client`: 最大并发连接数（根据服务器容量调整）
100    
101    ### db_conn.conf.php
102    设置数据库连接参数：
103    - `$DB_hostname`, `$DB_username`, `$DB_password`, `$DB_database`
104    
105    ### bbsnet.conf & badwords.conf
106    根据您的 BBS 策略进行审查和自定义。
107    
108  ## 7. 复制 MySQL CA 证书  ## 7. 复制 MySQL CA 证书
109    
# Line 102  sudo -u bbs php $LBBS_HOME_DIR/utils/bin Line 121  sudo -u bbs php $LBBS_HOME_DIR/utils/bin
121    
122  ## 9. 创建 SSH2 证书  ## 9. 创建 SSH2 证书
123    
124    为 SSH 服务器组件生成 SSH 主机密钥。`-N ""` 标志为密钥设置空密码（自动化服务启动所需）。
125    
126  ```bash  ```bash
127  ssh-keygen -t rsa -C "您的服务器名称" -N "" -f $LBBS_HOME_DIR/conf/ssh_host_rsa_key  ssh-keygen -t rsa -C "您的服务器名称" -N "" -f $LBBS_HOME_DIR/conf/ssh_host_rsa_key
128  ssh-keygen -t ed25519 -C "您的服务器名称" -N "" -f $LBBS_HOME_DIR/conf/ssh_host_ed25519_key  ssh-keygen -t ed25519 -C "您的服务器名称" -N "" -f $LBBS_HOME_DIR/conf/ssh_host_ed25519_key
# Line 130  重新启动 logrotate 服务。 Line 151  重新启动 logrotate 服务。
151    
152  如果发生意外故障或操作不当导致 LBBS 进程异常终止，在重新启动进程之前可能需要手动清理共享内存/信号量。  如果发生意外故障或操作不当导致 LBBS 进程异常终止，在重新启动进程之前可能需要手动清理共享内存/信号量。
153    
154  首先，使用以下命令检查：  ### 何时需要清理
155    - `bbsd` 进程崩溃或被强制终止后
156    - 如果 `bbsd` 启动时出现"共享内存已存在"错误
157    - 当 `ipcs` 显示属于用户 `bbs` 的资源时
158    
159    ### 检查孤儿资源
160    首先，检查是否有剩余的共享内存段或信号量：
161  ```bash  ```bash
162  sudo -u bbs ipcs  sudo -u bbs ipcs
163  ```  ```
164    
165  不应存在属于 `bbs` 的项目。否则，使用以下命令清理：  查看 "SHM"（共享内存）和 "SEM"（信号量）部分中 "OWNER" 为 `bbs` 的条目。
166    
167    ### 清理
168    如果存在资源，使用以下命令删除：
169  ```bash  ```bash
170  sudo -u bbs ipcrm -a  sudo -u bbs ipcrm -a
171  ```  ```
172    
173  # 对于 Docker 用户  这将删除 `bbs` 用户可访问的所有共享内存和信号量资源。
174    
175    ## 14. Docker 安装（替代方法）
176    
177  您可以通过运行以下命令从源代码构建 Docker 镜像：  对于容器化部署，LBBS 提供 Docker 支持。
178    
179    ### 从源代码构建
180    要从源代码构建 Docker 镜像：
181  ```bash  ```bash
182  docker compose up --build -d  docker compose up --build -d
183  ```  ```
184    
185  或者通过运行以下命令从 Docker Hub 拉取每个版本的 Docker 镜像：  ### 使用预构建镜像
186    要使用 Docker Hub 中的预构建镜像：
187  ```bash  ```bash
188  docker compose pull  docker compose pull
189    docker compose up -d
190  ```  ```
191    
192  您应始终按照上述说明创建/更新本地配置（例如，数据库连接、网络端口）的配置文件。  ### Docker 配置
193    使用 Docker 时，您仍然需要适当配置 LBBS：
194    
195    1. **配置文件**：按照步骤 6 中的说明创建和自定义配置文件。
196    2. **数据库连接**：确保 `db_conn.conf.php` 指向您的 MySQL 服务器（容器应能访问该服务器）。
197    3. **端口映射**：默认情况下，Docker Compose 映射：
198       - SSH 端口：2222 → 22（容器）
199       - Telnet 端口：2323 → 23（容器）
200      
201       如果需要，请在 `docker-compose.yml` 中调整这些设置。
202    4. **持久化数据**：`data/` 和 `conf/` 目录作为卷挂载以实现持久化。
203    
204    ### Docker Compose 管理
205    - 启动：`docker compose up -d`
206    - 停止：`docker compose down`
207    - 查看日志：`docker compose logs -f`
208    - 重启：`docker compose restart`
209    
210    有关更多详细信息，请参阅 `docker-compose.yml` 文件和 Docker 文档。

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