Lingti SDK

English | 简体中文

轻量级 C SDK，用于游戏流量隧道和网络加速，支持实时流量监控。

概览

Lingti SDK 是一套高性能网络隧道库，提供简单的 API，帮助游戏/应用快速接入网络加速能力，包含实时流量监控、智能路由和多平台支持。

安装

必要文件

源码仓库：https://github.com/ruilisi/lingti-sdk 预编译 DLL/lib 可在 GitHub Releases 获取：

• lingti_sdk.dll - 主库（13MB，运行时必需）
• lingti_sdk.lib - 导入库（8.6KB，MSVC 编译时使用）
• lingti_sdk.h - 头文件
• lingti_sdk.def - 模块定义
• lingtiwfp64.sys - Windows 驱动，需与可执行文件同目录

DLL 与 LIB

什么是 DLL？

**DLL（动态链接库）**文件（lingti_sdk.dll，13MB）包含所有实际编译的代码：

• 完整的 Go 运行时和垃圾回收器
• 所有 SDK 功能和业务逻辑
• 网络隧道实现
• 应用程序执行时在运行时需要

运行时要求： lingti_sdk.dll 必须在应用程序运行时存在。放置位置：

• 与 .exe 文件相同的目录（推荐）
• 系统目录（例如，C:\Windows\System32）
• 系统 PATH 环境变量中列出的任何目录

什么是 LIB？

**LIB（导入库）**文件（lingti_sdk.lib，8.6KB）要小得多，因为它只包含：

• 带有函数名称引用的存根代码
• 告诉链接器在 DLL 中查找函数的元数据
• 导入表信息

小尺寸（8.6KB vs 13MB）是正常和正确的！ 导入库只包含对 9 个导出函数的引用，而不是实际的实现代码。

编译时要求： lingti_sdk.lib 仅在使用 MSVC 编译/链接应用程序时需要。运行时不需要。

何时使用每个文件

| 文件 | 使用时机 | 用途 | |------|----------|------| | lingti_sdk.dll | 运行时（始终） | 包含所有实际代码，必须与应用程序一起分发 | | lingti_sdk.lib | 编译时（仅 MSVC） | 告诉链接器如何查找 DLL 函数 | | lingti_sdk.h | 编译时（始终） | 为 C 代码提供函数声明 |

编译器特定用法

MSVC（Visual Studio）：

# 编译需要 .lib 文件
cl your_app.c lingti_sdk.lib

# 运行时需要 .dll 文件与 .exe 在同一目录
your_app.exe    # 需要 lingti_sdk.dll 存在

MinGW/GCC：

# 可以直接链接到 .dll（不需要 .lib）
gcc your_app.c -L. -llingti_sdk -o your_app.exe

# 运行时需要 .dll 文件
./your_app.exe  # 需要 lingti_sdk.dll 存在

分发清单

分发应用程序时，包括：

• ✅ 编译后的 .exe 文件
• ✅ lingti_sdk.dll（13MB - 运行时必需）
• ✅ lingtiwfp64.sys（Windows 驱动 - 运行时必需）
• ❌ lingti_sdk.lib（最终用户不需要）
• ❌ lingti_sdk.h（最终用户不需要）

功能

• 简洁 C API - 简洁的接口，支持启动/停止服务管理
• 异步操作 - 后台线程中的非阻塞服务执行
• 实时监控 - 跟踪发送/接收的字节和数据包
• DNS 管理 - 内置 DNS 缓存控制
• 跨平台 - 支持 Windows（DLL）、Linux 和 macOS
• 加密配置 - 通过字符串或文件的安全加密配置
• 流量统计 - 字节和数据包级别的监控
• 错误处理 - 全面的错误码和消息

快速开始

最小示例（5 行）

#include "../lingti_sdk.h"
int main() {
    StartTun2RWithConfigFile("encrypted_config.txt");
    return 0;
}

基础用法

#include <stdio.h>
#include "../lingti_sdk.h"

#ifdef _WIN32
#include <windows.h>
#define SLEEP(ms) Sleep(ms)
#else
#include <unistd.h>
#define SLEEP(ms) usleep((ms) * 1000)
#endif

int main() {
    printf("Lingti SDK 示例\n");
    printf("==================\n\n");

    // 检查 SDK 版本
    char* version = GetSDKVersion();
    printf("SDK 版本: %s\n\n", version);
    free(version);

    // 加密配置文件路径
    // 有关加密详情，请参见 API.md
    const char* configFile = "encrypted_config.txt";

    printf("从配置文件启动服务...\n");
    int result = StartTun2RWithConfigFile(configFile);

    if (result != 0) {
        char* error = GetLastErrorMessage();
        printf("启动服务失败（代码 %d）：%s\n", result, error);
        free(error);
        return 1;
    }

    printf("服务启动成功！\n\n");

    // 检查服务状态
    if (IsServiceRunning()) {
        printf("服务状态：运行中\n\n");
    }

    // 监控流量 30 秒
    printf("监控流量 30 秒...\n");
    printf("按 Ctrl+C 提前停止\n\n");

    for (int i = 0; i < 30; i++) {
        unsigned long long txBytes, rxBytes;
        GetTrafficStats(&txBytes, &rxBytes, NULL, NULL);

        printf("\r[%02d/%02d] 发送: %llu 字节 | 接收: %llu 字节",
               i + 1, 30, txBytes, rxBytes);
        fflush(stdout);

        SLEEP(1000);
    }

    printf("\n\n");

    // 停止服务
    printf("停止服务...\n");
    result = StopTun2R();

    if (result == 0) {
        printf("服务停止成功！\n");
    } else {
        char* error = GetLastErrorMessage();
        printf("停止服务失败（代码 %d）：%s\n", result, error);
        free(error);
    }

    printf("\n示例完成。详细文档请参见 API.md。\n");

    return 0;
}

加密配置

SDK 仅支持加密配置以增强安全性。

获取加密配置的步骤：

1. 访问 https://game.lingti.com/sdk
2. 选择您的游戏（需要加速的游戏）
3. 选择您的隧道线路（线路）
4. 复制生成的 encrypted_config 字符串

encrypted_config 是一个 Base64 编码的字符串，包含所有必要的隧道设置。

点击下方图片打开生成页并下载配置：

API 参考

核心函数

• StartTun2RWithConfigFile(const char* configPath) - 从加密配置文件启动服务（base64 编码文本）
• StopTun2R(void) - 优雅地停止服务
• IsServiceRunning(void) - 检查服务是否正在运行

监控函数

• GetTrafficStats(...) - 获取当前流量统计
• GetSDKVersion(void) - 获取 SDK 版本字符串
• GetLastErrorMessage(void) - 获取最后一次错误消息
• FlushDNSCache(void) - 刷新本地 DNS 缓存
• RunPing(int intervalMilliSec) - 启动周期性 ping 监控
• StopPing(void) - 停止 ping 监控
• GetLastPingStats(...) - 获取 ping 统计信息
• GetConsoleConfig(...) - 获取控制台配置
• GetDeviceID(void) - 获取设备 ID

错误码

• LINGTI_SUCCESS (0) - 操作成功
• LINGTI_ERR_NULL_CONFIG (-1) - 无效/空配置
• LINGTI_ERR_JSON_PARSE (-2) - JSON 解析错误
• LINGTI_ERR_ALREADY_RUN (-3) - 服务已在运行
• LINGTI_ERR_LOAD_CONFIG (-4) - 加载配置文件失败
• LINGTI_ERR_NOT_RUNNING (-1) - 服务未运行

构建

使用 Makefile（推荐）

使用所有必需文件构建示例：

make example

这将创建一个 example/ 目录，其中包含：

• example.exe - 编译后的可执行文件
• lingtiwfp64.sys - Windows 驱动文件
• lingti_sdk.dll - SDK 库

清理构建：

make clean

Makefile 会自动检测您的平台：

• Windows：使用原生 gcc 或 MinGW
• Linux/macOS：使用 MinGW 交叉编译器（使用 brew install mingw-w64 安装）

手动编译

Windows（MinGW）

gcc your_app.c -L. -llingti_sdk -o your_app.exe

Windows（MSVC）

cl your_app.c lingti_sdk.lib

Linux/macOS（交叉编译）

x86_64-w64-mingw32-gcc your_app.c lingti_sdk.lib -o your_app.exe

Node.js 包 (lingti-sdk)（推荐）

Lingti SDK 的 Node.js 原生扩展（N-API），为游戏流量路由提供网络隧道功能。

前置要求

• Node.js >= 16.0.0
• 运行时要求：Windows 操作系统（SDK DLL 仅支持 Windows）
• 构建要求（仅 Windows）：
  • Visual Studio 2019 或更高版本，包含 C++ 构建工具
  • Python 3.x
  • node-gyp（作为依赖项自动安装）

安装

npm install lingti-sdk

使用方法

const lingti = require('lingti-sdk');

// 首先检查平台兼容性
if (!lingti.isAddonAvailable()) {
    console.log('平台:', lingti.getPlatform());
    console.log('此扩展需要 Windows 系统才能运行。');
    process.exit(1);
}

// 使用加密配置文件启动服务（base64 编码文本）
// 获取加密配置：访问 https://game.lingti.com/sdk
// 选择您的游戏（需要加速的游戏）和隧道线路（线路）
const result = lingti.startTun2RWithConfigFile('encrypted_config.txt');
if (result === 0) {
    console.log('服务启动成功！');
    console.log('SDK 版本:', lingti.getSDKVersion());
} else {
    console.error('启动失败:', lingti.getLastErrorMessage());
}

// 检查服务是否正在运行
if (lingti.isServiceRunning()) {
    console.log('服务正在运行');
}

// 获取流量统计
const stats = lingti.getTrafficStats();
console.log('发送:', stats.txBytes, '接收:', stats.rxBytes);

// 完成后停止服务
lingti.stopTun2R();

TypeScript 支持

该扩展包含完整的 TypeScript 类型定义：

import * as lingti from 'lingti-sdk';

// 使用加密配置文件启动服务
lingti.startTun2RWithConfigFile('encrypted_config.txt');

平台支持

• Windows：完全支持（原生 DLL）
• macOS/Linux：可以安装包，但不会构建原生扩展（仅 Windows DLL）

注意： 该包可以在任何平台上安装，但原生扩展仅在 Windows 上构建和工作。在 macOS/Linux 上，安装将成功完成但会跳过原生构建步骤。

示例

查看 examples/ 目录以获取完整的工作示例：

• sdk_example.c - 基本 SDK 使用演示
• sdk_example_min.c - 最小 5 行示例

许可证

专有软件 - Copyright (c) 2025 Ruilisi

版本

• 1.8.0(最新):
  • 大幅优化《流放之路2》等TCP游戏性能,采用位图算法精准计算UDP丢包率,实现更精确的实时丢包监控
• 1.7.3:
  • 修复《战意》等游戏的 ICMP Ping 问题，降低游戏代理的 CPU 占用
• 1.7.2:
  • 优化路由策略，显著提升 Apex 英雄、战地风云6、漫威争锋等游戏进入稳定性
• 1.7.0:
  • 大大降低了丢包率，UDP包较大的游戏实现0丢包(例如Apex和漫威争锋)
  • 大大降低了TCP大流量下载时的CPU和内存占用，CPU消耗降至优化前的15%
  • 大大增强了游戏流量代理的稳定性
• 1.6.2:
  • 添加 SetLogLevel API 用于运行时修改日志级别；
  • GetLastPingStats 现在返回 UDP 丢包统计。
• 1.6.1: 汇报UDP丢包统计。
• 1.6.0: 大大提升流量稳定性并降低丢包率。

演示视频

联系我们