一句话:它不是「优化器」,是仪表盘 + 体检大夫 —— 每 5 秒量一次服务器的脉搏,帧率掉了、实体堆爆了、内存涨疯了,它主动到控制台敲门;真需要动手时,它只做两件有风险的事(回收内存、清垃圾实体),而且这两件出厂都是关着的。
适合谁:自己开服、但不知道该盯哪些数字的服主。尤其是玩家一喊「卡」你就只能重启服务器的那种 —— 重启确实能好一阵,但你并不知道到底是内存、是实体、还是有人在刷东西。
为什么需要:原版 Rust 只会把错误写进日志,不会告诉你「现在该不该管」。帧率掉到 40,日志里干干净净;等你发现的时候,人已经跑光了。
技术底子:单文件 C#(Oxide / uMod),没有界面、没有图片。诊断部分零开销(只在现有循环里读数),GC 与清理都要授权才生效,两个默认都关。
先说清楚它能干什么、不能干什么。插件自己的报告里就写着这么一句:「帧率上限受单核性能限制,插件只能减负,不能凭空造性能。」 这句话是真的 —— 它不会让你的 40 帧服变成 100 帧。它能做的是:让你在服崩之前知道,以及在服开始卡之后知道该怪谁。
一、五块东西,只有两块会真的动手
| ① 采样 一直开着,只读 |
每 5 秒记一次:帧率、实体总数、托管堆、进程内存、在线人数。存够 24 小时给你画趋势 |
| ② 体检提醒 一直开着,只读 |
每 60 秒自查一次。踩到警戒线就把现象 + 影响 + 具体怎么做写进控制台;同类问题 30 分钟内不重复烦你 |
| ③ 智能 GC 默认关 · 要授权 |
托管堆超过阈值或帧率掉到线下,自动回收一次内存。一次回收会让服务器停约 0.4 秒 |
| ④ 实体清理 默认关 · 只能预览 · 要授权 |
清掉落物、尸体、死亡背包。出厂是「只预览不真删」,而且三类清理本身也全是关的 —— 想它动手,你得连开两道闸 |
| ⑤ 授权 软锁 |
没授权也能用:诊断报表全部照给,只有「手动回收」和「实体清理」被锁。断网 3 天内不影响 |
二、八条命令
控制台 / RCON 直接敲;游戏里用 /perf。权限统一是 serveroptimizer.admin(RCON 不需要权限,本来就只有你连得上)。
perfstat |
一行报数。日常看这一条就够了 |
perfreport |
完整诊断:帧率走势、实体构成、来源分组、区块热度、24 小时曲线、建议 |
perfwarn |
立刻体检一次,不等那 60 秒。也忽略冷却,该报的全报一遍 |
perfgc |
手动回收一次内存。会停约 0.4 秒,别在人多的战斗里敲 |
perfclean dry |
只扫描不删,把「本来会被删掉的东西」列出来。养成先敲这条的习惯 |
perfclean run |
真删。跳过「仅预览」这道闸,直接执行一轮 |
/perf /perf gc /perf warn |
游戏内聊天框版本,对着报表看完直接动手 |
serveroptimizer.auth <码>serveroptimizer.deauth |
激活 / 撤销本机授权。这两条现在要管理员权限 —— 之前没拦,玩家能把你授权码清掉 |
三、敲下去看到什么(真实回话)
这个插件没有面板,所以下面不放界面图 —— 直接把控制台里敲完屏幕上出现的原文贴出来,你照着对就知道自己那边对不对。以下全部来自一台真实在跑的服(1 人在线,地图 1000)。
日常看这一条
> perfstat 帧率 240.0 | 1分钟 239.9 | 实体 2319 | 堆 1424MB | 内存 4033MB | 在线 1 | GC 0 次
要判断问题在哪,看完整报告
> perfreport ========== 服务器性能诊断 ========== 已运行:36.3 小时 采样点:17280 间隔:5 秒 授权状态:已授权(全部功能生效) 码:PL-69Z2-****-FEKU 当前档位:空服 / 挂机(在线 1 人) 生效警戒线:帧率 <45 / 实体 >12000 / 托管堆 >2500 MB / 进程内存 >12000 MB 当前帧率:240.0 近 1 分钟:239.9 近 5 分钟:239.4 近 1 小时:239.4 实体数:2319 托管堆:1424 MB 进程内存:4033 MB 在线:1 人 最低帧率:237.2 低于 60 的采样:共 0 次,最近 1 小时 0 次 垃圾回收:尚未触发(阈值未到,属正常) 实体构成 Top8(共 2336 个): hemp-collectable:129 loot_barrel_2:95 wood-collectable:79 loot_barrel_1:77 crate_normal_2:74 metal_detector_source.entity:60 mp5.entity:46 oil_barrel:45 按来源分组: 地图自然生成:2295(98.2%) 载具:28(1.2%) 掉落物:11(0.5%) 玩家建造 / 放置:2(0.1%) 区块热度 Top5(实体最密的格子): D3:484 个 D4:333 个 E4:172 个 G6:169 个 C3:138 个 一小时内实体变化:2344 → 2319(-25 个) 24 小时走势(跨重启,共 5 个点,每存档间隔一个): 6 小时前:数据不足(历史点还没累积到这么早) 12 小时前:数据不足(历史点还没累积到这么早) 24 小时前:数据不足(历史点还没累积到这么早) 极值:最低 fps 238.0 / 最高实体 2345 / 最高堆 1315 MB 建议: · 实体数 2319,低于当前档位警戒线 12000,暂时不用清理 · 内存警戒线:托管堆 2500 MB / 进程 12000 MB · 每 5 分钟存盘可能卡 2~8 秒,人少时可把 server.saveinterval 从 300 调到 600 · 帧率上限受单核性能限制,插件只能减负,不能凭空造性能
清理之前先看清单
> perfclean dry [预览/手动] 扫描 2339 个实体,受保护跳过 118 个,没有符合清理条件的实体 —— 未真正删除(dry-run)。 【注意】掉落物 / 尸体 / 死亡背包这三类现在全部是关的,所以预览一定不命中——先把你要清的那一类改成 true(例如「实体清理:尸体」),再 perfclean dry 预览。确认无误后把「仅预览不真删」设为 false 才会真删。 已扫描(预览模式,未删除),结果见上方日志
注意第三条回话。旧版敲下 perfclean dry,控制台只回「已扫描,结果见上方日志」,然后日志里一个字都没有 —— 因为「实体总数够不够 5 万」这道判断排在预览前面,实体才 2000 多个的时候直接 return 了。你照着说明敲「先 dry 看看」的人,看到的是这个插件的沉默。1.2.1 把它修了:预览永远扫描,而且把「三类都关着所以必然不命中」这件事直说。
四、它自己也占资源,所以这次专门量了一遍
「优化插件」最容易翻车的地方是自己变成新的负担。所以拿同一台服、同一个进程(不重启),各取 60 秒读数,读 /proc/<pid>/stat 的第 14/15 字段(12 核,CLK_TCK=100):
| A:插件在跑 | 29.78 秒 CPU 时间 → 49.6% 单核 |
| B:插件已卸载 | 29.48 秒 → 49.1% 单核 |
| C:重新加载后 | 31.58 秒 → 52.6% 单核 |
三轮之间的差值是 2.0% 单核,折算整机 0.17%;而三轮本身的噪声就有 ±1.7%。所以诚实的结论只能写到这个程度:开销在 2% 单核以内这个量级,量不出更精确的数 —— 想知道精确值,得用 profiler,不是靠这个测法。
顺手还量出一件事,就是下面要修的第三条:旧版 oxide.unload 要 225 毫秒,全花在把 17,280 条采样序列化成 1.9 MB 的 JSON 上 —— 而那个文件从来没被读过。
五、1.2.0 → 1.2.1 修了什么(都有实测)
这个版本把体检挖出来的三个真问题修了,另外补了三块新读数。每一条都是先在现网复现、改完再跑一遍的,不是「看代码觉得有问题」。
| 七条命令对着所有人敞开 | perfgc / perfclean / serveroptimizer.deauth 等七条没有任何权限校验,只有 /perf 查了。玩家用 F1 自己发命令,就能:反复强制回收把服务器卡死、绕过 dry-run 直接删实体、把你的授权码清掉。现在:七条统一过 serveroptimizer.admin;被拒时同时回聊天框和写服务器日志(谁、什么时候、敲的哪条)。这条是真拦住了的 —— 同一台服、同一条 perfstat,12:30 正常返回「帧率 240.0 / 实体 2369」,把权限撤掉后 12:32 变成「没有权限:本命令仅限管理员(权限 serveroptimizer.admin)」,日志同步出现一行 [权限] 拒绝 … 执行 perfstat。 |
| 预览被阈值挡死 | 见上面第三节那条回话。说明文档教你「先 dry 看一眼清单」,实际 RunClean() 在「实体数未达 50000」处直接 return,dry-run 什么都没扫。现在:预览不受阈值限制,永远扫;三类清理全关时明确告诉你「所以一定不命中」。 |
| 1.9 MB 历史只写不读 | history.json 已经 1,922,448 字节、17,280 条采样,全代码里没有任何一处读它。每 10 分钟全量重写一次,卸载卡 225 毫秒,重启后又被覆写成几百字节。现在:改成每存档间隔存一个汇总点,启动时读回并丢弃过期点 —— 跨重启续接。文件 1.9 MB → 590 字节,卸载再也不出现慢卸载告警。 |
| 顺手收的四处 | ① /perf gc 绕过了授权锁(perfgc 有,聊天分支没有)→ 补上;② 上次回收时刻被写成未来时间,实际要等 3 个间隔才允许下一次(注释写的是 2 个)→ 拆成两个变量,判断改成「当前时间 > 下次允许时间」; ③ Process.GetCurrentProcess() 每 5 秒新建一个、从不 Dispose(一天 17,280 个句柄)→ 改静态缓存;④ 救急线 60 与告警线 45 打架(45~60 之间每 300 秒强回收一次但告警不响)→ 新增 gc_thrash:一小时内救急回收 ≥3 次而帧率仍低于救急线,直接告诉你「回收救不回帧率,瓶颈不是托管内存」,并建议把这条救急开关关掉。 |
六、这次新加的三块读数
原来只有「实体总数 2319」这一个数,知道多了但不知道多在哪。现在分三层看:
| 按来源分组 | 掉落物 / 尸体 / 载具 / 玩家建造放置 / 地图自然生成,各自数量和占比。 实测样例:地图自然生成 2295(98.2%)、载具 28(1.2%)、掉落物 11(0.5%)、玩家建造 2(0.1%)。一眼看出是地图本来就这么多,还是玩家堆出来的垃圾 —— 前者清不掉,后者该清 |
| 区块热度 Top5 | 按 146.2857 米标准网格统计,哪个格子实体最密。 实测样例: D3:484 个、D4:333、E4:172、G6:169、C3:138。垃圾堆在哪一格,直接给你坐标 |
| 24 小时走势 | 6 / 12 / 24 小时前的帧率与实体数对比,跨重启保留。数据不够时它写「数据不足」,不会拿最近的数冒充 |
另外还加了「一小时内实体增减」(2344 → 2319(-25 个))—— 这个数比总量有用得多:总量 2000 但一小时涨 500,比总量 8000 但一直不涨危险。
七、怎么装(3 步,2 分钟)
| 1 | oxide/plugins/ServerOptimizer.cs 丢进服务端的 plugins 目录 |
| 2 | 控制台执行 oxide.reload ServerOptimizer,日志出现 Loaded plugin ServerOptimizer v1.2.1 |
| 3 | 敲 perfstat 看有没有数;要开 GC / 清理就先 serveroptimizer.auth <你的授权码> |
权限怎么给:控制台 oxide.grant group admin serveroptimizer.admin,或者只给某一个人 oxide.grant user <SteamID> serveroptimizer.admin。不给也不影响 RCON 使用,只影响游戏内 F1。
关于配置里那两个你没见过的键:配置版本 Version 请勿手改 —— 它是用来判断「这是老配置还是新配置」的,插件靠它决定要不要给你补新增的默认值。权限:管理员(IsAdmin)直接放行 默认 true,意思是服主本人(owner / moderator)不用额外授权就能用;想收紧就改成 false,那样连服主也必须有 serveroptimizer.admin 才能敲。
八、用之前得知道的七件事
| GC 会让服务器停约 0.4 秒 | 这不是插件的锅,是回收本身要暂停。所以插件自己的说明里写着「别一上来就开智能 GC」。实测一次手动回收耗时 516 毫秒、托管堆 1338 → 952 MB |
| 帧率救不回来就别怪它 | 如果回收之后帧率还是低,说明瓶颈不在托管内存 —— 可能在实体、在某个插件、在单核性能。gc_thrash 就是专门提醒这一点的 |
| 清理有两道闸,出厂都关着 | 「实体清理总开关」默认 false,「仅预览不真删」默认 true,三类清理本身也全 false。想它动手,你得连开三道 —— 这是故意的 |
| 清理有 118 个实体永远跳过 | 玩家、载具、建筑、容器等受保护的不会被碰。实测「扫描 2339 个、受保护跳过 118 个」。它不会删掉你的家 |
| 警戒线会按人数自动放宽 | 1 人时实体线 12000,人多了往上抬(每人 +300 每 10 人一档,上限 50000)。所以同一台服不同时段看到的「档位」不一样是正常的 |
| 历史数据重启后不会攒满 24 小时 | 存档间隔是 5 分钟(跟 server.saveinterval 有关),跨重启能续接、但重启前那一小段会缺。刚装的服前几小时看到「数据不足」是正常的 |
| 没授权也能看报表 | 这是软锁:诊断、体检、报表全部照给,只有「手动回收」和「实体清理」被锁。先把报表看懂,再决定要不要买授权 |
九、常见问题
| 敲 perfstat 回「还没有采样数据」 | 刚加载,等 5 秒。采样间隔就是 5 秒,第一条数出来之前它没东西可报 |
| perfclean dry 什么也没列 | 两种可能:三类清理都关着(回话会直说),或者实体真的不到阈值。先看回话里那行【注意】 |
| 玩家敲 perfgc 能卡服吗 | 1.2.1 之后不能了 —— 七条命令都要 serveroptimizer.admin。如果你还在用 1.2.0 或更早,这是真漏洞,建议尽快换 |
| 体检提醒一直刷屏 | 同类提醒 30 分钟内不重复,健康状态 6 小时才报一次平安。真觉得烦,把「中文提醒:总开关」关掉,perfwarn 仍然能手动体检 |
| 换了机器授权还能用吗 | 授权是绑定机器的,换服要重新激活。断网 3 天内仍然能用本地凭据,第 4 天开始锁 GC 和清理 |
| 能替代性能分析工具吗 | 不能。它给的是「服务器现在什么状态、该不该管」,不给「哪一行代码慢」。要定位具体插件或函数,还得用 profiler |
一句话收尾:它的价值不在「优化」两个字上,而在把「服务器为什么卡」这件事从玄学变成数字:帧率多少、实体涨没涨、垃圾堆在哪一格、内存回收到底有没有用。你不需要它的时候它安静(2% 单核以内、无界面、无循环),你需要它的时候它能回答你 —— 就这样。至于它做不到的那件事,它自己也写在报告最后一行:「帧率上限受单核性能限制,插件只能减负,不能凭空造性能。」









