环境要求:

• Windows 系统: Windows 7 SP1 / Server 2008 R2 SP1 或更高版本 (推荐使用64位操作系统)。程序将作为系统服务运行，需要管理员权限进行首次安装。
• Linux 系统: 常见64位发行版。
  • GLIBC 版本硬性要求: 您下载的节点程序 (L4D2_Tool) 是预编译版本，它要求目标Linux系统的 GLIBC (GNU C Library) 版本为 2.35 或更高。主流发行版中，例如 Ubuntu 22.04 LTS (Jammy Jellyfish), Fedora 36+, Debian 12 (Bookworm) 等通常满足此要求。如果您在较旧的系统（如 CentOS 7, Ubuntu 20.04 LTS, Debian 11）上运行，可能会因GLIBC版本过低而无法启动。您可以使用命令 ldd --version 或 getconf GNU_LIBC_VERSION 来检查您系统的GLIBC版本。
  • 32位运行库依赖: 为了确保SteamCMD（用于安装/更新L4D2服务器文件）能够正常工作，您的Linux系统可能需要安装一些基础的32位运行库。常见的包括 libc6:i386, libstdc++6:i386 等。节点程序在启动时会尝试进行检测并给出相应的安装提示。
• 网络连接与防火墙： 节点程序需要稳定的互联网连接。请确保您的服务器防火墙已正确配置，允许以下端口的**入站TCP连接**：
  • 节点程序自身的服务端口（默认为 5000/TCP），用于接收来自前端管理界面的指令。
  同时，L4D2游戏服务器本身也需要相应的端口（如默认的 27015/UDP 用于游戏通信, 27015/TCP 可能用于RCON或查询）对外开放，具体取决于您的服务器配置。

节点程序安装与激活步骤:

1. 下载节点包： 登录本站后，从本页面上方根据您的服务器操作系统选择并下载对应的 "节点控制核心 (含设置令牌)" 压缩包。
2. 解压至专用目录： 将下载的压缩包完整解压到您服务器上的一个**永久的、独立的**目录。例如，Windows下可以是 C:\L4D2ManagerAgent\，Linux下可以是 /opt/L4D2_Tool_Node/。此目录将作为节点程序的工作目录。
3. 安装与运行节点程序：
   • Windows (作为服务安装):
     1. 以管理员身份打开命令提示符 (CMD) 或 PowerShell。 这是必需步骤。
     2. 使用 `cd` 命令进入您上一步解压程序的目录 (例如: cd C:\L4D2ManagerAgent)。
     3. 安装服务: 在命令行中执行以下命令来安装服务：

        .\L4D2ManagerAgent.exe install

     4. 启动服务: 安装成功后，执行以下命令启动服务：

        net start L4D2ManagerAgent

        服务将在后台静默运行，不会有任何可见的窗口。
     5. 服务管理: 您可以使用 net stop L4D2ManagerAgent 来停止服务，或通过 Windows 的服务管理器 (运行 `services.msc`) 进行管理。
   • Linux (使用脚本后台运行):
     1. 打开终端，导航到您解压节点程序的目录 (例如: cd /opt/L4D2_Tool_Node)。
     2. 重要：再次确认您的系统GLIBC版本满足 >= 2.35。
     3. 赋予可执行权限：

        chmod +x L4D2_Tool start_node.sh

     4. 启动程序： 我们强烈推荐使用随包提供的 start_node.sh 脚本来启动。执行命令：

        ./start_node.sh start

        此脚本会自动处理后台运行 (nohup) 和日志记录 (输出到同目录的 `node_nohup.out` 文件)。
     5. 脚本管理: 使用 ./start_node.sh stop 停止程序，./start_node.sh status 查看状态。
4. 首次激活与API密钥获取：
   • 节点程序首次成功启动时，会自动使用包内预置的设置令牌 (`.node_setup_token`)进行激活。
   • 激活成功后，节点会生成一个专用于前端通信的API密钥。请**查看日志文件**来获取这个密钥 (通常以 NODEUI_ 开头)。
     • Windows: 日志文件位于 C:\ProgramData\L4D2ManagerNode\l4d2_manager_node.log。(注意：`ProgramData` 可能是隐藏文件夹)。
     • Linux: 日志文件通常位于 ~/.local/share/L4D2ManagerNode/l4d2_manager_node.log。
   • 这是连接前端的关键，请务必从日志中复制并妥善保管这个密钥。
5. 配置前端管理界面进行连接：
   1. 从本页面获取并解压“管理前端界面”包，用浏览器打开 l4d2_manager_frontend.html。
   2. 在前端界面的 "节点列表" 或 "添加新节点" 中，填入：
      • 节点名称: 您自定义的名称。
      • 节点服务器地址: 运行节点程序的服务器IP或域名。
      • 节点服务端口: 默认为 5000。
      • 节点UI通信API密钥: 粘贴您上一步从日志文件中获取到的那个以 NODEUI_ 开头的密钥。
   3. 点击保存或连接。如果信息无误且防火墙已配置，前端界面即可成功连接到您的节点。
6. 开始您的服务器管理之旅！

重要提示与最佳实践：
- **数据持久化**: 节点程序的数据（配置、密钥、日志）都保存在其 `DATA_DIR` 中 (具体路径见启动日志)。请确保此目录在服务器重启或程序更新后能够保留。
- **资源权限**: 确保节点程序（运行它的用户身份，Windows上是`LocalSystem`）对其工作目录、计划安装L4D2服务器的目录以及SteamCMD目录拥有完整的读、写、执行权限。
- **定期更新**: 建议定期访问本站的下载页面，获取最新版本。节点程序也支持通过前端触发自我更新。