操练：见习服主#

以上都只是启动服务器而已，但服务器处于空白的状态。此时你作为一名服主，应当自己去打理服务器了。

这篇文章介绍关于打理新月杀服务器的种种方式，包括下包啊、日常维护啊之类的。在阅读之前，你应该先明白服主自身的责任：

尊重他人的隐私。
操作之前，还请三思。
能力越大，责任也越大。

那么我们开始吧。

在新月杀自己的shell中使用help命令即可阅读各种帮助：

fk> help
[25-12-08 21:26:25.471733] [655743/I] Running command: 'help'
[25-12-08 21:26:25.471759] [655743/I] Frequently used commands:
[25-12-08 21:26:25.471763] [655743/I] ===== General commands =====
[25-12-08 21:26:25.471774] [655743/I] help: Display this help message.
[25-12-08 21:26:25.471781] [655743/I] quit: Shut down the server.
[25-12-08 21:26:25.471788] [655743/I] crash: Crash the server. Useful when encounter dead loop.
[25-12-08 21:26:25.471794] [655743/I] stat/gc: View status of server.
[25-12-08 21:26:25.471801] [655743/I] reloadconf/r: Reload server config file.
[25-12-08 21:26:25.471806] [655743/I]
[25-12-08 21:26:25.471810] [655743/I] ===== Inspect commands =====
[25-12-08 21:26:25.471814] [655743/I] lsplayer: List all online players.
[25-12-08 21:26:25.471818] [655743/I] lsroom: List all running rooms, or show player of room by an <id>.
[25-12-08 21:26:25.471822] [655743/I] msg/m: Broadcast message.
[25-12-08 21:26:25.471838] [655743/I] msgroom/mr: Broadcast message to a room.
[25-12-08 21:26:25.471841] [655743/I] kick: Kick a player by his <id>.
[25-12-08 21:26:25.471845] [655743/I] killroom: Kick all players in a room, then abandon it.
[25-12-08 21:26:25.471849] [655743/I] checklobby: Delete dead players in the lobby.
[25-12-08 21:26:25.471852] [655743/I]
[25-12-08 21:26:25.471855] [655743/I] ===== Account commands =====
[25-12-08 21:26:25.471858] [655743/I] ban: Ban 1 or more accounts, IP, UUID by their <name>.
[25-12-08 21:26:25.471862] [655743/I] unban: Unban 1 or more accounts by their <name>.
[25-12-08 21:26:25.471866] [655743/I] banip: Ban 1 or more IP address. At least 1 <name> required.
[25-12-08 21:26:25.471870] [655743/I] unbanip: Unban 1 or more IP address. At least 1 <name> required.
[25-12-08 21:26:25.471874] [655743/I] banuuid: Ban 1 or more UUID. At least 1 <name> required.
[25-12-08 21:26:25.471877] [655743/I] unbanuuid: Unban 1 or more UUID. At least 1 <name> required.
[25-12-08 21:26:25.471881] [655743/I] tempban: Ban an accounts by his <name> and <duration> (??m/??h/??d/??mo).
[25-12-08 21:26:25.471885] [655743/I] tempmute: Ban a player's chat by his <name> and <duration> (??m/??h/??d/??mo).
[25-12-08 21:26:25.471889] [655743/I] unmute: Unban 1 or more players' chat by their <name>.
[25-12-08 21:26:25.471893] [655743/I] whitelist: Add or remove names from whitelist.
[25-12-08 21:26:25.471896] [655743/I] resetpassword/rp: reset <name>'s password to 1234.
[25-12-08 21:26:25.471900] [655743/I]
[25-12-08 21:26:25.471903] [655743/I] ===== Package commands =====
[25-12-08 21:26:25.471906] [655743/I] install: Install a new package from <url>.
[25-12-08 21:26:25.471909] [655743/I] remove: Remove a package.
[25-12-08 21:26:25.471913] [655743/I] pkgs: List all packages.
[25-12-08 21:26:25.471916] [655743/I] syncpkgs: Get packages hash from file system and write to database.
[25-12-08 21:26:25.471920] [655743/I] enable: Enable a package.
[25-12-08 21:26:25.471923] [655743/I] disable: Disable a package.
[25-12-08 21:26:25.471927] [655743/I] upgrade/u: Upgrade a package. Leave empty to upgrade all.
[25-12-08 21:26:25.471930] [655743/I] For more commands, check the documentation.

help命令会列出所有的操作方法。一一说明吧。

拓展包管理相关#

新月杀提供了六条管理拓展包的命令。help里面已经说的很明白了。

欲安装拓展包，需使用install命令，参数是那个拓展包的git链接。比如安装神话再临包就是：

fk> install https://gitee.com/Qsgs-Fans/shzl

官方武将的拓展包都由这个Qsgs-Fans账号维护，去gitee中看看吧。

备注

注意安装任何拓展包之前都先安装好utility包，因为很多拓展在引用它的代码：

fk> install https://gitee.com/Qsgs-Fans/utility

欲删除、启用、禁用拓展包，需要带拓展包的名字作为命令参数。现在例如删除刚刚安装的神话再临包：

fk> remove shzl

直接删除的话后悔了又要重新下载，因此用的更多的是禁用与启用。

fk> pkgs

检查所有下载的安装包

fk> disable shzl
fk> enable shzl

上面两行指令就是先禁用神话再临再启用神话再临。包只要被禁用了，就不会被加载到游戏中。

欲查询拓展包，使用lspkg命令。这会显示所有拓展包。

更新则是upgrade命令，可以短写为u。更新如果指定包名那就只更新那个包，如果不指定的话就是全部更新。

fk> upgrade shzl
fk> u

上面两条指令中，第一条指明更新神话再临包；第二条则是更新本服安装的所有拓展包（包括已经被禁用的拓展包），也可以像upgrade一样更新某个包，fk> u shzl。

危险

在修改完拓展包相关之后，如果未启动服务器，那么连进来的玩家会陷入无穷无尽的自动同步拓展包！因此在更新完拓展包之后一定要重启服务器！

人员管理相关#

使用ban命令即可封禁用户，使用他的用户名作为参数。

fk> ban notify

ban命令会同时封禁用户名和设备码。

使用banip命令可以封禁用户的ip地址，参数一样的是用户名。

banuid是根据玩家uid进行封禁

同理，unban，unbanuuid和unbanip命令可以解封相应的用户。

fk> tempban notify 12h

tempban命令是封禁玩家一段时间，用法是tempban <name> <duration(日期)>

name是玩家的名称，duration则是封禁时长，用法是(??m/??h/??d/??mo)，m代表分钟，h代表小时，d代表天数，mo代表月份。

fk> tempmute 1 notify 12h

tempmute命令是根据类型禁言某名玩家一段时间，用法是tempban <type> <name> <duration(日期)>

name和duration与tempban命令里面的格式是一样的，这里主要介绍一下type

type参数有两个值，一个值是

1：禁止玩家发送语音与鸡蛋，并且禁止发送消息

2：禁止玩家发送语音与鸡蛋。

从结果上来看，2要比1的程度要轻，这边看服主个人的判断。

如果用户因为逃跑被自动封禁，则无法使用除了重启之外的任何手段解封。

fk> whitelist add notify1 notify2

whitelist是批量添加或移除玩家至服务器白名单。命令格式为：whitelist <add/remove> <name1> <name2> ....

fk> resetpassword/rp notify

resetpassword或rp命令是重置玩家的密码为1234（默认值）。格式为：resetpassword/rp <name> <password?>

password可填可不填，不填就为默认值1234.

其他命令#

msg命令（简写为m）可以向全服发送通告，参数就是通告内容。

fk> m 恭喜！玩家<b>神话天尊</b>在排位赛中升级到了最强的枭雄段位！

reloadconf（简写为r）可以重新加载服务器端的配置文件而无须重启服务器。在修改了服务器公告之后这个命令很有用。

关于服务器的配置文件#

上文提到了关于服务器的各种命令。除了那些命令之外，服主还可以用配置文件对服务器进行定制。

服务器的配置文件存放在freekill.server.config.json中。若无此文件，那么可以先将游戏目录下的配置样例复制一份：

$ cp freekill.server.config.json.example freekill.server.config.json

然后使用nano编辑freekill.server.config.json吧，默认内容如下：

{
  "banwords": [],
  "description": "FreeKill Server",
  "iconUrl": "https://img1.imgtp.com/2023/07/01/DGUdj8eu.png",
  "capacity": 100,
  "tempBanTime": 20,
  "motd": "Welcome!",
  "hiddenPacks": [],
  "enableBots": true
}

编辑他们即可修改服务器的相关设置，各项含义如下：

banwords: 字符串数组，服务器的违禁词汇列表。违禁词发不出去也不能作为用户名/房间名。
description: 服务器简介，显示在加入服务器界面的那行文字。
iconUrl: 服务器图标对应的图片链接，必须是网络图片。最好是http协议的图片，就目前来看只能是挂在自己服务器上了。
capacity: 服务器最大承载玩家的容量。新月杀服务器主要瓶颈在于带宽，保守一点估计的话，每1 Mbps可以承载60名玩家同时游戏。
tempBanTime: 对于逃跑玩家的自动封禁时长，单位为分钟。设为0 即可关闭自动封禁功能，不要设为负数。
motd: 用户进入大厅时候在屏幕右侧看到的文字，支持markdown格式。不过因为JSON不能写多行字符串，你得把写好的markdown中所有换行符全替换成n才好哦。
hiddenPacks: 服务器想要隐藏的拓展包列表，对于DIY服应该是需要的。
enableBots: 是否允许玩家添加机器人，视情况设定。

关于数据库#

服务器会存储各个玩家的注册时间、游戏时长，以及他们的胜率；相应的也会存储各个武将的胜率。作为服主可以对数据库进行查询。

新月杀采用sqlite作为数据库管理系统，因此数据库只是单个文件而已。对于比较小的服务器来说这个选择也挺不错。数据库对应的文件是server/users.db。

这里介绍某些常见查询需要用到的SQL语句，至于使用何种工具查询就取决于你自己了；你可以在shell里面直接用sqlite3 users.db对数据库进行查询，或者将数据库下载到本机然后用各种有GUI的软件进行查看。

关于SQL语法本身不进行解释，请自行学习。弄明白表结构之后你也可以自己写出更加好用的sql语句。

警告

因为sqlite本身对并发支持很弱，如果服务器非常活跃的话不要直接查询正在被游戏进程使用中的users.db，否则可能导致游戏因为不能操作数据库而崩溃。这种情况下考虑先复制一份数据库文件或者下载到本地都行。

查胜率#

查询玩家notify的全模式胜率：

SELECT * FROM playerWinRate WHERE name='notify';

查询玩家notify的斗地主模式胜率：

SELECT * FROM playerWinRate WHERE name='notify' AND mode='m_1v2_mode';

提示

服务端安装gamemode拓展包后即可游玩更多游戏模式。

查询全服所有玩家斗地主胜率排行，只查询大于300场者，按胜率从高到低排列，只取前20名：

SELECT * FROM playerWinRate WHERE mode='m_1v2_mode' AND total>300
  ORDER BY winRate DESC LIMIT 20;

查询武将貂蝉（内部名diaochan）的斗地主模式胜率：

SELECT * FROM generalWinRate WHERE general='diaochan' AND mode='m_1v2_mode';

可以看出武将胜率表相对于玩家的而言只是把name换成general，所以不再赘述。

查特定人特定模式特定武将#

警告

因为这么存的话数据库变得太大了，以后的更新可能不再按玩家-模式-武将的方式单独存储一个很大的表而是分两张表存。

简而言之就是这里所说的SQL后面可能会失效。但因为大家很鸽说不定一直不去改也不好说。

查询玩家notify在斗地主模式下的所有武将游玩记录，只显示五条：

SELECT name, general, win, lose, draw, (win + lose + draw) AS total,
  ROUND(win * 1.0 / (win + lose + draw) * 100, 2) AS winRate
  FROM winRate, userinfo
  WHERE winRate.id = userinfo.id AND name = 'notify'
  AND mode = 'm_1v2_mode'
  LIMIT 5;

可以自己在WHERE后面追加更多条件，或者排序之类的。

查询武将貂蝉（内部名diaochan）在斗地主中被全服玩家们游玩过的记录，按总场次从高到低排序，显示前面10条：

SELECT name, general, win, lose, draw, (win + lose + draw) AS total,
  ROUND(win * 1.0 / (win + lose + draw) * 100, 2) AS winRate
  FROM winRate, userinfo
  WHERE winRate.id = userinfo.id AND mode = 'm_1v2_mode'
  AND general = 'diaochan'
  ORDER BY total DESC LIMIT 10;

查注册、登录时间以及游玩时长#

查询玩家notify的注册时间、上次登陆与游戏时长：

SELECT userinfo.id as Id, name, ROUND(totalGameTime / 3600.0, 2) || " h" AS 'Time',
  DATETIME(registerTime, 'unixepoch', 'localtime') AS RegTime,
  DATETIME(lastLoginTime, 'unixepoch', 'localtime') as LastLogTime
  FROM usergameinfo, userinfo
  WHERE userinfo.id = usergameinfo.id AND userinfo.name = 'notify';

查询近7天以来登录到服务器的玩家列表：

SELECT userinfo.id as Id, name, ROUND(totalGameTime / 3600.0, 2) || " h" AS 'Time',
  DATETIME(registerTime, 'unixepoch', 'localtime') AS RegTime,
  DATETIME(lastLoginTime, 'unixepoch', 'localtime') as LastLogTime
  FROM usergameinfo, userinfo
  WHERE userinfo.id = usergameinfo.id AND
    DATE(lastLoginTime, 'unixepoch', 'localtime') >=
    DATE('now', 'localtime', '-7 days') AND
    DATE(lastLoginTime, 'unixepoch', 'localtime') <
    DATE('now', 'localtime', 'start of day', '+1 days');

想要方便的查看所有人的游玩信息，可以创建一个视图：

CREATE VIEW IF NOT EXISTS gameinfoView AS
  SELECT userinfo.id as Id, name, ROUND(totalGameTime / 3600.0, 2) || " h" AS 'Time',
    DATETIME(registerTime, 'unixepoch', 'localtime') AS RegTime,
    DATETIME(lastLoginTime, 'unixepoch', 'localtime') as LastLogTime
    FROM usergameinfo, userinfo
    WHERE userinfo.id = usergameinfo.id;

查询全服游玩时长排行：

SELECT name, ROUND(totalGameTime / 3600.0, 2) || " h" AS 'Time'
  FROM usergameinfo, userinfo
  WHERE userinfo.id = usergameinfo.id
  ORDER BY totalGameTime DESC LIMIT 20;

sqlite命令行导出csv文件#

这里专门对sqlite命令行进行解说，其他软件应该有更好办法。

sqlite> .mode csv
sqlite> .output test.csv

这两条命令之后，接下来查询结果就输出为csv格式，并保存在test.csv文件中。接下来就运行一条自己想要的语句吧，然后退出sqlite，那个文件中就有查询结果了。

服务端版本更新#

待处理

已过时。

比如远程仓库已经更新到了v0.5.12，现在让我们回到Fk>提示符下，输入quit暂时关闭服务器，回到FreeKill目录后，输入：

git fetch
git checkout v0.5.12

先获取远程仓库更新，然后同步最新版本标签。

接下来就是按前面的方法跑一遍编译：

请参考编译运行新月杀服务器端获取详细指导。

make完事之后，回到FreeKill目录下，启动服务器就可以了：

cd ..
./FreeKill -s