firebird-30

教育网的bbs代码

注： 以下文件乃编改自中正资工 Firebird BBS 2.5 版之使用手册。
$Id: Firebird-30,v 1.1 1999/05/19 16:12:17 skyo Exp $

                                                                        
                           目       录
                                                                        
  
                     (零) 前言

                     (一) 架站前的考量

                          [1] 硬体的准备
                          [2] 网路流量的考量
                          [3] 系统安全的考量
                          [4] 身份确认的重要性
                          
                     (二) 安装 BBS 程式
         
                          [1] 建立 BBS 的相关帐号
                          [2] 取得 BBS 程式
                          [3] 设定及安装 BBS 程式
                          [4] 测试 BBS 程式及错误的排除
                          [5] 其他版本 BBS 升级须知

                     (三) 设定 BBS 的相关档案  

                          [1] 修改系统设定档
                          [2] 修改 BBS 的选单
                          [3] 开版及建立精华区
                          [4] BBS 目录下档案说明

                     (四) 外部工具程式使用
 
                          [1] 简介自动程序
                          [2] 上站人数统计
                          [3] 上站人次统计
                          [4] 上站次数, 发表文章次数, 使用时间排名
                          [5] 十大热门话题统计
                          [6] 讨论区使用率统计
                          [7] 观看 .PASSWDS 的程式 -- showuser.c
                          [8] 自动 login BBS 帐号安装
                          [9] BBSnet, Lynx, Archie client ,IRC..etc安装

                     (五) 寄信给 BBS 站内使用者及 E-mail Post 安装

                          [1] 身份确认信处理的流程
                          [2] 如何修改系统使 BBS 站内 User 能收到 Intermail
                          [3] E-mail post 安装及使用    

                     (六) 转信程式 INNBBSD 的安装 
                        
                          [1] 安装转信程式
                          [2] 设定转信所需的设定档
                          [3] 申请转信的方法
                          [4] 叁考文件 [已知 News Server 列表]

                                        
                                                                        
                      第 零 章  前言  
                                                                        

    本版乃中正资工 Firebird BBS 的一个 variant,由 Firebird Power User
    Group（一群愿意继续维护 Firebird 程式的人组成）结合 FB 2.66m 和 
    Seednet BBS 所发展出来的版本, 为秉持 GNU 软体开发精神而开放给大家
    自由拷贝使用、修改。

    本版作者的风格与习性也许跟原版 Firebird BBS 的作者略有不同, 固一些原
    Firebird BBS 所拥有的小功能并没有被纳入, 且又增加了一些原版 Firebird
    BBS 所没有的功能。 比较重要的一点是, 我们尝试修正了一些存在於原版
    Firebird BBS 上的小错误。

    本版开放让大家抓取, 其目的在於希望能让各 Firebird 系列的站台互相交流, 
    集思广益, 一齐来叁与发展, 使 Firebird BBS 在研发方面做得更加的尽善尽美。

    本版在 GNU Public Licence 下发行, 各位可任意拷贝及修改。但是我们有个
    小小的要求, 就是若您对它作了一些修改, 或修正错误, 或添加功能, 请在
    firebird 连线版上 post 出您改过的地方, 好让大家也能分享您的成果。 与
    您分享的快乐, 胜过独自拥有, 这是本版发行的目的。


                                                                        
                      第 一 章  架站前的考量  
                                                                        


 [1] 硬体的准备
     
     足够的记忆体及 SWAP 是影响上站人数上限的关键, 硬碟的大小则影响到
     各版文章能保留篇数的多少, 在架站前需衡量所需配备。 据观察, 一台
     具有32MB 记忆体的 Linux station 在 BBS 人数达 50 人左右时开始会
     用 SWAP。 (Linux 作业系统在记忆体不足的状况下才会用 SWAP)
     
     因为 BBS 的档案多以信件, 讨论区文章为多, 这些都是 1k ~ 2k 的小档
     案, 所以系统的档案结构每个 inode 以 1k 或 2k 为佳 , 您可以下 df -i 
     指令观察目前 inode 的使用状况。 inode 的大小通常是在 newfs 时选择
     的。


 [2] 网路流量的考量
 
     当您的 BBS站公开给外界使用以後，通常会遇到以下麻烦：
      
     如果有大量使用者透过网路连接您的 BBS，会对您们当地的网路造成「有
     点大，又不会太大」的网路交通量。
   
     ==> 对策：统计网路交通流量，了解 BBS系统对网路的影响程度，以调整
               BBS的管理策略。

   
 [3] 系统安全的考量

     由於 BBS站是一般 cracker觊觎的对象之一，因此设立 BBS站之後，容易
     让您的工作站成为显着的入侵目标。
   
     ==> 对策：请更加注意您的系统安全，尤其当执行外部程式(gopher,lynx
               tin,....etc)务必确定程式是否有执行上的漏洞, 或者寻找修
               改过专为 BBS 用的版本,并请勤於修补作业系统的漏洞。

   
 [4] 身份确认的重要性

     除非您的 BBS站是封闭式的 BBS（也就是使用者必须经过严格的申请程序
     才能拥有帐号），否则请注意匿名使用者的问题。匿名使用者的言责问题
     一直是网路上争议的论点之一，因此请您在开站之前考虑您的做法。
   
     ==> 对策：确认使用者身份以後才给予发表文章的权利，而且规定使用者
               身份只能透过系统管理员查询。如此即可适度保障使用者隐私
               权、又可在发生问题时追查责任的归属。


                                                                        
                      第 二 章  安装 BBS 程式  
                                                                        


 [1] 建立 BBS 的相关帐号
     
     在安装 BBS 之前，请您先在系统中加入以下三位使用者，在 /etc/passwd
     内应该如下所示：（新建帐号的步骤会因系统不同而有所差异，请您在建
     立帐号之前叁考您的系统管理手册。采用 UID=9999 与9990的原因是为了
     避免与一般使用者的 UID 产生冲突）

     一般建立新帐号的步骤是在 /etc/passwd 中加入下三行，然後再为 bbsadm 和
     bbsuser 这两个帐号设好密码, 而 bbs 这个帐号一般上是不设任何密码的: 

       bbsadm::9990:99:BBS admin and developer:/home/bbsadm:/bin/csh
       bbs::9999:99:BBS user:/home/bbs:/home/bbs/bin/bbsrf
       bbsuser::9999:99:BBS user:/home/bbs:/bin/csh

     ※请务必把 bbs 的 entry 放在 bbsuser 之前，以避免一些不必要的困扰。

     其中 bbsadm  是用来修改 /home/bbsadm/bbssrc 下的 BBS 程式。
          bbsuser 跟 bbs 拥有相同的 UID，但它的 shell 是一般的 shell，
                  而 bbs 的 shell 则是 bbsrf。 当系统需要 bbs 以一般的
                  shell 来作处理时, 便需要有这个帐号了。

     此外, 在 /etc/group 内设定 bbs 的 group，如下所示：

     bbs:*:99:bbs,bbsuser,bbsadm

     以方便您管理目录的读写权限。
  
     并在 /etc/shells 中加入 /home/bbs/bin/bbsrf 。
   
     以上都设定完成後,在 /home 建立 bbsadm 和 bbs 两个目录, 并 
     chown bbsadm.bbs bbsadm ; chown bbs.bbs bbs
     再分别替 bbsadm bbsuser 设定密码。


 [2] 取得 BBS 程式
     
     请以 bbsadm login ,再抓取 BBS source , 本版的 BBS source 
     可由以下位址取得

     ftp://ftp.frirebird.dhs.org/pub/Firebird/FirebirdBBS3.0.tar.gz
     ftp://ftp2.firebird.dhs.org/pub/Firebird3.0_BBS/Firebird3.0.tar.gz

     取回後,解开 FirebirdBBS 3.0 的原始程式，以进行安装程序。
     解开 FirebirdBBS3.0.tar.gz 的方法:

     tar zxvf FirebirdBBS3.0.tar.gz

     程式解开之後，会在你所在目录底下造出 bbssrc 目录，内含 BBS的原始
     程式。
      
     (注）如果您的 tar 不认得 zxvf，请利用 anonymous ftp 至
          ftp.csie.nctu.edu.tw 取回 /pub/GNU/gzip-1.2.4.tar与 
          /pub/GNU/tar-1.11.2.tar.gz，并且安装至您的系统上。


 [3] 设定及安装 BBS 

     1.自动设定系统环境及填写主要 BBS 资料
   
     同样以 bbsadm login , 到 bbssrc/ 目录底下执行以下指令
      
      ( ./configure )
      
     执行的过程应类似以下画面：

 ..................................
   Please fill data for your BBS
 ..................................
Home directory of BBS --> [/home/bbs]                   ==> bbs 目录所在
BBS Source Code directory --> [/home/bbsadm/bbssrc]     ==> bbs主程式目录
UID of BBS --> [9999]					==> bbs 的系统 User ID
GID of BBS --> [99]					==> bbs 的系统 GID
UID of BBS admin --> [9990]				==> bbsadm 的系统 UID
The ID of your site --> [NoName]                        ==> 贵站的英文代号
The name of your site --> [火鸟系统 3.0]                ==> 贵站名称 (中文可)
The domain name of your site --> [some.where.on.earth]  ==> 贵站 domain name
The IP address of your site --> [127.0.0.1]		==> 贵站 IP address
The Default board of your site, only change it if upgrading
from old system with different default board --> [sysop]==> 预设板
Maximum number of users --> [20236]			==> 最大使用人数
Maximum number of boards --> [256]			==> 开板最大数目
Maximum number of on-line users --> [256]		==> 最大同时上线人数
Show idle time of BBS users ? --> [Y]			==> 显示 idle 时间
PLEASE CHOOSE THIS CAREFULLY
Is libcrypt "DES" correct? --> [Y]                      ==> 密码编码方式
........................................
updating cache ./config.cache
creating ./config.status
creating Makefile
creating config.h
creating Install.sh

........................................................................
You may review the Makefile now. Then, type 'make' to build your system.
........................................................................

     在设定一些数值时请确切考虑您的硬体设备是否足够。 特别是最大同时上线
     人数，它是与记忆体的大小非常有关的。

     另外，如果您使用 FreeBSD，请注意您系统的密码编码方式是 MD5 还是 DES；
     若您从旧 BBS 系统升级到 3.0，在这里您别无选择，必须使用 DES，没安装的
     话，请先安装後，再执行 configure。

     程式会自动判断您所用的系统，并且询问您所架设的 BBS之基本资料，以
     造出必要的 Makefile 。 顺利的话，您应该可以在 bbssrc/ 目录底下找
     到刚造出来的 Makefile。 您可以观看此档的设定，若有必要，可手动修改
     之。

     在 bbssrc/include 下亦可找到 config.h 这个档，在编译程式之前您亦可对
     它作一些手动的修改。

     同一个目录下可找到 chat.h 这个档, 您可以在此更改 chat room 的 port
     number 和名字。

	 还有一个 functions.h 档, 这个档可以打开一些非必要的选项功能, 在该档里
	 都有说明. 只需要拿掉 #define 前面的 // 就可以开启该功能了

     2.编译 BBS 程式
     
     在 bbssrc/ 下执行如下指令  

      make

     进行编译动作。如果编译过程无错误的话，bbssrc/src 目录底下应该已经
     产生 bbs, bbsrf, chatd 以及 thread 这四个执行档。如果这四个档案都
     已产生的话，代表 BBS 程式的编译已经完成。

     如果因为任何 error 导致 BBS 程式无法产生的话, 请检查安装程序是否
     有误。若无法解决, 可将完整编译过程产生的讯息张贴至各大站 firebird
     版或 installbbs 版求助。  
     
     3.安装 BBS 程式

     以 root login , 在 /home/bbsadm/bbssrc 目录底下执行

      make install

     即可大功告成。请继续测试您刚架设完成的 ＢＢＳ 站。


 [4] 测试 BBS 程式及错误的排除
     
     1.测试ＢＢＳ并取得 SYSOP 权利

     Telnet 到您的 BBS 主机，然後以 bbs 当 username 来 login , 应可见
     到 BBS 的 login 画面。此时，当 BBS程式要求您输入代号时，  请输入 
     new，以便注册一个新使用者。由於名称为 SYSOP 的使用者拥有一切权利
     ，因此您必须先注册为 SYSOP，并且设定密码。请注意：SYSOP 必需完全
     大写。

     接下来，请再替  guest 登记帐号，此帐号为 BBS的叁观帐号，不须输入
     密码即可进入 BBS(注册时随便打个密码即可)。如果您不想提供 guest帐
     号，可以略过此步骤，并记得把 guest 加入 "不可注册之ID" 的名单内。
     如果您提供了 guest  帐号，请叁考稍後的文件说明替 guest  设定
    「恰到好处」的权限。通常guest 帐号是只能叁观不可发言的，因此通常
     不具有发表文章或聊天的功能。
   
     2.错误的排除
   
     如果天不从人愿，程式一声不响地就结束了，请您先以 bbsuser login，
     在 ~bbs 的目录底下执行「 bin/bbs h localhost」，看看能不能执
     行。如果 bbs可以执行的话，那应该是  ~bbs/bin/bbsrf  出了问题，请
     检查bbsrf 程式之 owner与 mode ，如果您自行使用 chroot 安装选项的
     话，请确定 owner为 root.bin 且 mode 为 4755。
   
     如果不是这个情形，请执行 ipcs 指令，查看 shared memory 的使用情形
     与 owner 是否正确，正常的 owner 应该是 bbs，如果不是的话，请利用
     ipcrm 清除之，然後重新执行 bbs。
     通常以上错误会有 Error! shmat error! key = xxx. 的讯息.
   
     再不行的话，请检查 ~bbs/etc 中是否有 menu.ini sysconf.ini 这两个
     档案，内容是否完整。如果完整的话，请试着删除 ~bbs/sysconf.img 档
     案，再重新进入 BBS测试。
   
     如果还是不行的话，请试着清除整个 BBS 系统，重新开机後再安装几次试
     试。如果真的没有办法，请到 tw.bbs.admin.installbbs  讨论区求助，