server.properties 基础项逐项详解

你刚把服务端跑起来，朋友在多人列表里看到一行 A Minecraft Server，问你这是不是官方服。你想改成自己的名字，点开 server.properties，迎面七十多行英文键，又默默关掉了。

这份文件就是一张设置清单：一行一个键，服务端启动时从头读一遍。它决定别人在列表里看到什么、能不能连进来、最多几个人、要不要正版账号。手机服出问题，一半以上能在前二十行里找到原因。

这一页只讲基础项：每个键的默认值、手机该填什么、改完要不要重启。网络、性能、资源包、RCON 这些一改就可能把服搞崩的键，放在 server.properties 进阶项。

本页要点

这份文件只在启动时读一次，改完停止再启动，否则等于没改。
两个入口：表单改常见键，负数和新键只能进文件里改。
先看这四行：server-port、online-mode、white-list、max-players。
关正版前先开白名单，否则谁都能顶着你的名字进来。
手机最吃内存的是视距，降到 6 比加内存有效。

改完为什么没反应：先确认三件事#

第一，文件在哪。 它在服务端目录里，和核心 .jar、world 同级。Minexa 里有两个入口：底部「服务器管理」→「服务器配置」是表单，只列 75 项；底部「文件」是文本编辑器，能改所有键。基岩系的 PowerNukkitX 读的是 pnx.yml，不在这份文件里。

第二，它只在启动时读一次。 所以改完必须停止再启动——应用里没有「重启」按钮，只能先点停止、等它停稳，再点启动。

第三，第一次启动才会生成。 刚下载完、还没跑过的服务器，配置页显示的是「配置尚未生成」。先启动一次让它写出完整默认值，再回来改。细节见服务器配置页。

保存成功 ≠ 已经生效

配置页的保存动作只负责写文件。服务端还在按启动时读到的旧值运行。改端口时最明显：概览的地址卡已经显示新端口，服务端却仍然监听旧端口。

四条规矩，能省掉一半返工#

一行一个键：motd=我的服。等号两边不要加空格，写成 motd = 我的服 时，有的解析器会把空格算进值里。
# 开头是注释：整行忽略。改值的时候别顺手把注释删了，下次你会看不懂这行是干嘛的。
UTF-8，别用全角：值里写中文没问题，但等号、引号必须是英文半角。全角等号会让整行失效，而且不报错。
改前备份，一次只改一项：出问题时你才知道是哪一项干的。

改之前先留一份原样

用「文件」页的文本编辑器打开 server.properties 时，先把内容整段复制到便签里。改坏了还有一份原样可比对，不用凭记忆回滚。

动手之前先备份

文件管理里的删除和编辑不检查服务端是否正在运行，也没有撤销。手滑一次，注释和别的键可能一起没了。改配置前去「世界与备份」做一次整服备份，或至少备份世界目录，做法见备份、还原与世界管理。

门面与入口：7 个键决定别人怎么进来#

键	默认	4GB / 2–5 人	8GB / 10 人	重启	作用与风险
`motd`	`A Minecraft Server`	版本 + 玩法，20～40 字	同左，可加群号	要	列表里显示的两行字；太长会被截断
`server-port`	`25565`	`25565`，没冲突别改	`25565`	要	监听端口；改了下游全要跟着改
`server-ip`	空	留空	留空	要	监听地址；填死某个 IP 后换网络就起不来
`max-players`	`20`	3～6	8～12	要	同时在线上限；只是上限，不代表带得动
`online-mode`	`true`	`true`	`true`	要	正版验证；关掉谁都能冒名
`white-list`	`false`	`true`	`true`	要	只让名单内的人进；空名单会锁死所有人
`enforce-whitelist`	`false`	`true`	`true`	要	`true` 时 OP 也必须待在白名单里

motd：别人看到的第一句话#

motd 就是服务器列表里那两行字。写法很固定：版本号 + 玩法 + 一句招呼，控制在 20～40 个字，重点放第一行。

想在文件管理里加颜色，用 § 格式符（§a 绿、§c 红、§l 加粗），换行写 \n；这些在配置页的文本框里改不了，只能去文件管理页编辑原文件。

server-port：改一个数字，牵动四个地方#

默认 25565。改端口不能提升安全（扫描器扫完 65535 个端口只要几秒），只用来避开冲突。真要改，四件事一起改，少一件就连不上：

改完重启服务端，新端口才开始监听；
概览的「服务器地址」重启后会读新值，局域网地址变了；
FRP 或路由器映射的本地端口也要改成同一个；
把新地址重新发给朋友。

两个细节：别用 1024 以下的端口，Android 上非 root 进程绑不上，服务端会直接报错退出；server-ip 保持空着表示监听所有网卡，填死某个 IP 后，手机换 Wi-Fi、IP 一变就起不来。公网可达性不取决于端口号，取决于隧道或映射，见公网 IP、端口映射与 IPv6。

max-players：它是上限，不是“带得动”#

默认 20。它只回答“最多能进几个人”，不负责性能；具体填多少看上面那张表的中间两列。多一个人就多一份区块加载，怎么配见内存分配。

online-mode：关掉它，等于关掉身份验证#

默认 true。开着时服务端会拿登录信息去验证，没有正版账号的人进不来。改成 false 就是“离线模式”：服务端只认名字，不认人。

风险比“别人能进”严重得多：离线模式下 UUID 由名字算出来，冒名者用你朋友的名字进来，会直接继承那个名字的背包、位置和 OP 权限——服务端眼里他们就是同一个人。

关正版 + 开公网 = 把钥匙挂在门上

online-mode=false 再暴露到公网，任何人知道地址就能用任意名字进来，包括你的名字。只在完全信任的小圈子里关，并且必须同时开白名单。

white-list 与 enforce-whitelist：锁门和钥匙#

white-list 默认 false。改成 true 后，只有 whitelist.json 里的人能进。两个坑：

名单是空的就锁门：空名单一开，所有人都进不来，包括你自己。正确顺序是先 whitelist add 把自己和朋友加进去，再打开开关。锁死了也别慌，控制台不需要登录。
玩家页的开关不写文件：它只发 whitelist on 命令，立刻生效但不改 server.properties，重启后回到文件里的值。想长期有效就在这里写 true，见白名单、OP 与封禁管理。

enforce-whitelist 默认 false，含义是 OP 可以绕过白名单。改成 true 后 OP 也必须待在名单里，更安全，但你要是把自己漏了，就得回控制台加回来。

玩法与世界：改错最有感觉的一组#

键	默认	4GB / 2–5 人	8GB / 10 人	重启	作用与风险
`difficulty`	`easy`	`normal`	`normal`	要	和平/简单/普通/困难；影响怪物强度与饥饿
`gamemode`	`survival`	`survival`	`survival`	要	新玩家第一次进服的默认模式
`force-gamemode`	`false`	`false`	`false`	要	`true` 时每次进服都强制套用默认模式
`pvp`	`true`	看玩法	看玩法	要	玩家之间能否互相伤害
`allow-flight`	`false`	`false`	`false`	要	生存模式飞行会被踢；装了飞行插件再开
`spawn-protection`	`16`	`0`	`0`	要	出生点保护半径；非 OP 不能在范围内破坏
`enable-command-block`	`false`	`false`	`false`	要	命令方块；开了等于让红石能执行命令
`op-permission-level`	`4`	`4`	`4`	要	OP 等级 1–4；4 级能 op 别人、能关服
`level-name`	`world`	`world`	`world`	要	主世界文件夹名；改了等于换一张图
`level-seed`	空	留空	留空	要	只影响新生世界；老世界改它没用
`level-type`	`minecraft:normal`	默认	默认	要	地形类型；同样只对新生世界生效
`allow-nether`	`true`	`true`	`true`	要	关掉后下界传送门失效

level-name 与 level-seed：改错就是“开新档”#

level-name 是主世界的文件夹名，默认 world。把它改成 world2、而目录里没有这个文件夹，服务端会直接生成一张新地图。旧世界还在磁盘上，但界面上“消失”了——这是新手最常说的“我的存档没了”。

level-seed 和 level-type 只在第一次生成这个世界时起作用。世界已经存在，改种子和地形类型不会有任何变化。想换图，正确顺序是：备份 → 停止服务端 → 改 level-name（或重置世界）→ 启动。世界导入、导出和重置都要求先停服，步骤见备份、还原与世界管理。

spawn-protection 与 op-permission-level：出生点和权限#

spawn-protection 默认 16：出生点 16 格半径内，非 OP 不能破坏和放置。想一进服就在出生点盖房子就改成 0。

op-permission-level 默认 4：它决定 /op 命令发出去的等级。4 级能 op/deop 别人、能 /stop 关服、能改游戏规则，别给陌生人 4 级。改小之后要重新 op 一次才按新等级算，已经 op 的人不会自动降级；等级对照表见白名单、OP 与封禁管理。

手机最该盯的四个数字#

键	默认	4GB / 2–5 人	8GB / 10 人	重启	作用与风险
`view-distance`	`10`	5～6	6～8	要	客户端能看多远（单位区块）；最吃内存
`simulation-distance`	`10`	4～6	6～8	要	多远内的实体、作物、红石真正在运算
`player-idle-timeout`	`0`	`0` 或 `15`	`15`	要	挂机多少分钟踢人；`0` 表示不踢
`pause-when-empty-seconds`	`-1`	`300`	`-1`	要	空服多少秒后暂停；较老版本没有这个键

view-distance 与 simulation-distance：一起降才有用#

两个默认都是 10。视距是“客户端能看多远”，模拟距离是“服务器真的在算多远”。视距 10 意味着每个玩家周围 21×21 个区块的数据都要准备，手机上这是最贵的一项。

区别要记住：视距只影响看不看得见，模拟距离影响作物长不长、怪刷不刷、红石走不走。所以模拟距离别低于 4，否则你走开一会儿再回来，农田和刷怪塔全停着。两个一起降，只降一个效果有限；具体数值和原理见视距与模拟距离。

pause-when-empty-seconds 给手机省电：没人的时候暂停整个服务端，玩家进来再恢复，会有一下卡顿。

可以直接抄的一份配置片段#

下面这段是「4GB 手机、2～5 人、正版生存服」的起点。只改文件里同名的行，不要把整份文件覆盖掉。

server.properties

# 4GB 手机 / 2～5 人 起点配置，改完必须重启

# 改这里：列表里显示的名字，写清版本和玩法
motd=小破服 · 1.21.x · 晚上八点开
# 改这里：人数上限，按你的手机来，别照抄 20
max-players=6
# 别动：端口没冲突就别改，改了下游全要跟着改
server-port=25565
# 别动：留空表示监听所有网卡
server-ip=
# 改这里：有正版就保持 true；要关，先把白名单开起来
online-mode=true
# 改这里：只和熟人玩就 true，然后去玩家页把人加进来
white-list=true
enforce-whitelist=true
# 改这里：手机服先降到 6，还卡就降到 4
view-distance=6
simulation-distance=6
# 改这里：想一进服就能盖房子就设 0
spawn-protection=0

三个最常见的翻车现场#

现象	多半是	怎么改
改了端口，朋友连不上	隧道或映射还指着旧端口	把 FRP/路由器的本地端口同步过去，再重启
重启后白名单“没了”	只在玩家页拨了开关	在文件里写 `white-list=true`
关正版后朋友 OP 没了	离线模式算出的 UUID 变了	重新 `op` 一次，或改回正版验证

第三行值得多说一句：ops.json 是按 UUID 记人的。开正版和关正版，同一个名字会算出两个不同的 UUID，OP 身份和白名单记录都可能对不上。

上机自查

改完点过「停止」→「启动」，终端出现过 Done。
概览「服务器地址」里的端口，和你填的 server-port 一致。
多人列表里显示的是你写的 motd，不是 A Minecraft Server。
white-list=true 时，名单里至少有你自己。
文件里的等号、引号是英文半角，没有被全角符号整行废掉。

下一步#

网络、性能、资源包、RCON 这些会伤到服的键：server.properties 进阶项
只想查某个键的默认值和建议值：server.properties 全项速查表
白名单、OP、封禁怎么配合：白名单、OP 与封禁管理