拳皇 1.68 出招表本地部署安装指南与验证手册
本手册专为实施工程师编写，确保拳皇 1.68 出招表在 1 小时内完成从零搭建至上线运行。
环境要求表
| 项目 | 最低要求 | 建议值 | 不满足会怎样 |
|---|---|---|---|
| 操作系统 | Windows 10 / CentOS 7 | Ubuntu 20.04 LTS | 路径解析错误，脚本执行失败 |
| 内存 | 2GB | 4GB | 数据加载卡顿，服务无响应 |
| Node.js | v14.x | v18.x LTS | 依赖包安装失败，语法不兼容 |
| 端口 | 8080 | 8080 / 80 | 端口冲突，服务启动报错 |
装之前先确认
- [ ] 磁盘空间剩余大于 2GB（拳皇 1.68 出招表需存储离线数据库）
- [ ] 网络防火墙开放 TCP 8080 端口
- [ ] 内核版本 >= 3.10（Linux 环境下防止 I/O 阻塞）
- [ ] 权限账号拥有 sudo 或管理员权限
未满足上述硬件指标强行部署将导致服务启动后频繁崩溃。
安装步骤
- 初始化目录：执行
mkdir -p /opt/kof168/data并建立数据文件夹。 - 克隆仓库：运行
git clone https://github.com/kof-offline/1.68.git /opt/kof168/src获取核心代码。 - 安装依赖：进入目录执行
cd /opt/kof168/src && npm install，预期输出显示 "added 128 packages"。 - 构建静态资源：执行
npm run build，生成 dist 文件夹。 - 启动服务：运行
npm start -- --port 8080。
配置项说明
| 配置项 | 作用 | 默认值 | 建议值 | 改错的影响 |
|---|---|---|---|---|
| server.port | 监听端口 | 8080 | 8080 | 端口被占，服务无法绑定 |
| db.path | 数据库存储路径 | ./data/db.json | /opt/kof168/data/db.json | 写入权限拒绝，进程崩溃 |
| cache.ttl | 缓存失效时间 | 3600 | 7200 | 查询延迟增加，内存占用降低 |
首次启动与验证
定义：拳皇 1.68 出招表本地化服务是指将角色技能数据预加载至本地缓存，它的关键区别在于离线可用性和低延迟响应。
执行 curl http://localhost:8080/api/verse/1。预期输出 JSON 格式的角色列表，包含草薙京、八神庵等 ID。
若返回 { "code": 200, "msg": "success" }，则确认拳皇 1.68 出招表环境已就绪。
升级与回滚
升级：拉取最新代码 git pull 后，执行 npm run build。注意：升级前备份 /opt/kof168/data/db.json。
回滚：停止服务 npm stop，执行 git checkout tag/1.68.0，然后 npm install。
卸载与清理
- 停止进程：
kill -9 $(lsof -t -i:8080)释放端口。 - 删除文件：
rm -rf /opt/kof168移除程序目录。 - 清理缓存：
rm -rf ~/.npm/_cacache清除 Node 缓存。
装不上时先看这几条
- 检查 SELinux 状态，CentOS 系统需关闭或配置策略。
- 检查 port 8080 是否被其他进程占用：netstat -tulpn | grep 8080。
- 检查 Node 版本是否过旧：node -v 必须 >= v14。
- 确认磁盘空间：df -h 查看 /opt 分区剩余空间。
常见问题
Q: 启动后端口 8080 无法访问？
A: 检查防火墙设置，运行 iptables -F 或配置 firewalld 放行 TCP 8080。
Q: 数据加载不出来？
A: 确认 db.json 文件存在且包含有效 JSON 格式，权限需设为 644。
Q: npm install 超时？
A: 配置 npm 镜像为淘宝源：npm config set registry https://registry.npmmirror.com/。
