wesnoth/doc/man/zh_TW/wesnothd.6

.\" 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\-dvw\fP\|] [\|\fB\-c\fP \fIpath\fP\|] [\|\fB\-p\fP \fIport\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\-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 
\fBconnections_allowed\fP
同一IP允許的連接數。（預設值：\fB5\fP）
.TP 
\fBdeny_unregistered_login\fP
是否在 \fBuser_handler\fP 被使用時，防止沒有註冊的玩家進行登入。（預設值：false）
.TP 
\fBdisallow_names\fP
Names/nicks that are not accepted by the server. \fB*\fP and \fB?\fP from wildcard
patterns are supported. See \fBglob\fP(7)  for more details.  Default values
(used if nothing is specified) are:
\fB*admin*,*admln*,*moderator*,*server*,ai,ai?,computer,human,network,player\fP.
.TP 
\fBfifo_path\fP
你可以送出伺服器指令到（與透過韋諾客戶端使用「/query ...」相同）的 fifo
檔案的路徑。如果不指定，則預設為編譯階段所設定的路徑（預設：\fB/var/run/wesnothd/socket\fP）。
.TP 
\fBid\fP
使用資料庫功能儲存遊戲資訊時伺服器的ID。 一般是接受客戶端的 major.minor 版本，例如1.16或1.17。
.TP 
\fBmax_messages\fP
\fBmessages_time_period\fP 中允許的訊息數量。（預設：\fB4\fP）
.TP 
\fBmessages_time_period\fP
訊息氾濫的檢測時間間隔（秒）。（預設：\fB10\fP 秒）
.TP 
\fBmotd\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 
\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 允許任意版本字串。
.
.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_content_info_table\fP
The name of the table in which wesnothd will save its own data about game
content (scenario/era/modifications) used in a game.
.TP 
\fBdb_user_group_table\fP
phpbb 論壇中存放使用者群組資料的表單。很可能是
<table\-prefix>_user_group（例如：phpbb3_user_group）。
.TP 
\fBdb_tournament_query\fP
The SQL query to find tournaments to announce on login. Should return
tournament \fBtitle\fP, \fBstatus\fP and \fBurl\fP.
.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。
.TP 
\fBforum_admin_group\fP
The ID of one of the forum groups to be considered as having admin authority
on the add\-ons server.
.TP 
\fBsite_admin_group\fP
The ID of one of the forum groups to be considered as having admin authority
on the add\-ons server.
.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\-2025 David White <davidnwhite@verizon.net>
.br
這是一個自由軟體，這個軟體採用由自由軟體協會(FSF)所發佈的GPLv2授權協議。沒有保證，甚至對「可銷售性」和「對某一特定目的的適用性」也沒有保證。本段翻譯文字不具法律效力，如有需要請參閱原文或者是
GPLv2 授權條款。
.
.SH 參見
.
\fBwesnoth\fP(6)