.\" 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 論壇中存放使用者資料的表單。很可能是 _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 論壇中存放使用者群組資料的表單。很可能是 _user_group（例如：phpbb3_user_group）。 .TP \fBdb_connection_history_table\fP 用於儲存登入/登出時間的表單。也用於將IP與使用者交互比對。 .TP \fBdb_topics_table\fP phpbb 論壇中存放主題（帖子）資訊的表單。很可能是 _topics（例如：phpbb3_topics）。 .TP \fBdb_banlist_table\fP phpbb 論壇中存放封鎖使用者資料的表單。很可能是 _banlist（例如：phpbb3_banlist）。 .TP \fBmp_mod_group\fP 被視為具有審核權限的論壇組的 ID。 .RE . .SH 退出狀態碼 . 正常退出的狀態碼為 0，此時伺服器被適當地關閉。退出狀態碼 2 表示命令列選項有錯誤。 . .SH 作者 . 由 David White 編寫。經 Nils Kneuper , ott 和 Soliton 修改。這個手冊最早由Cyril Bouthors 編寫。 .br 拜訪官方網站：http://www.wesnoth.org/ . .SH 著作權 . Copyright \(co 2003\-2024 David White .br 這是一個自由軟體，這個軟體採用由自由軟體協會(FSF)所發佈的GPLv2授權協議。沒有保證，甚至對「可銷售性」和「對某一特定目的的適用性」也沒有保證。本段翻譯文字不具法律效力，如有需要請參閱原文或者是 GPLv2 授權條款。 . .SH 參見 . \fBwesnoth\fP(6)