Switch-LAN-Play 实用指南：从核心功能到定制配置

一、探索核心功能：构建虚拟局域网的技术架构

1.1 项目架构地图：理解代码组织逻辑

如何快速掌握项目的文件布局？Switch-LAN-Play采用模块化设计，主要包含以下关键区域：

• 基础组件层：base/目录提供字节序处理、日志系统等底层功能，如同建筑的地基结构
• 网络协议栈：lwip/实现轻量级TCP/IP协议，是数据传输的"高速公路"
• 客户端核心：src/包含局域网模拟、数据包处理等核心逻辑，相当于驾驶舱控制台
• 服务端系统：server/目录提供用户认证、连接管理功能，扮演交通管制中心角色

⚙️ 核心代码分布在src/gateway.cpp（网关管理）和server/src/udpserver.ts（UDP服务）等文件中，构成系统的"大脑中枢"。

1.2 核心引擎解析：定位服务启动入口

如何找到程序的启动点？项目采用双引擎设计：

• 客户端引擎：src/main.c是客户端启动入口，通过lan_play_main()函数初始化网络环境
• 服务端引擎：server/src/main.ts负责服务端启动流程，建立WebSocket连接池

🔧 启动流程关键路径：

1. 加载配置参数
2. 初始化网络接口
3. 建立加密通信通道
4. 启动事件循环监听

1.3 数据流转机制：数据包的"旅行"路线

游戏数据如何在虚拟局域网中传输？关键流程如下：

1. 本地捕获游戏流量（src/pcaploop.cpp）
2. 封装为自定义协议包（src/packet.c）
3. 通过UDP隧道传输（server/src/udpserver.ts）
4. 目标端解包还原（src/lan-client.c）

[!TIP] 抓包模块依赖libpcap库，需确保系统已安装对应开发包，否则会导致编译失败

二、掌握操作路径：从零开始部署服务

2.1 环境准备：搭建开发与运行环境

如何配置编译环境？需要准备这些工具：

• CMake 3.10+：构建系统生成器
• GCC 8.0+ 或 Clang 7.0+：C/C++编译器
• Node.js 14+：服务端TypeScript运行环境
• libuv、libpcap开发库：网络操作依赖

2.2 编译构建：生成可执行文件

编译步骤分客户端和服务端两部分：

客户端编译：

mkdir build && cd build
cmake ..
make -j4

服务端准备：

cd server
npm install
npm run build

2.3 基础启动：运行默认配置服务

如何快速启动服务？执行以下命令：

启动服务端：

cd server
npm start

启动客户端：

./build/lan-play --server your-server-ip:11451

[!TIP] 默认端口11451需在防火墙中开放UDP协议，否则客户端无法连接

三、定制系统配置：优化服务性能与安全

3.1 核心配置项解析：调整服务参数

服务器配置文件位于server/users.json，关键参数包括：

• 端口设置：port字段控制监听端口，推荐范围1024-65535，避开系统保留端口
• 连接限制：maxConnections建议设为50-200（根据服务器性能调整）
• 超时时间：timeout推荐值300秒（5分钟），过短可能频繁断开正常连接

3.2 配置项联动效应：理解参数间的影响

修改端口后需要同步调整的位置：

1. 服务器配置文件users.json
2. 防火墙规则（UFW/iptables）
3. 客户端连接命令中的端口参数
4. 路由器端口转发设置（如需要公网访问）

3.3 高级安全配置：保护你的虚拟局域网

如何提升服务安全性？

1. 启用认证：配置server/src/auth/目录下的认证模块，推荐使用JSONAuthProvider
2. IP白名单：在server/src/monitor.ts中添加IP过滤逻辑
3. 流量加密：修改src/rpc/rpc-ws-server.cpp启用WSS加密连接
4. 连接审计：开启base/llog.c中的详细日志记录功能

[!TIP] 避免使用简单密码或空密码！users.json中的密码需通过SHA1哈希存储，可使用src/sha1.c提供的哈希函数生成