maplebbs-clam

experimental fork from maplebbs-itoc ( origin )

for not official patch

Plan

~~improve INSTALL procedure~~ (done)
add “addpost” patch : like ~/bin/post in pttbbs , for porting AutoWeatherBBS project.
add piaip’s BBS patch
- add pmore 2007+ patch
- add pfterm patch
- add BBSLua patch
improve Web surface
make backup-trans mechenism more completelty
make websocket connection work

快速安裝手冊

(encoding: utf-8)

原文件是寫給要安裝 itoc 所維護的 bbs 程式版本所使用的，並不適用其他 bbs 版本。

本 fork 調整調整內容:

source code 擺放的位置移到第一層以方便將 repositoty 改在 /home/bbs 下時做版本控制。

以及嘗試盡可能照原本的壓縮檔呈現補齊目錄格式 (by adding .gitkeep)
若安裝完成後有刪除 .gitkeep 需求請自行用 find 等指令執行

將點歌範本(ktv)與相關安裝手冊(gem)併入現在sample/bbs/裡部分看板的精華區:

ktv -> sample/bbs/gem/brd/ktv (直接取代原本只有一首歌的精華區)
gem -> sample/bbs/gem/brd/admin (直接給有站長權限的使用者參考)

以下安裝方式步驟可能會略有調整。

一、安裝作業系統

本分支在 CentOS 7.3.1611 32bit (AltArch) 下測試過, 目前可以正常運作。
Debian 9 GNU/Linux 下測試目前仍有程式執行上的問題有待解決。

其他作業系統與核心則沒有試過不清楚，這篇也會略過相關部分，轉信設定部分這裡也不會提
對該部分有興趣建議自行按原文件嘗試。

安裝作業系統時就像平常安裝一樣，沒什麼特別要注意的，
唯一要提醒您的是，請安裝 nano vim make gcc git xinetd 等程式套件，因為 bbs 會用到。

二、建立 BBS 帳號

以 root 身分登入。

-root- # mkdir /home/bbs
-root- # vipw

如果您是 Linux 的話，在最後一行加上

bbs:x:9999:999:BBS Administrator:/home/bbs:/bin/bash
(為求保險起見跟 `/etc/passwd` 裡列出其他使用者的格式一樣)

(為求保險起見跟 /etc/passwd 裡列出其他使用者的格式一樣)
(要注意 GID 是否與檔案裡其他提到的使用者重複, 以免出現權限問題)

-root- # vim /etc/group

(假設編輯器是 vim，如果不是的話，請自行改用其他編輯器如 nano、gedit )

如果您是 Linux 的話，在最後一行加上

bbs:x:999:bbs

(為求保險起見跟 /etc/group 裡列出其他使用者的格式一樣)
(要注意 GID 是否與檔案裡其他提到的使用者重複, 以免出現權限問題)

-root- # passwd bbs

輸入管理帳號 bbs 的密碼

-root- # chown -R bbs:bbs /home/bbs

(當然以上新增使用者群組步驟，您也可以用 useradd,groupadd 的指令來完成相同的動作)

記得設定好bbs家目錄的權限, 尤其如果常以root身分從複製資料過去時更要注意.

三、下載 BBS 程式

在這裡可以找到最新的程式版本。

在 bbs 的家目錄(/home/bbs)載下來就對了

-bbs- ~$ git clone https://github.com/holishing/maplebbs-clam

四、安裝 BBS

以 bbs 身分登入，進去 source 目錄 (/home/bbs/maplebbs-clam) 。

-bbs- $ cd /home/bbs/maplebbs-clam

直接執行以下指令，進入設定與自動化安裝程序：

-bbs- $ make init linux install

若之後只是要重新編譯程式按裝, 請勿輸入以上指令, 以免重要資料被覆蓋, 請輸入:

-bbs- $ make clean linux install

如果您是使用其他作業系統環境的話，還要指令裡的 linux 改成其他類型如:
sun solaris sol-x86 freebsd bsd

進入第一個 vim 編輯器畫面(include/config.h)時，請利用 i a o ESC 等指令

修改 HOST_ALIASES，把您所有的 fqdn 都加進去

    #define HOST_ALIASES    {MYHOSTNAME, MYIPADDR, \
        "wolf.twbbs.org", "wolf.twbbs.org.tw", \
        NULL}

如果您是 Linux 的話，另外要再改 BBSGID 為 999 若自己的GID有另外設定, 請自行調整修改

    #define BBSGID          999                     /* FreeBSD 請設為 99 */

另外還要修改校名、站名 … 等數項，例如改成以下這樣 (請參考 sample/sh/install.sh 文件前面的註解，對名稱有些限制)

    #define SCHOOLNAME  "交大電子"      /* 組織名稱 */
    #define BBSNAME     "交大電子"      /* 中文站名 */
    #define BBSNAME2    "AppleBBS"     /* 英文站名 */
    #define SYSOPNICK   "站長大大"      /* sysop 的暱稱 */

    #define MYIPADDR    "140.113.55.66"       /* IP address */
    #define MYHOSTNAME  "nctu5566.dorm3.nctu.edu.tw"   /* 網路地址 FQDN */

確定修改完後, 按下 ESC 後再輸入 :wq 指令完成設定

進入第二個 vim 編輯器畫面(設定 crontab)時, 若無進階需求, 可以直接輸入 :wq 指令完成設定.

之後您需要等待一段時間來完成編譯

如果有相關編譯問題可參考原文件說明或至各 BBS 站 MapleBBS架站相關看板查詢

最後確認是否安裝成功時, 可輸入以下指令:

-bbs- $ sh /home/bbs/maplebbs-clam/sh/start.sh

確認程式是否可以執行

五 (Ａ)、設定 BBS 環境 – 如果有 xinetd

如果沒有 /etc/xinetd.d/ 這目錄，請跳到五（Ｂ），通常 Linux 應該有 xinetd 套件可以安裝才對。
在 CentOS 7.3.1611 32 bit (AltArch) 下可以嘗試用相關指令先行安裝並開啟相關服務

確定安裝完成後

以 root 身分登入。

-root- # vim /etc/xinetd.d/telnet

將這檔案改成此內容 (這檔案有可能原本是沒有任何文字的開新檔案)

service telnet
{
        disable         = no
        flags           = REUSE
        socket_type     = stream
        wait            = yes
        user            = bbs
        server          = /home/bbs/bin/bbsd
        server_args     = -i
}

-root- # vim /etc/xinetd.d/xchatd

將這檔案改成此內容 (這檔案有可能原本是沒有任何文字的開新檔案)

service xchat
{
        disable         = no
        flags           = REUSE
        socket_type     = stream
        wait            = yes
        user            = bbs
        server          = /home/bbs/bin/xchatd
        server_args     = -i
}

-root- # vim /etc/rc.local

加入以下數行 (這檔案有可能原本是沒有任何文字的開新檔案)

    #!/bin/sh
    #
    # MapleBBS
    #
    su bbs -c '/home/bbs/bin/camera'
    su bbs -c '/home/bbs/bin/account'

之後再

-root- # chmod +x /etc/rc.local

這樣開機後 rc.local 才跑得動

五 (Ｂ)、設定 BBS 環境 – 如果沒有 xinetd

沒有 xinetd 或不想用它來啟動，可改用 standalone 啟動。

以 root 身分登入。

-root- # vim /etc/rc.local

加入以下數行 (這檔案有可能原本是沒有任何文字的開新檔案)

    #!/bin/sh
    #
    # MapleBBS
    #
    /home/bbs/bin/bbsd
    #/home/bbs/bin/bmtad   #如果沒要開啟相關服務可忽略
    #/home/bbs/bin/gemd    #如果沒要開啟相關服務可忽略
    #/home/bbs/bin/bguard  #如果沒要開啟相關服務可忽略
    #/home/bbs/bin/bpop3d  #如果沒要開啟相關服務可忽略
    #/home/bbs/bin/bnntpd  #如果沒要開啟相關服務可忽略
    /home/bbs/bin/xchatd
    #/home/bbs/innd/innbbsd #如果沒要開啟相關服務可忽略

    su bbs -c '/home/bbs/bin/camera'
    su bbs -c '/home/bbs/bin/account'

之後再

-root- # chmod +x /etc/rc.local

這樣開機後 rc.local 才跑得動

六、其他設定

以 root 身分登入。

-root- # vim /etc/services

加入以下數行

xchat           3838/tcp
xchat           3838/udp
#bbsnntp         7777/tcp   usenet       #Network News Transfer Protocol #如果沒要開啟相關服務可忽略
#bbsnntp         7777/udp   usenet       #Network News Transfer Protocol #如果沒要開啟相關服務可忽略

-root- # reboot

重開機吧

七、享用您自己的 BBS

您的 BBS 應該已經架好了，試著 telnet 看看，那就這樣好好享用吧。

–

交大電子杜宇軒

[email protected]

WWW: http://processor.tfcis.org/~itoc

–

Adapt by [email protected]