Installing from source/zh-tw

要將 UnrealIRCd 安裝於 Linux、FreeBSD、OpenBSD、OS X 以及其他 *NIX 系統，你通常要取得原始碼進行編譯及安裝. 除此之外，你也需要去手動設定 UnrealIRCd. 本頁面將會解釋如何去完成這些動作，即使你對 UnrealIRCd 是完全的新手，根據教學步驟只需 30 分鐘以內就可以讓 IRCd 成功地運作.

=取得原始程式碼 (.tar.gz)=

連至 https://www.unrealircd.org/ -> 點選 Downloads，選擇你所需要的版本. 當你點擊下載，畫面應該會出現 "The download should begin in 5 seconds, if it doesn't click here." 的文字訊息. 若下載未啟動，可以對畫面中的 "click here" 右鍵複製連結. 連結應該為：https://www.unrealircd.org/downloads/Unreal3.4-alpha999.tar.gz

透過 SSH 連線至 *NIX 伺服器，接下來的所有步驟都必須執行.

在 shell 中透過指令 wget --no-check-certificate https://www.unrealircd.org/downloads/Unreal3.4-alpha999.tar.gz 下載原始程式碼. 若你是在 FreeBSD 平台上則需要執行： fetch https://www.unrealircd.org/downloads/Unreal3.4-alpha999.tar.gz

如果上述兩個方法都失敗，而錯誤訊息為 'unknown command'，代表你需要先安裝 'wget' 套件.

或者，你可以從 *NUIX shell 中自行上傳 .tar.gz 到你的機器.

=解壓縮原始程式碼= 解壓縮 .tar.gz 並輸入 Unreal 3.4.x 資料夾： tar xzvf Unreal3.4-alpha999.tar.gz cd Unreal3.4-alpha999 備註：如果檔案名稱為 Unreal3.4.0-lala1.tar.gz，執行解壓縮後檔案會存在於一個名為 Unreal3.4.0-lala1 的資料夾內. 每一次釋出版本的檔案名稱都會不同，所以資料夾名稱也會不同，這樣可以避免你不小心在解壓縮時覆蓋已存在的檔案.

= Compiling = First, run the ./Config script which will ask a number of questions. You can just press Enter to accept the default answers. ./Config

Now, compile UnrealIRCd by running make, this may take a minute (or two): make

Finally, run make install (important!): make install

= Creating a configuration file =
 * 1) Change to the installed UnrealIRCd directory, this is /home/yourusername/unrealircd by default (For more information on the directory structure see UnrealIRCd files and directories). cd ~/unrealircd
 * 2) Copy conf/example/example.conf to your conf/ directory and rename it to unrealircd.conf syzop@vulnscan:~/unrealircd$ cp conf/examples/example.conf conf/unrealircd.conf
 * 3) Open the file with an editor (eg: nano conf/unrealircd.conf)
 * 4) Read the Configuration file syntax article. It will only take a few minutes and will save you a lot of trouble in next step(s)!
 * 5) Walk through the unrealircd.conf block by block / line by line and edit the settings to suit your needs. This takes 10 - 20 minutes.
 * 6) Boot UnrealIRCd by running ./unrealircd start from your ~/unrealircd directory.
 * 7) Errors? Edit your unrealircd.conf, fix them (see the FAQ for common problems), and try starting UnrealIRCd again.
 * 8) Up and running? Connect with an IRC client to your server and have fun. See next section too.

= Further reading =
 * See Features for various available features on UnrealIRCd and Configuration for all possible things you can configure on UnrealIRCd.
 * Again, see the FAQ if you have any problems. A lot of common problems are answered there.