264 lines
10 KiB
Groff
264 lines
10 KiB
Groff
.\" This program is free software; you can redistribute it and/or modify
|
||
.\" it under the terms of the GNU General Public License as published by
|
||
.\" the Free Software Foundation; either version 2 of the License, or
|
||
.\" (at your option) any later version.
|
||
.\"
|
||
.\" This program is distributed in the hope that it will be useful,
|
||
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
.\" GNU General Public License for more details.
|
||
.\"
|
||
.\" You should have received a copy of the GNU General Public License
|
||
.\" along with this program; if not, write to the Free Software
|
||
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||
.\"
|
||
.
|
||
.\"*******************************************************************
|
||
.\"
|
||
.\" This file was generated with po4a. Translate the source file.
|
||
.\"
|
||
.\"*******************************************************************
|
||
.TH WESNOTHD 6 2022 wesnothd 韋諾之戰多人網路伺服器
|
||
.
|
||
.SH 名稱
|
||
.
|
||
wesnothd \- 韋諾之戰多人網路伺服器
|
||
.
|
||
.SH 摘要
|
||
.
|
||
\fBwesnothd\fP [\|\fB\-dv\fP\|] [\|\fB\-c\fP \fIpath\fP\|] [\|\fB\-p\fP \fIport\fP\|] [\|\fB\-t\fP
|
||
\fInumber\fP\|] [\|\fB\-T\fP \fInumber\fP\|]
|
||
.br
|
||
\fBwesnothd\fP \fB\-V\fP
|
||
.
|
||
.SH 描述
|
||
.
|
||
管理韋諾之戰的多人遊戲。參閱 http://www.wesnoth.org/wiki/ServerAdministration
|
||
來查看透過韋諾客戶端(/query ...)或 fifo，伺服器接受什麼指令。
|
||
.
|
||
.SH 選項
|
||
.
|
||
.TP
|
||
\fB\-c\ \fP\fIpath\fP\fB,\ \-\-config\fP\fI\ path\fP
|
||
告訴 wesnothd 要去哪裡找到設定檔來用。參閱下面的 \fBSERVER CONFIG\fP 來了解語法。你可以藉由傳送 SIGHUP
|
||
給伺服器的行程來重新載入設定檔。
|
||
.TP
|
||
\fB\-d, \-\-daemon\fP
|
||
執行 wesnothd 作為一個系統服務。
|
||
.TP
|
||
\fB\-h, \-\-help\fP
|
||
告訴你命令列的選項是做什麼用的。
|
||
.TP
|
||
\fB\-\-log\-\fP\fIlevel\fP\fB=\fP\fIdomain1\fP\fB,\fP\fIdomain2\fP\fB,\fP\fI...\fP
|
||
設定日誌域的嚴重等級。\fBall\fP 可以用來匹配任何日誌域。可使用的等級有：\fBerror\fP,\ \fBwarning\fP,\ \fBinfo\fP,\ \fBdebug\fP。預設的情況下，\fBerror\fP 等級會被使用，而 \fBserver\fP 日誌域會預設為 \fBinfo\fP 等級。
|
||
.TP
|
||
\fB\-p\ \fP\fIport\fP\fB,\ \-\-port\fP\fI\ port\fP
|
||
綁定伺服器到指定的連接埠。如果不指定埠號，將會使用連接埠 \fB15000\fP。
|
||
.TP
|
||
\fB\-t\ \fP\fInumber\fP\fB,\ \-\-threads\fP\fI\ number\fP
|
||
為網路 I/O 設定工作執行緒的最大數量為 n（預設值：\fB5\fP；最大值：\fB30\fP）。
|
||
.TP
|
||
\fB\-T\ \fP\fInumber\fP\fB,\ \-\-max\-threads\fP\fI\ number\fP
|
||
設定會被建立的工作執行緒的最大數量。如果設定為 \fB0\fP，則將沒有限制（預設值：\fB0\fP）。
|
||
.TP
|
||
\fB\-V, \-\-version\fP
|
||
顯示版本號碼並退出。
|
||
.TP
|
||
\fB\-v, \-\-verbose\fP
|
||
開啟偵錯日誌。
|
||
.
|
||
.SH 伺服器設定
|
||
.
|
||
.SS 常用語法是：
|
||
.
|
||
.P
|
||
[\fItag\fP]
|
||
.IP
|
||
\fIkey\fP="\fIvalue\fP"
|
||
.IP
|
||
\fIkey\fP="\fIvalue\fP,\fIvalue\fP,..."
|
||
.P
|
||
[/\fItag\fP]
|
||
.
|
||
.SS 全域鍵值：
|
||
.
|
||
.TP
|
||
\fBallow_remote_shutdown\fP
|
||
如果設置為 \fBno\fP （預設值），shut_down（關閉）和 restart（重啟）請求將被忽略，除非它們來自 fifo。設為 \fByes\fP
|
||
可允許被一個管理員透過 /query 來遠程關閉。
|
||
.TP
|
||
\fBban_save_file\fP
|
||
伺服器可讀可寫的（經gzip壓縮的）檔案的完整路徑或相對路徑。封禁清單將會被保存到這個檔案裡，並在伺服器啟動時再次讀取。
|
||
.TP
|
||
\fBcompress_stored_rooms\fP
|
||
指定房間檔案是否應該以壓縮形式讀寫。預設值為 \fByes\fP。
|
||
.TP
|
||
\fBconnections_allowed\fP
|
||
同一IP允許的連接數。（預設值：\fB5\fP）
|
||
.TP
|
||
\fBdeny_unregistered_login\fP
|
||
是否在 \fBuser_handler\fP 被使用時，防止沒有註冊的玩家進行登入。（預設值：false）
|
||
.TP
|
||
\fBdisallow_names\fP
|
||
伺服器不允許使用的名稱/暱稱。支援使用 \fB*\fP 和 \fB?\fP 這兩個萬用字元。參閱 \fBglob\fP(7)
|
||
來了解細節。預設值（如果沒有東西被指定就會用這個值）是：\fB*admin*,*admln*,*server*,ai,ai?,computer,human,network,player\fP。
|
||
.TP
|
||
\fBfifo_path\fP
|
||
你可以送出伺服器指令到（與透過韋諾客戶端使用「/query ...」相同）的 fifo
|
||
檔案的路徑。如果不指定，則預設為編譯階段所設定的路徑（預設：\fB/var/run/wesnothd/socket\fP）。
|
||
.TP
|
||
\fBmax_messages\fP
|
||
\fBmessages_time_period\fP 中允許的訊息數量。（預設：\fB4\fP）
|
||
.TP
|
||
\fBmessages_time_period\fP
|
||
訊息氾濫的檢測時間間隔（秒）。（預設：\fB10\fP 秒）
|
||
.TP
|
||
\fBmotd\fP
|
||
當天的消息。
|
||
.TP
|
||
\fBnew_room_policy\fP
|
||
指定誰能在伺服器上建立新房間。可使用的值為 \fBeveryone\fP, \fBregistered\fP, \fBadmin\fP,
|
||
\fBnobody\fP，分別給所有人、有註冊的使用者、管理員使用者、沒有人，建立新房間的權限。預設值為 \fBeveryone\fP。
|
||
.TP
|
||
\fBpasswd\fP
|
||
用來取得管理員權限的密碼（透過 \fB/query admin \fP\fIpassword\fP）。
|
||
.TP
|
||
\fBreplay_save_path\fP
|
||
伺服器用於存放遊戲錄影的目錄。（不要忘了以「/」結尾！）預設為「`'」，意思是 wesnothd 的工作目錄。
|
||
.TP
|
||
\fBrestart_command\fP
|
||
這是伺服器用來透過 \fBrestart\fP 命令開啟新的伺服器行程的命令。（只能通過 fifo 來調用。參見
|
||
\fBallow_remote_shutdown\fP 設定。）
|
||
.TP
|
||
\fBroom_save_file\fP
|
||
房間資訊應該要被存到哪的檔案路徑。這個檔案在伺服器啟動時被讀取，之後會被寫入。如果留空或者不設置，房間不會被讀取，也不會被保存。
|
||
.TP
|
||
\fBsave_replays\fP
|
||
設置伺服器是否自動保存遊戲錄影。（預設值：\fBfalse\fP）
|
||
.TP
|
||
\fBtls_enabled\fP
|
||
啟用 TLS 時。 如果為 true，則還需要設定以下 3 個選項。
|
||
.TP
|
||
\fBtls_fullchain\fP
|
||
TLS 完整的信任鍊，格式為.pem
|
||
.TP
|
||
\fBtls_private_key\fP
|
||
TLS私鑰，格式為.pem
|
||
.TP
|
||
\fBtls_dh\fP
|
||
TLS Diffie\-Hellman 參數，為.pem檔案。使用 \fBopenssl dhparam \-out filename.pem 4096\fP生成
|
||
.TP
|
||
\fBversions_accepted\fP
|
||
用逗號分隔的版本字串清單，伺服器會接受清單上面的版本。支援使用 \fB*\fP 和 \fB?\fP 這兩個萬用字元。（預設為對應的韋諾版本）
|
||
.br
|
||
例如：\fBversions_accepted="*"\fP 允許任意版本字串。
|
||
.TP
|
||
\fBid\fP
|
||
使用資料庫功能儲存遊戲資訊時伺服器的ID。 一般是接受客戶端的 major.minor 版本，例如1.16或1.17。
|
||
.
|
||
.SS 全域標籤：
|
||
.
|
||
.P
|
||
\fB[redirect]\fP 一個用來設定指定的客戶端版本要重新導向到哪個伺服器的標簽。如果 \fBversions_accepted\fP
|
||
沒有設定就不會被使用。
|
||
.RS
|
||
.TP
|
||
\fBhost\fP
|
||
重新導向到的伺服器地址。
|
||
.TP
|
||
\fBport\fP
|
||
連結的連接埠。
|
||
.TP
|
||
\fBversion\fP
|
||
用逗號分隔的版本清單，作為重新導向的依據。支援使用 \fB*\fP 和 \fB?\fP 這兩個萬用字元。
|
||
.RE
|
||
.P
|
||
\fB[ban_time]\fP 一個用來替臨時性的封禁時間長度定義方便的關鍵字的標籤。
|
||
.RS
|
||
.TP
|
||
\fBname\fP
|
||
名稱用來參照到封禁時間。
|
||
.TP
|
||
\fBtime\fP
|
||
時間長度定義。格式為：%d[%s[%d%s[...]]]。其中 %s 是s（秒）, m（分鐘）, h（小時）, D（天）, M（月）, Y（年），%d
|
||
是一個數字。如果不指定時間單位，預設為分鐘(m)。例如：\fBtime=\"1D12h30m\"\fP 的結果是1天12小時30分的封禁。
|
||
.RE
|
||
.P
|
||
\fB[proxy]\fP 一個告訴伺服器扮演代理伺服器的角色，把連入的使用者請求導向到指定的伺服器的標籤。與 \fB[redirect]\fP 接受一樣的鍵值。
|
||
.RE
|
||
.P
|
||
\fB[user_handler]\fP 配置使用者處理程序。如果配置中沒有 \fB[user_handler]\fP
|
||
區塊，伺服器將以不提供任何暱稱註冊服務的方式來運行。所有額外的 \fBforum_user_handler\fP
|
||
所需要用來運行的表格可以在韋諾的原始碼倉庫中的 table_definitions.sql 中被找到。需要啟用 MySQL 支援，以 cmake
|
||
來說要使用 \fBENABLE_MYSQL\fP；以 scons 來說要使用 \fBforum_user_handler\fP
|
||
.RS
|
||
.TP
|
||
\fBdb_host\fP
|
||
資料庫伺服器的主機名
|
||
.TP
|
||
\fBdb_name\fP
|
||
資料庫的名稱
|
||
.TP
|
||
\fBdb_user\fP
|
||
用來登入資料庫的使用者名稱
|
||
.TP
|
||
\fBdb_password\fP
|
||
這個使用者的密碼
|
||
.TP
|
||
\fBdb_users_table\fP
|
||
phpbb 論壇中存放使用者資料的表單。很可能是 <table\-prefix>_users（例如：phpbb3_users）。
|
||
.TP
|
||
\fBdb_extra_table\fP
|
||
wesnothd 將在其中保存其自己的有關使用者資料的表格。
|
||
.TP
|
||
\fBdb_game_info_table\fP
|
||
wesnothd 將在其中保存其自己的有關遊戲資料的表格。
|
||
.TP
|
||
\fBdb_game_player_info_table\fP
|
||
wesnothd 將在其中保存其自己的有關每場遊戲中的玩家資料的表格。
|
||
.TP
|
||
\fBdb_game_modification_info_table\fP
|
||
wesnothd 將在其中保存其自己的有關每場遊戲中被使用的模組的資料的表格。
|
||
.TP
|
||
\fBdb_user_group_table\fP
|
||
phpbb 論壇中存放使用者群組資料的表單。很可能是
|
||
<table\-prefix>_user_group（例如：phpbb3_user_group）。
|
||
.TP
|
||
\fBdb_connection_history_table\fP
|
||
用於儲存登入/登出時間的表單。也用於將IP與使用者交互比對。
|
||
.TP
|
||
\fBdb_topics_table\fP
|
||
phpbb 論壇中存放主題（帖子）資訊的表單。很可能是 <table\-prefix>_topics（例如：phpbb3_topics）。
|
||
.TP
|
||
\fBdb_banlist_table\fP
|
||
phpbb 論壇中存放封鎖使用者資料的表單。很可能是
|
||
<table\-prefix>_banlist（例如：phpbb3_banlist）。
|
||
.TP
|
||
\fBmp_mod_group\fP
|
||
被視為具有審核權限的論壇組的 ID。
|
||
.RE
|
||
.
|
||
.SH 退出狀態碼
|
||
.
|
||
正常退出的狀態碼為 0，此時伺服器被適當地關閉。退出狀態碼 2 表示命令列選項有錯誤。
|
||
.
|
||
.SH 作者
|
||
.
|
||
由 David White <davidnwhite@verizon.net> 編寫。經 Nils Kneuper
|
||
<crazy\-ivanovic@gmx.net>, ott <ott@gaon.net> 和 Soliton
|
||
<soliton.de@gmail.com> 修改。這個手冊最早由Cyril Bouthors
|
||
<cyril@bouthors.org> 編寫。
|
||
.br
|
||
拜訪官方網站：http://www.wesnoth.org/
|
||
.
|
||
.SH 著作權
|
||
.
|
||
Copyright \(co 2003\-2024 David White <davidnwhite@verizon.net>
|
||
.br
|
||
這是一個自由軟體，這個軟體採用由自由軟體協會(FSF)所發佈的GPLv2授權協議。沒有保證，甚至對「可銷售性」和「對某一特定目的的適用性」也沒有保證。本段翻譯文字不具法律效力，如有需要請參閱原文或者是
|
||
GPLv2 授權條款。
|
||
.
|
||
.SH 參見
|
||
.
|
||
\fBwesnoth\fP(6)
|
||
|