BBS支持ipv6的说明.doc

BBS支持ipv6的说明1 采用Firebird BBS 2000和NJU 0.9 (web)建立IP6BUPT论坛: 2 已完成:支持ipv6地址有待完成:“环顾四方”时对128位ipv6地址显示的位置可能不够共享内存的问题web方式的“环顾四方”显示的ip地址有错误3 在修改原来Firbird BBS 2000和NJU 0.9源代码的基础上，本BBS可支持ipv6,即远端ipv6主机可通过telnet或web方式登录到本BBS上4 注意：必须安装支持ipv6的apache2.0.40或以上版本（附上支持ipv6的apache-2.0.40.tar.gz）5 具体的修改后的源代码在附上的bbs.tar里面6 改动的主要地方是在bbssrc/src/bbsd.c 中，有注释说明7 具体使用方法 客户端： 有v6地址-没问题 没有v6地址-按如下步骤配6in 4的地址：1. 下载附上的tunnel6in程序2. 用notepad打开程序，将30，改为你的ipv4地址3. 运行程序，你将得到一个6in 4的v6地址,访问：/，你将看到你的ipv6地址 服务器端安装：a) tar xvf bbs.tarb) 从bbs/bbssrc/src安装bbs 具体步骤如下: l 建立 BBS 的相关帐号 在安装 BBS 之前，请您先在系统中加入以下使用者。步骤是：用 root 登陆入系 统，使用 groupadd 命令，为系统创建一个专门用于 bbs 的组用户 bbs 。命令 是 rootbbs /root# groupadd -g 999 bbs 然后再建一个 bbs 用户。命令是 rootbbs /root# adduser -u 9999 -g bbs bbs 建立后，即表示用于 bbs 的用户名是 bbs ，用户 ID 是 9999 。然后你还要为 bbs 用户设置密码，命令是： rootbbs /root# passwd bbs 然后再修改 /etc/group 文件，将 bbs 加入到 bbs:x:999: 的后面，使之成为 bbs:x:999:bbs 。（新建帐号的步骤会因系统不同而有差异，请您在建立帐号之 前参考您的系统管理手册。采用 UID 9999 的原因是为了避免与一般使用者的 UID 产生冲突） 一般建立好新帐号后，可以在 /etc/passwd 中看到以下的内容： bbs:x:9999:999:/home/bbs:/bin/bash 目前 FB2000 已经废除 bbsrf，所以不必再开两个 bbs、bbsuser 两个帐号，只 需一个帐号( bbs )即可。 bbs 是专门用于修改程序的系统帐号。 为 bbs 的源程序创建两个目录 bbssrc , bbs： rootbbs /root# mkdir /home/bbssrc ; mkdir /home/bbs rootbbs /root# chown bbs.bbs bbssrc bbs 以上操作均是以 root 身份执行的。 l 设定及安装 BBS 1.手动设定 以 bbs login，编辑 bbssrc/include/functions.h，这个档定义了一些 bbs 的 重要功能，您可以视需要打开或关闭。目前 FB3 预设使用 bbsd，bbsrf 则已经 废除。 2.自动设定系统环境及填写主要 BBS 资料 同样以 bbs login，到 bbssrc/ 目录底下执行以下指令： % ./configure 执行的过程应类似以下画面： . Please fill data for your BBS 请填写与贵站相关的 BBS 数据. . Home directory of BBS - /home/bbs = bbs 目录所在 UID of BBS - 9999 = bbs 的系统 UID USER of BBS - bbs= bbs 的系统帐号GID of BBS - 999 = bbs 的系统 GIDGROUP of BBS - bbs= bbs 的系统组 The ID of your site - IPv6BUPT = 贵站的英文代号 The name of your site - IPv6BUPT = 贵站名称 (中文可) The domain name of your site - = 贵站 domain name The IP address of your site - 32 = 贵站 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 时间 Use DLM ? - Y= 使用动态连接模块Make bbs users invisible (-DINVISIBLE) ? - N = 是否不写入系统 utmp 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 系统升级到 FB2000，在这里您别无选择，必须使用 DES，没安装的话， 请先安装 DES 後，再执行 configure。 程式会自动判断您所用的系统，并且询问您所架设的 BBS 之基本资料，以造出必 要的 Makefile。顺利的话，您应该可以在 bbssrc/ 目录底下找到刚打造出来的 Makefile。您可以观看此档的设定，若有必要，可手动修改之。 在 bbssrc/include 下亦可找到 config.h 这个档，在编译程式之前您亦可对它 作一些手动的修改。同一个目录下可找到 chat.h 这个档, 您可以在此更改聊天 室的名称和 port number。 还有一个要注意的地方，在 bbssrc/src/Makefile 中，有个 EXTRADEF 的定义， 您可以在最後面加上 -DWITHOUT_ADMIN_TOOLS，这样就不会编译 SYSOP 会用到的 系统管理程式，可以节省记忆体，对大型 BBS 本功能尤其有效。 3.编译 BBS 程式 以 bbs 登入，在 bbssrc/ 下执行如下指令： bbsbbs bbs$ make 进行编译动作。编译过程无错误的话，bbssrc/src 目录底下应该会产生 bbsd(或 bbs), chatd 以及 thread 几个执行档。这几个档案都已产生的话，代表 BBS 程 式的编译已经完成。 如果因为任何 error 导致 BBS 程式无法产生的话，请先检查安装程序是否有错 误，然後重新。若无法解决，可将编译过程产生的讯息张贴至快意灌水站 BBSdev 板求助。 4.安装 BBS 程式 以 bbs login，在 /home/bbssrc 目录底下执行： # make install 即可大功告成。请继续测试您刚架设完成的 站。 l 测试 BBS 程式及错误的排除 1.测试前准备 执行： rootbbs /root$ /home/bbs/bin/bbsd 2000 这里的 2000 是指你的 BBS 端口号。即 port .别人访问你的 BBS 时， 就可以通过 telnet your.server.id 2000 来连接你的 bbs 。 当然，port 可以随意用您喜欢的 port ，若您要用 port 23，请先关掉系统原有的 telnetd，关掉 telnetd 的方式请参考的说明文件，否则可以跳过此节。 如果您要使用系统原有的 port 23 ，你必须关掉系统原有的 telnetd， 如果您要直接使用 bbsrf，请跳到 2 。关掉 telnetd 的步骤是：(全部是以 root 的身份执行) 1).修改 /etc/inetd.conf，寻找以下的字串： telnet stream tcp nowait root /usr/libexec/telnetd telnetd 把该行改成： telnet1 stream tcp nowait root /usr/libexec/telnetd telnetd 因作业系统不同，您看到的设定可能与上述设定不尽相同，请把 握一个原则，就是在第一个 telnet 後面加上 1 就对了。 2).接著修改 /etc/services，在适当位置加上： telnet1 2300/tcp # previous in.telnetd daemon 这行设定将您旧的 telnetd port 设到 2300，您可以自行修改您 喜欢的 port 数字，建议往後面设，如 54321。 又：由于你将系统的 telnetd 端口 设成了其他的 number ，那么 缺省的 telnet 将使用 port number ，如果你使用 telnet 登陆 其他使用 23 port 的主机时，你需要人为地加上对方主机使用的 port 。如：登陆快意灌水站：telnet 58 23 3).执行以下指令，找出 inetd 的 PID： rootbbs /root$ ps -ax |grep inetd 接著执行以下指令，就可重新起动 inetd (或重开机也可)： rootbbs /root kill -HUP (PID) 2.测试并取得 SYSOP 权利 在你的系统的 shell 里使用 telnet localhost port 登陆到你的 bbs 中。应该 可见到 BBS 的进站画面。此时，当 BBS 程式要求您输入代号时，请输入 new， 以便注册一个新使用者。由於名称为 SYSOP 的使用者拥有一切权利，因此您必须 先注册 SYSOP，并且设定密码。 【注意】：SYSOP 必需完全为大写字母。 请注意：如果你登陆 SYSOP 帐号只能在你的 bbs 主机上（或登陆到 bbs 主机 上），使用 telnet localhost port 来登陆。否则会得到一个警告,并禁止登陆，您如果不希望这样，您可以在 /home/bbssrc/include/functions.h 中屏蔽该功能。 接下来，请再注册 guest 帐号，此帐号为 BBS 的参观帐号，不须输入密码即可 进入 BBS(注册时随便打个密码即可)。如果您不想提供 guest 帐号，可以略过此 步骤，并记得把 guest 加入 不可注册之ID 的名单内。若您提供了 guest 帐 号，请参考稍後的文件说明替 guest 设定恰到好处的权限。通常 guest 帐 号是只能参观不可发言的，因此通常不具有发表文章或聊天的功能。 3.错误的排除 如果天不从人愿，程式一声不响地结束了，请您以 bbs 登入系统，执行 ipcs 指 令，查看 shared memory, SHM 的使用情形与 owner 是否正确，正常的 owner 应该是 bbs，如果不是的话，请利用 ipcrm 清除之，然後重新执行 bbs。通常此 类误会有 Error! shmat error! key = ooxx 的讯息。 若还是不行，请检查 bbs/etc 中是否有 menu.ini sysconf.ini 这两个档案， 内容是否完整。如果完整的话，请试著删除 bbs/sysconf.img 档案，再重新进 入 BBS 测试。 如果还是不行的话，请试著清除整个 BBS 系统，重新开机後再安装几次试试。如 果真的没有办法，请到 的 BBSdev 讨论区求助，或者给 写信。 l 设定 BBS 的相关档案 以下介绍主要的设定档, 以便使用者架出一个符合自己要求的 BBS 1 修改系统设定档 修改 bbs/etc/sysconf.ini 以下分别说明 sysconf.ini 中选项的意义 # comment EMAILFILE = etc/mailcheck -如果把这行前面加上 # 就不寄身份确认信 #NEWREGFILE = etc/newregister -如果把这行前面 # 拿掉就有新手三天限制 PERM_BASIC = 0x00001 - 以下为一些权限的定义, 将在 menu.ini PERM_CHAT = 0x00002 中使用(请小心修改以免造成问题) PERM_PAGE = 0x00004 . PERM_SPECIAL6 = 0x8000000 PERM_SPECIAL7 = 0x10000000 PERM_SPECIAL8 = 0x20000000 PERM_ESYSFILE = PERM_SYSOP,PERM_WELCOME,PERM_ACBOARD 拥有修改部份/全部系统档的权限 PERM_ADMENU = PERM_ACCOUNTS,PERM_OVOTE,PERM_SYSOP,PERM_OBOARDS, PERM_WELCOME,PERM_ACBOARD,PERM_DENYPOST 可看到并使用管理者选单 PERM_BLEVELS = PERM_SYSOP,PERM_OBOARDS PERM_UCLEAN = PERM_SYSOP,PERM_ACCOUNTS AUTOSET_PERM = PERM_CHAT, PERM_MESSAGE, PERM_PAGE, PERM_POST, PERM_LOGINOK 设定身份确认通过的使用者可得到的权限 #include etc/menu.ini 注意！修改完 sysconf.ini 後，请至 BBS 主选单按 Shift + 或者砍掉 bbs/sysconf.img，以便更新系统设定。 2 修改 BBS 的选单 1.加入背景：在每个选单背後都有一个背景，以主选单为例，它的背景就是由 screen 这行所指定的 S1_MAIN 所决定： #- %S1_MAIN 这里是背景 我是可爱的哲哲! 我好帅喔! % #- 在 %S1_MAIN 与 % 中的文字都会被当成背景印出. 2. menu.ini 内各设定的意义 (以主选单为例) %menu TOPMENU screen 3, 0, S1_MAIN 指定用那个背景 title 0, 0, 欢迎光临靠边站(Coba BBS) 这是每个选单都 欲印出的座标 有的标题 !M_EGROUP 3, 0, 0, EGroup, E) 分类讨论区 不限权限皆可用 从 (3,0) 开始印 !M_MAIL 0, 0, PERM_BASIC, Mail, M) 私人信件服务 要有 BASIC 权限才看的到这个选项 跳到 M_MAIL 选单 !M_TALK 0, 0, PERM_BASIC, Talk, T) 进入聊天选单 (0,0)表接著上行印 #!M_INFO 0, 0, PERM_BASIC, Info, I) 设定个人资料 这行前加了个 # , 代表拿掉这行 以上只简介了大致上的设定方法，详细可使用的功能请参考 bbsroot/bbssrc/bbshome/etc/menu.ini 的档案，对照修改您 现在使用的 menu.ini。 注意！修改完 menu.ini 後，请至 BBS 主选单按 Shift + 或者砍掉 bbs/sysconf.img，以便更新系统设定。 l 开板及建立精华区 1.开板及分类讨论区 刚建好的 BBS 除了预设的讨论区外，什麽讨论区也没有，站长可以视使用者需要 开启适当的讨论区，同时为了 BBS 使用者找寻讨论区方便起见，必需将相关的讨 论区分类在同一个群组中(Group)，讨论区群组的设定请见 bbs/etc/menu.ini， 以下是参考的设定： title 0, 0, 分类讨论区选单 screen 3, 0, S_EGROUP BoardsNew 11,25,0, New, N) 阅读新文章 New EGroups 0, 0, 0, 0BBS, 0) BBS 系统 - 站内 .(略). .(略). .(略). .(略). EGroups 0, 0, 0, 6Sports, 6) 体育健身 - 运动 职棒 EGroups 0, 0, 0, 7Talk, 7) 物理专业 - 中国物理协会 BoardsAll 0, 0, 0, Boards, B) 所有讨论区 !. 0, 0, 0, Exit, E) 回到主选单 % EGROUP0 = 0 . EGROUP6 = rs - r s 为分类码, 开板时会用到, r 与 s 皆定义为 EGROUP6 EGROUP7 = xf EGROUPT = * 请特别注意分类选单的 0) 将会分到 EGROUP0 , 6) 将会分到 EGROUP6. 开启新板的方式是到主选单下选 A)系统管理功能表 的 N)开启新的讨论区，第 一个建立的板必需为 sysop(安装时已预先建立好)，请如下输入： 讨论区名称: sysop - 填入讨论区的英文板名 讨论区说明: 0站内 站务管理区 讨论区说明的第一个字为分类码(定义於 menu.ini), 以此 0 为例 ，将会分至 EGROUP0，也就是 0) BBS 系统 - 站内，其馀部份 的讨论区说明请按此形式填写，以免到时板面排的不好看。 讨论区管理员: SYSOP - 指定讨论区的 BM 是否限制存取权利 (Y/N) ? N: n -指定只有某些权限者才能存取此板 是否加入匿名板 (Y/N) ? N: n -是否为匿名板 1. 本站系统 system.faq 2. . . 14. 其他 other.faq 请输入你的选择:1 - 选择精华区要放那 ? 以後可再调整位置 已经置入精华区. 新讨论区成立 2. 建立精华区 使用者在讨论区按下 x 键便会跳至该讨论区的精华区，要达成此功能必须要正确 设定 bbs/0Announce/.Search 档案内容， 在一般情况下，您不用手工来设置它， 如果确有变动，则修改该文件。该文件可能的内容如下： linux: Linux installbbs: Linux/bbs sysop: sysop . . 其中冒号前代表 board name，後面的代表对映的目录名例如：在 installbbs 板 按下 x 时，FirebirdBBS 就会去找 bbs/0Announce/Linux/bbs 下的精华区。 正常开板时即会自动写入此档，平常无需自加，但如果精华区目录有更动时，请 记得修改此档。 l BBS 目录下档案说明 以下说明在 bbs 目录下各重要档案的功能，请详加阅读以便能更掌控贵站的正 常运作。 Part I.主要资料档案 1.BBS_HOME/.PASSWDS 存放每位使用者的基本资料，宣告 struct userec。 欲观看此档内容, 请参考前面的说明。 2.BBS_HOME/.BOARDS 存放讨论区的基本资料，宣告 struct boardheader，里面有一个 element.flag 是用来存放讨论区的状况 3.BBS_HOME/Welcome Welcome.rec 进站後的欢迎画面，和记录读取情况。可直接用编辑器修改 Welcome 的内容, 注意!只有当 Welcome有更新过时, 使用者才会看到。 4.Welcome2 与 Welcome 类似, 但每次进站都会看到, 且允许有多重画面, 以 login 彼此隔开。 5.BBS_HOME/home/A-Z 存有各个使用者的目录，并依照使用者 ID 的第一个字来分类排放： 例如：SmallPig 使用者的目录就放在 BBS_HOME/home/S/SmallPig， wildwolf 使用者的目录就放在 BBS_HOME/home/W/wildwolf。 6.BBS_HOME/boards 里面存有各讨论区的 directory。 7.BBS_HOME/vote 里面记录各讨论区的投票控制档，以及讨论区简介。 8.BBS_HOME/0Announce 里面记录精华区资料。 9.BBS_HOME/etc 系统控制档案。 10.BBS_HOME/help 各控制键说明文件档案。 Part II.使用者目录 BBS_HOME/home/A-Z/USERID/* 1.friends 记录好友名单，宣告 struct friend 。 2.logout 使用者自订离站画面。 3.maillist 寄信给一群人列表。（目前已删除） 4.notes 个人备忘录。 5.plans 个人说明档。 6.signatures 签名档。 7.mailcheck 身份确认暂存档。 8.register 身份确认记录档。 Part III.投票目录 BBS_HOME/vote/BOARDNAME/* 1.notes 讨论区介绍(备忘录)。 2.noterec 记录讨论区读取情况。 3.control 投票控制档。 4.desc.? 投票描述。 5.flag.? 使用者投票记录。 6.results 投票结果。 7.secnotes 秘密备忘录。 Part IV.系统控制档案 BBS_HOME/etc/* 1.anonymous 匿名板名单(目前已移至 bbssrc/include/config.h 中控制) 2.autopost 每日系统自动 Post 列表。 使用法如下: 在 autopost 档中填入以下内容 /home/bbs/0Announce/bbslist/board1 bbslists 讨论区使用率(图) 欲自动张贴的档案名 张贴至何板 张贴时用的标题 自动张贴的原理是当有使用者上站时，去检查 bbs/etc/checknotepad 内存的时 间，是否距离上次自动张贴已经过 24 小时，是便自动张贴，否则不动作。 3.boardref 站长开板时所用的参考文件。 4.checknotepad 记录留言板与自动 Post 的时间记录。 5.f_fill 填写注册单失败的 mail 内容。 6.s_fill 填写注册单成功的 mail 内容。 7.firstlogin 新手上路将阅读的文件。 8.fmail 身份确认失败的 mail 内容。 9.smail 身份确认成功的 mail 内容。 10.goodbye login 三次错误的画面。 11.issue 进站前的画面。 12.junkboards 不记文章数的板。 只要板名列入 junkboards，BBS 使用者在此板发表的文章均不列入个人张贴文章 数统计，适合用於灌水板或匿名板等。 13.mailcheck 身份确认寄出信件的内容。 请务必修改此档内容，以免使用者收到确认信还莫名其妙。 14.menu.ini 选单控制档。 一些需要使用外部程式的选项在一开始是被 # 符号 mark 起来的。倘若您已安装 好相关外部程式，可将其在 menu.ini 前面的 # 去掉，存档後按 Shift + 或 把 /bbs/sysconf.img 砍除，则该选项随後就会在选单中出现了。 15.sysconf.ini 系统控制档。 16.newregister 注册说明档。 17.notepad_tmp 使用者留言暂存处。 18.notepad 留言板。 19.sysops 站长列表。 请在此档中加入站长的 ID 及职称，例如： wildwolf 系统管理 aci 站务管理 当使用者有建议时，便可在离站时选择适当职务的管理者，留信给他。 20.user_full 注册人数已满。 21.loginfull 上站人数已满。 22.register 新使用者注册帐号之辅助画面。 23.logout 离站画面。 离站画面可使用多个，只要中间以 logout 隔开即可，请bbssrc/bbshome/ete/ logout 的范例。 24.wmail 退信讯息档。 当认证信被退回时，系统将会以此封信内容告知使用者。 25.whatdate 纪念日清单。 可以在这里面设定特别的日子并加以描述，当天 BBS 将会将该日子的描述显示在 画面下方。注意！字与字之间请勿输入空白，若发现显示错误或输入错误而要更 改，需重新开机方可生效。 26.expire.ctl expire(post) 程式设定档。 这个档案用来设定各板面保留文章的天数，上限及下限等。 Part V.讨论区目录 BBS_HOME/boards/BOARDNAME/* .DIR 文章资料档。 .DIGEST 文摘资料档。 .THREAD 同标题模式文章资料档。 M.123456789.A 文章。 5 活动看板的设定与使用 FB 3.0 的活动看板采用新的机制，活动看板的内容来源从 notepad 板中的文摘 (也就是被 g 起来的文章) 中选录。活动看板的宽度也从五行改成七行，您可从 include/functions.h 设定是否加大活动看板为七行)。 当您安装一套新的系统时，预设在 notepad 板安装了三个活动看板。您可以自行 修改，增添。如果你是 FB 3.0 0614-SNAP 之前的 FB3 使用者，请先清除 movie 的 shared-memory (shm key: 30030)，因为更动到相关的资料结构，若不清除则 上站会被踢出。 新增一个活动看板很简单，只需要发表一篇文章在 notepad 板，然後去把那个文 章给收录文摘(在文章之前按一下 g)，然後重新上站，你可以发现 bbs/trace会 纪录活动看板更新的讯息。此後，只要 notepad 有新增或删除文摘的话，就会自 动更新活动看板。 本来程式在收录活动看板时会自动跳过 4 行的档头，然後才抓取 7 (或 5) 行 的资料来做为活动看板的内容，在这里你可以在活动看板的文章标题上，来控 制程式从这个档案的第几行开始收录成为活动看板，你只要将标题的第一个字 元改成 $，然後第二个字元设成你所想要的行号(09)。 Ex: $0 /home/bbs/reclog/uptime.log 57 * * * * /home/bbs/bin/averun /home/bbs/reclog/uptime.log;/bin/rm /home/bbs/reclog/uptime.log 56 0 * * * /bin/mv /home/bbs/0Announce/bbslist/today /home/bbs/0Announce/bbslist/yesterday; /bin/rm /home/bbs/reclog/ave.src 为方便阅读，太长的命令用 断开，切成两行，实作时请务必写成一行，并 将 拿掉。 再来用 bbs 的身份 login，建立 /home/bbs/reclog 的目录，这个目录是用来存 放累计用的资料，之後再进入 BBS 的精华区，在精华区主目录下，开一个目录叫 bbslist (用 g 功能)，在 bbslist 的目录之下建两个档案，一个叫 today(今日 上站人数统计)，另一个叫 y