Skip to content

INSTALL

Jump to bottom
holishing edited this page Jan 7, 2018 · 8 revisions

PttBBS 初步架站手冊

以下內容僅參考 docs/INSTALL 裡附的說明

若有任何需要補充與修正的地方歡迎直接修改 :)

０. 安裝作業系統

目前 Linux (如：Debian、Ubuntu) 、FreeBSD 等平台於近期(2018年)測試過可以運行大部分功能

在這裡的記錄用的 Linux 發行版本, 則會採用目前仍算主流的 Ubuntu 作業系統

詳細版本為：Ubuntu 16.04.2 Desktop 32bit (下載時須注意先不要下載成 64bit 版本的)

而關於各作業系統(發行版)的安裝方式，請參考相關論壇搜尋教學資訊.

１. 建立 bbs 、 bbsadm 帳號

以 root 的權限

在 Linux 裡，不是直接登入 root 帳號，就是在自己主要會用的帳號開啟 terminal

( Ubuntu 在工具列展開後顯示的搜尋列輸入 terminal 即可找到該程式 )

輸入 sudo su - 再打自己密碼後，即可獲得該權限。

先取得 root 權限

  1. 打 vipw, Ubuntu 下加入底下兩行，其他作業系統請自行參考相關說明格式
    bbs:x:9999:99:PttBBS,,,:/home/bbs:/home/bbs/bin/bbsrf
    bbsadm::9999:99:PttBBS,,,:/home/bbs:/bin/bash

  1. 執行 passwd bbsadm 設定 bbsadm 的密碼

  2. 執行 nano /etc/group，Ubuntu 下加入底下一行，其他作業系統請自行參考相關說明格式

    bbs:x:99:
  1. 執行 mkdir /home/bbs
  2. 執行 chown bbs:bbs /home/bbs
  3. 執行 chmod 700 /home/bbs
  • 建議先用
sudo apt-get install git

指令安裝 git套件 ，或自行再用 apt-get等指令檢查自己有沒有安裝過

３. 取得 PttBBS 原始碼

接下來步驟請切換到作業系統中的 bbsadm 帳號進行，

對於相關編輯器設定熟悉的人請直接 su - bbsadm 即可

若剛接觸 Linux 等相關作業系統者，也可在圖形介面登出後登入名為「PttBBS」的帳號

以下用 bbsadm 的身分

您可以透過下列方式下載到 OpenPtt 的程式碼: https://github.com/clamtestbbs/openptt

    git clone https://github.com/clamtestbbs/openptt

執行過程大致如圖：

  • 原始未經任何修改的源碼請自行至 http://openptt.sourceforge.net 取得

  • 您可以在該目錄下直接透過 git pull 更新至 openptt 較新的修改. 如:

    cd /home/bbs/openptt; git pull; git rebase
  • 如果您的 pttbbs.conf並不存在, 可以拷一份預設的來用:
    cd /home/bbs/openptt; cp sample/pttbbs.conf pttbbs.conf

４. 修改 pttbbs.conf

依據您的須求, 修改 pttbbs.conf

這時候就可以依自己喜好及相關需要選擇各種編輯器

(像是 gedit , vim 或其它介面等)，如用以下指令：

gedit --encoding=big5 pttbbs.conf

即可順利開啟

另外因為 OpenPtt 裡面程式的中文編碼是 Big5，Linux 等相關作業系統則預設 UTF-8 編碼

因此如果的編輯器顯示起來是亂碼

就表示你沒有用正確的編碼開啟

另外也要注意自己是否有權限編輯 (如果沒有，則要提升權限or切換執行的使用者)

一切設定就緒，就準備進行面對成敗的關鍵─編譯

５. 編譯 PttBBS

  1. 執行 make OSTYPE=linux BBSHOME=/home/bbs all install

(注意 OSTYPE 的大小寫，FreeBSD使用者請把 "linux" 改成 "FreeBSD")

開始編譯：

編譯完成：

這裡能夠順利完成的話(沒有紅色 error: 訊息)，基本上幾乎就可以架起來了

如果編譯發生各種問題，可以記下來，藉由搜尋引擎或論壇爬文討論找到可能的解法

或到 telnet://ptt2.cc 的 PttSrc 板詢問

其實在 telnet://ptt2.cc 的 PttSrc 就有不少文可以爬看看了

那邊還有一些在基本編譯設定上相關的問題, 有不少可以參考的建議、解答

６. 架新站才要做的相關設定

以下步驟是給第一次安裝 BBS 的時候使用的,

如果您的 BBS中已經有資料了, 請務必不要執行本部份步驟.

若確定自己是要架新站：

請執行 cd sample; make install，

並執行 cd /home/bbs; bin/initbbs

如果您的 BBS 中已經有資料了, 請務必不要執行本部份步驟.

以上步驟是給第一次安裝 BBS 的時候使用的

７. 啟動 BBS

`假如一切都很順利的話,這樣子大概就安裝完了 接下來是啟動 bbs 的部份

  1. 執行 cd /home/bbs; bin/uhash_loader (*註1)
  2. 用 root 執行 cd /home/bbs; bin/mbbsd 23 (*註2)

其實也可以用其他port設定，需要的權限就可以小一些

telnet localhost 23 看看

在 Linux 桌面裡的 terminal 來試因為預設顯示編碼就是 UTF-8

所以剛連進去看到就都是亂碼，可以自行調整 terminal 顯示編碼設定

以 Ubuntu 16.04 的 Terminal 為例，

上方選單 → Preferences → Profiles → 確定現在用的Profile是哪個 → Edit → Compatibility→Encoding

若同時有 Big5、Big5-HKSCS 的選項，則推薦用 Big5-HKSCS (能顯示較多字碼)

主機有裝圖形桌面也推薦安裝 pcmanx-gtk2 套件，並透過 pcmanx 來連到 localhost:23 來測試

８. 取得站長權限與初步維護BBS系統

new 一個帳號叫 SYSOP , 然後 logout 再 login , 這樣子就會擁有站長權限囉~

其他按照以下設定即可：

再 new 一個帳號叫 guest, 這樣子別人就可以用 guest 參觀你的站了

開板,開群組,以及搬動群組的方法請看 PttSrc 板的精華區

其他部分或此條目未詳盡之處，將再另開條目補充，這裡只敘述快速架設的方法。

註:

  1. 這個程式是在 initial shared memory 用的, 只有開機後第一次執行, 或是 你手動清除 shm 後才需要執行

  2. bin/mbbsd 23 是指定要 bind 23 port, 依照 UNIX 規定, 1024 以下的 port 須要有 root 權限, 所以如果要 bind 23 port 的話就要用 root 去執行,3000 port 則不需要

Clone this wiki locally