口袋觉醒服务端 Lua 代码加密完整教程：从 Luraph 混淆到 XXTEA 多层防护

在上一篇《口袋觉醒服务端 CSV 转 Lua 配置完整教程》中，我们已经学会了如何将修改后的 CSV 配置文件转换为游戏可识别的 Lua 格式。但明文 Lua 代码极易被反编译和篡改，这会导致你的游戏数值、核心逻辑甚至付费系统被破解，严重影响服务器的正常运营。

本文将为你详细讲解口袋新世纪 / 口袋觉醒服务端的 Lua 代码加密方案，重点介绍项目内置的 Luraph 混淆工具、拖拽式图形加密工具的使用，以及自制 XXTEA 加密的实现方法。通过本文，你将掌握从单文件加密到批量自动化加密的完整流程，为你的游戏代码构建坚固的防护屏障。

Lua 是一种解释型脚本语言，明文代码可以被轻易读取和修改。对于口袋觉醒这类卡牌游戏来说，未加密的代码会面临以下风险：

因此，所有发布到客户端和服务端的 Lua 代码都必须进行加密处理，尤其是核心战斗逻辑、付费系统和热更新文件。

口袋新世纪服务端默认使用Luraph Obfuscator v14.4.2作为主要的 Lua 加密工具。这是目前市场上最安全、最成熟的 Lua 混淆器之一，自 2017 年以来持续更新，能够有效抵御绝大多数逆向分析手段。

加密后的 Lua 代码会完全失去可读性，同时保留原有的功能：

-- This file was protected using Luraph Obfuscator v14.4.2 [https://lura.ph/]

return(function()local J,i,d,x,s,N,j,D,f,r,M,t,v=string.byte,string.sub,string.char,string.gsub,string.rep,setmetatable,pcall,type,tostring,assert,loadstring,unpack,{};
local function Rv(...)local a={...}local b=0;for c=1,#a do b=(b*31+a[c])%2^32 end return b end
-- 以下为混淆后的代码，完全无法直接阅读
{},0x1.5534389059696p7,Q,85,wb,t,0x1.f4e4ddbdc47d7p8,u),Rv(2,nil,nil,9,eb,7,wb,0x1.b2d4c90144444p8,O,u),u,u,u,u,u;do repeat if(not(Rv(6,O,4)))then
...

Luraph 提供了多层安全防护：

Luraph 提供在线版和本地版两种使用方式，推荐新手使用在线版。

如果你购买了 Luraph 专业版，可以使用本地命令行工具进行批量加密：

# 加密单个文件
luraph-cli -i cards.lua -o cards_obfuscated.lua

# 指定混淆级别
luraph-cli -i battle.lua -o battle_obfuscated.lua -l strong

# 批量加密目录
luraph-cli -d ./src -o ./src_obfuscated

Luraph 提供了 5 种混淆级别，不同级别在安全性和性能之间有不同的平衡：

口袋觉醒项目推荐配置：

为了方便新手使用，项目内置了一个拖拽式图形界面加密工具，集成了 Luraph 混淆和 XXTEA 加密两种模式，无需命令行操作。

除了 Luraph 混淆，我们还可以使用 XXTEA 加密算法对 Lua 文件进行二次加密。XXTEA 是一种轻量级分组密码算法，加密速度快，安全性高，并且被 cocos2d-x 引擎原生支持。

创建d:\KOAI\tools\lua_xxtea_encrypt.py文件，内容如下：

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# 口袋新世纪Lua XXTEA加密工具

import os
import sys
import struct

DELTA = 0x9E3779B9

def mx(y, z, sum, p, e, k):
    return (((z >> 5 ^ y << 2) + (y >> 3 ^ z << 4)) ^ ((sum ^ y) + (k[p & 3 ^ e] ^ z)))

def btea(v, n, k):
    if n > 1:
        y = v[0]
        sum = 0
        z = v[n-1]
        q = 6 + 52 // n
        while q > 0:
            sum = (sum + DELTA) & 0xFFFFFFFF
            e = sum >> 2 & 3
            for p in range(n - 1):
                y = v[p + 1]
                z = v[p] = (v[p] + mx(y, z, sum, p, e, k)) & 0xFFFFFFFF
            y = v[0]
            z = v[n-1] = (v[n-1] + mx(y, z, sum, n-1, e, k)) & 0xFFFFFFFF
            q -= 1
    elif n < -1:
        n = -n
        q = 6 + 52 // n
        sum = (q * DELTA) & 0xFFFFFFFF
        while sum != 0:
            e = sum >> 2 & 3
            for p in range(n-1, 0, -1):
                z = v[p - 1]
                y = v[p] = (v[p] - mx(y, z, sum, p, e, k)) & 0xFFFFFFFF
            z = v[n - 1]
            y = v[0] = (v[0] - mx(y, z, sum, 0, e, k)) & 0xFFFFFFFF
            sum = (sum - DELTA) & 0xFFFFFFFF
    return v

def str_to_long(s):
    n = len(s)
    pad = (4 - (n % 4)) % 4
    s = s + b'\x00' * pad
    result = []
    for i in range(0, len(s), 4):
        result.append(struct.unpack('<I', s[i:i+4])[0])
    return result

def long_to_str(v):
    result = b''
    for num in v:
        result += struct.pack('<I', num)
    return result

def encrypt_data(data, key):
    if len(key) < 16:
        key = key.ljust(16, b'\x00')
    key = key[:16]
    
    key_long = str_to_long(key)[:4]
    data_long = str_to_long(data)
    encrypted_long = btea(data_long, len(data_long), key_long)
    encrypted = long_to_str(encrypted_long)
    return encrypted

def encrypt_file(input_file, output_file, key):
    with open(input_file, 'rb') as f:
        data = f.read()
    
    encrypted = encrypt_data(data, key.encode('utf-8'))
    
    with open(output_file, 'wb') as f:
        f.write(encrypted)
    
    print(f"加密成功: {input_file} -> {output_file}")

def encrypt_directory(input_dir, output_dir, key, extension='.lua'):
    if not os.path.exists(output_dir):
        os.makedirs(output_dir)
    
    for root, dirs, files in os.walk(input_dir):
        for file in files:
            if file.endswith(extension):
                input_path = os.path.join(root, file)
                rel_path = os.path.relpath(root, input_dir)
                output_subdir = os.path.join(output_dir, rel_path)
                if not os.path.exists(output_subdir):
                    os.makedirs(output_subdir)
                output_path = os.path.join(output_subdir, file)
                encrypt_file(input_path, output_path, key)

def main():
    import argparse
    
    parser = argparse.ArgumentParser(description='口袋新世纪Lua XXTEA加密工具')
    parser.add_argument('-i', '--input', required=True, help='输入文件或目录')
    parser.add_argument('-o', '--output', required=True, help='输出文件或目录')
    parser.add_argument('-k', '--key', required=True, help='16位加密密钥')
    
    args = parser.parse_args()
    
    if len(args.key) != 16:
        print("错误：密钥必须为16位字符！")
        sys.exit(1)
    
    if os.path.isfile(args.input):
        encrypt_file(args.input, args.output, args.key)
    elif os.path.isdir(args.input):
        encrypt_directory(args.input, args.output, args.key)
    else:
        print("错误：输入路径不存在！")
        sys.exit(1)

if __name__ == '__main__':
    main()

要让游戏能够加载 XXTEA 加密后的文件，需要在 cocos2d-x 引擎中配置解密密钥：

配置完成后，游戏会自动解密 XXTEA 加密的 Lua 文件，使用方式和明文文件完全相同：

-- 加密后的文件仍然可以正常require
require "config.cards"
require "battle.damage"

每次修改完配置并转换为 Lua 后，按照以下步骤进行加密：

创建d:\KOAI\tools\encrypt_all.bat，实现一键自动化加密：

@echo off
chcp 65001 > nul
echo ========================================
echo   口袋新世纪Lua代码自动加密工具
echo ========================================
echo.

set PROJECT_DIR=D:\KOAI\MyLuaGame
set SRC_DIR=%PROJECT_DIR%\src
set OUT_DIR=%PROJECT_DIR%\src_encrypted
set XXTEA_KEY=koudai2024_secret
set LURAPH_LEVEL=medium

echo 第一步：加密配置文件（Luraph Light）
python tools\lua_encrypt_tool.py -i %SRC_DIR%\config -o %OUT_DIR%\config -l light

echo.
echo 第二步：加密核心逻辑（Luraph Strong）
python tools\lua_encrypt_tool.py -i %SRC_DIR%\app -o %OUT_DIR%\app -l strong
python tools\lua_encrypt_tool.py -i %SRC_DIR%\battle -o %OUT_DIR%\battle -l maximum

echo.
echo 第三步：XXTEA二次加密关键文件
python tools\lua_xxtea_encrypt.py -i %OUT_DIR%\battle -o %OUT_DIR%\battle_xxtea -k %XXTEA_KEY%

echo.
echo ========================================
echo   加密完成！输出目录：%OUT_DIR%
echo ========================================
pause

问题表现：游戏启动后黑屏或报错，提示无法加载 Lua 文件

解决方案：

问题表现：游戏运行不流畅，特别是战斗场景

解决方案：

问题表现：热更新后游戏报错，提示文件损坏

解决方案：

问题表现：无法使用调试工具查看变量和堆栈

解决方案：

根据文件的重要性和使用频率，采用不同的加密方式：

单一的加密方式很容易被破解，建议采用多层防护体系：

Lua 代码加密是保护口袋觉醒服务端安全的重要环节，但没有绝对安全的加密，我们能做的是尽可能增加破解的难度和成本。在实际运营中，应该平衡安全性和性能，避免过度加密影响游戏体验。

结合前两篇的 CSV 配置修改和 CSV 转 Lua 教程，你已经掌握了口袋觉醒服务端从配置修改到发布上线的完整流程。通过合理运用本文介绍的加密技术，可以有效保护你的游戏代码和知识产权，为服务器的稳定运营提供保障。