rank.exe 程序配置#

rank.exe 是 ICFK 排位系统的数据采集端，负责读取你服务器的日志并上报到 squad.cyou。本文介绍如何正确部署它。

下载程序#

你必须先申请 API Key，获得批准后才能下载。下载入口在：

主站：个人中心 → 我的服务器 → "下载 rank.exe"
文件大小：约 15-25 MB（跟随版本）
格式：Windows x64 原生可执行文件

Linux 用户

目前 rank.exe 只提供 Windows 版本。Linux 服务器请使用 wine 包装运行，或等待 Linux 原生版本。需要 Linux 版本的用户可以向管理员反馈。

部署位置#

rank.exe 必须放在 Squad 服务器的 Logs 目录，与 SquadGame.log 同级。典型目录结构：

text
D:\SquadServer\SquadGame\Saved\Logs\
├── SquadGame.log              ← 游戏写出的实时日志
├── SquadGame-backup-*.log      ← 历史日志
└── rank.exe                   ← ★ 放这里

千万不要

不要新建 rank 或 squadrank 等子文件夹把程序塞进去
不要放在桌面或 C 盘某个临时目录
不要放在服务器根目录（不同面板对日志路径处理不一样）

违反以上任何一条都会导致程序找不到日志文件，日志会显示 未找到 SquadGame.log。

首次运行：生成配置文件#

双击 rank.exe
程序会在同目录下生成一个 config.json，然后自动关闭
此时目录结构变为：

text
D:\SquadServer\SquadGame\Saved\Logs\
├── SquadGame.log
├── rank.exe
└── config.json               ← ★ 新生成的配置文件

编辑 config.json#

用记事本或 VS Code 打开 config.json，把你的 API Key 填到 unique_id 字段：

json
{
    "unique_id": "SRV-A3F7K2M9"
}

字段说明#

字段	类型	必填	说明
`unique_id`	string	✓	你的 API Key，格式 `SRV-XXXXXXXX`，从主站"我的服务器"复制

这就是你需要改的全部

程序的上报地址、心跳间隔、日志解析参数等都是从云端在启动时拉下来的，普通用户不需要也不应该手工配置。如果未来版本引入新字段，新字段会有自带默认值，照常运行即可。

第二次运行：正式采集#

保存 config.json 后，再次双击 rank.exe。程序会：

读取 config.json，校验 API Key 合法性
扫描目录下最新的 SquadGame.log
监听日志实时追加，解析对局事件并上报

正常运行时窗口显示：

text
[2026-01-15 14:23:01] ICFK Rank Collector v1.x.x
[2026-01-15 14:23:01] unique_id: SRV-A3F7K2M9  ✓
[2026-01-15 14:23:01] 监听: D:\SquadServer\SquadGame\Saved\Logs\SquadGame.log
[2026-01-15 14:23:02] API 连接正常
[2026-01-15 14:23:02] 开始采集...
[2026-01-15 14:24:15] 新对局开始: Yehorivka AAS v1
[2026-01-15 14:31:22] 上报成功: 8 条事件

设置开机自启#

别手动点了。推荐两种方式：

方式 A：任务计划程序（推荐）#

Win+R 输入 taskschd.msc
创建任务 → 名称 ICFK Rank
触发器 → 计算机启动时
操作 → 启动程序 → 指向 rank.exe
条件 → 取消"只在交流会话时运行"

方式 B：ICFK 面板内建#

如果你用 ICFK 面板，在对应 Squad 实例的"附加进程"里添加 rank.exe 即可。面板会跟随实例启停自动管理 rank.exe，无需操心。

日志上报验证#

rank.exe 运行 5-10 分钟后，在 squad.cyou 的排行榜中应该能看到你服务器上的玩家数据出现。如果半小时还没数据：

看 rank.exe 控制台是否有红色报错
确认 API Key 在主站"我的服务器"里是 已通过 状态
检查服务器出站 HTTPS（443 端口）是否放行
仍然没头绪，把控制台截图发给主站工作人员

常见报错#

报错信息	原因	解决
`未找到 SquadGame.log`	没放对目录	移动到 Logs 目录下
`unique_id 无效`	Key 填错或被移除	检查拼写、登录主站确认状态
`API 连接失败`	服务器防火墙 / 没网	检查出站 443 端口
`版本过旧`	官方更新了协议	管理员在主页重新上传新版并通知下载

升级 rank.exe#

新版本 rank.exe 发布后，管理员会在首页发公告。升级步骤：

关闭正在运行的 rank.exe
重新下载新版（覆盖旧文件）
重新启动 rank.exe

config.json 不需要动，Key 继续用。

下一步：段位与积分体系 →