sudo apt-get install -y autoconf libssl-dev
git submodule update --init --recursive
make build
fork from https://github.com/xzhovo/skynet-websocket-gate
编译 skynet:
git submodule update --init
cd skynet
make linux
启动命令：
./skynet/skynet etc/config.cfg
默认是 ws 协议，如果要改成 wss 协议，采用下面指令编译
make linux TLS_MODULE=tls
生成 wss 所需的密钥
-- gen cert and key
-- openssl req -x509 -newkey rsa:2048 -days 3650 -nodes -keyout server-key.pem -out server-cert.pem修改 service/main.lua 里的 protocol
local protocol = "wss"方案跟 xzhovo/skynet-websocket-gate 有点不同，为了支持 wss, 采用了转发的模式推送数据给客户端
往 gate 发送 response 数据后， gate 会转发给客户端。
skynet.send(gate, "lua", "response", fd, msg)xzhovo/skynet-websocket-gate 的方案有个隐患， agent 引用了 websocket.lua, 需要维护好 ws_pool 。
根据 mikewu86 的提议 issues#1 ，已经将 ws_gate 扩展为 master/slave 模式。
算法类似美团的 Leaf-segment 的数据库方案
已删除，请采用下面的雪花算法。
已删除。
lualib/zset.lua
- 声网 SDK 代码
3rd/agora: https://github.com/AgoraIO/Tools - lua 库代码
lualib-src/lua-agora.cpp
- 腾讯云 SDK 代码
3rd/tls-sig-api-v2: https://github.com/tencentyun/tls-sig-api-v2-cpp - lua 库代码
lualib-src/lua-tencentyun.cpp - 如果编译报错找不到 fmt 库，可以使用
git submodule update --init --recursive命令更新相关库
测试 SDK 使用下面的指令启动 skynet:
./skynet/skynet etc/config.test-sdk使用 lua 测试：
./skynet/3rd/lua/lua test/test-cjson.luaskynet 中直接用这个测试服务就行：
./skynet/skynet etc/config.test测试命令
./skynet/skynet etc/config.test-snowflake- 4096 个服务
- 单个服务 10 毫秒内可以生成 4096 个 ID
- 支持时间跨服 174 年
- 时间回拨检查
主要测试 http 的 get 和 post 如何使用，代码位置： lualib/qqapi.lua
目前就接了屏蔽字的接口： https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/sec-check/security.msgSecCheck.html
测试命令：
./skynet/skynet etc/config.test-qqapi如果是 https 接口，需要在配置中开启 ssl:
enablessl = true当然，编译 skynet 时也需要把 tls 编译进去：
cd skynet && make linux TLS_MODULE=ltls
- 使用 ShareTable 实现
- 参考这个讨论 discussions/1429
- 代码位置:
lualib/staticdata.lua
测试命令：
./skynet/skynet etc/config.teststaticdata然后在 30 秒内修改 data/test/data1.lua 和 data/test/data2.lua 文件内容。Excel 配置文件导出可以使用工具 hanxi/export.py 。
方案采用的是只使用 sharetable.query 接口更新本地引用，所以使用配置的地方都不能缓存配置数据，使用数据都需要从 root 取。
目前的方案只实现了手动调用 staticdata.update(arrlist) 接口实现热更配置。 可以优化成自动定时检测某个文件的时间，文件内容就是待热更的配置文件列表，以后有空再补上吧。
接口：
staticdata.preload()在 preload 中调用，用于给每个服务注册一个 debug 命令staticdata.init(servicekey)在使用配置的服务启动时调用，用于预加载所有需要的配置，servicekey用于标记服务使用了哪些配置文件，在data/service2datalist.lua中配置。staticdata.loadfiles()在进程入口调用，用于加载所有的配置文件staticdata.get(name)取配置数据，name为配置的文件名，不能缓存在本地，每次都需要重新读取staticdata.update(arrlist)热更配置，arrlist为待热更的文件列表
- 无侵入式修改
- 采用 inject 的方式
- 代码路径：
lualib/debug_console_inject.lua
使用示例：
local debug_console_inject = require "debug_console_inject"
local address = skynet.newservice("debug_console",8000)
debug_console_inject(address)inject 的代码是直接以字符串的形式写的，如果需要扩展大量命令则建议采用 debug_console 的 inject 命令读取文件的方式。
比如这样：
local skynet = require "skynet"
return function(address)
local filename = "lualib/debug_console_inject_source.lua"
local f = io.open(filename, "rb")
if not f then
skynet.error("Can't open " .. filename)
return
end
local source = f:read "*a"
f:close()
skynet.call(address, "debug", "RUN", source, filename)
end启动服务:
./skynet/skynet etc/config.cfg连接 debug console:
rlwrap nc 127.0.0.1 8000
Welcome to skynet console
stat
:00000004 cpu:0.000661 message:7 mqlen:0 task:0 xmem:48.40 Kb (snlua cdummy)
:00000006 cpu:0.000521 message:5 mqlen:0 task:0 xmem:44.22 Kb (snlua datacenterd)
:00000007 cpu:0.001139 message:5 mqlen:0 task:0 xmem:52.39 Kb (snlua service_mgr)
:00000009 cpu:0.001043 message:6 mqlen:0 task:1 xmem:57.96 Kb (snlua console)
:0000000a cpu:0.00356 message:16 mqlen:0 task:1 xmem:108.73 Kb (snlua debug_console 8000)
:0000000b cpu:0.000419 message:8 mqlen:0 task:0 xmem:44.92 Kb (snlua ws_watchdog)
:0000000c cpu:0.001591 message:23 mqlen:0 task:0 xmem:67.62 Kb (snlua ws_gate)
:0000000d cpu:0.00049 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-1)
:0000000e cpu:0.000633 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-2)
:0000000f cpu:0.000443 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-3)
:00000010 cpu:0.000564 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-4)
:00000011 cpu:0.000518 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-5)
:00000012 cpu:0.000437 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-6)
:00000013 cpu:0.000502 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-7)
:00000014 cpu:0.000417 message:6 mqlen:0 task:0 xmem:65.76 Kb (snlua ws_gate .ws_gate .ws_gate-slave-8)
:00000015 cpu:0.000663 message:8 mqlen:0 task:0 xmem:55.67 Kb (snlua web_watchdog)
:00000016 cpu:0.000974 message:5 mqlen:0 task:0 xmem:63.23 Kb (snlua web_agent http)
<CMD OK>示例中修改了 stat 命令，拼接了原有 stat 命令和 mem 命令的内容。
这个方法只建议在新增命令时使用，原有命令组合能实现的还是写另外的客户端脚本执行 http 接口来组合来实现。
一般用于排查 Lua 内存泄漏的问题。
代码在 3rd/lua-snapshot ，集成的代码在 lualib/extern_debug.lua ，专门用于扩展第三方 debug 命令。
当前的用法是采用按需注入的方式，遇到需要排查的服务时才对服务进行初始化额外的 debug 命令。
也可以按上面注入 debug_console 的方式新增一个额外的命令从 console 里动态使用。有需要的可以自己实现或者提 issues 。
参考 test/testexterndebug.lua 测试用例， 假设已经存在一个服务 test_service 的地址为 address :
接下来对其注入 debug 命令 SNAPSHOT , 使用 RUN 命令加载一段代码即可。
local source = [[
local extern_debug = require "extern_debug"
extern_debug.init()
]]
local ok, output = skynet.call(address, "debug", "RUN", source, "inject_extern_debug")
if ok == false then
error(output)
end
skynet.error(output)假设服务 test_service 有 tes1 和 test2 两个接口，这两个接口分别会给变量 t 新增两个元素 t.t1 和 t.t2 :
local function test_service()
local skynet = require "skynet"
local CMD = {}
local t = {}
function CMD.test1()
local t1 = {
a = 1,
b = 2,
}
t.t1 = t1
skynet.error("in test1")
end
function CMD.test2()
local t2 = {
c = 3,
}
t.t2 = t2
skynet.error("in test2")
end
skynet.dispatch("lua", function(_,source,cmd,...)
local f = CMD[cmd]
if f then
skynet.ret(skynet.pack(f(...)))
else
log.error(string.format("Unknown cmd:%s, source:%s", cmd, source))
end
end)
end使用接口测试，分别在调用 test1 前，调用 test1 后，调用 test2 后执行 SNAPSHOT 指令：
local ret0 = skynet.call(address, "debug", "SNAPSHOT")
skynet.error("ret0:", util_table.tostring(ret0))
skynet.call(address, "lua", "test1")
local ret1 = skynet.call(address, "debug", "SNAPSHOT")
skynet.error("ret1:", util_table.tostring(ret1))
skynet.call(address, "lua", "test2")
local ret2 = skynet.call(address, "debug", "SNAPSHOT")
skynet.error("ret2:", util_table.tostring(ret2))客户看出 test1 前快照表是空的， test1 后新增了 snapshot 相关变量以及 t1， test2 后新增了变量 t2 :
[:00000008] ret0: {}
[:0000000b] in test1
[:00000008] ret1: {["7f5067492b40"]={val_type="table",parent="7f5067492f00",extra="t1",key="t1",},["7f50674cc300"]={val_type="table",parent="7f5067493f80",extra="old_snapshot",key="old_snapshot",},["7f50674cc480"]={val_type="table",parent="7f506748b2c0",extra="_UBOX*",key="_UBOX*",},}
[:0000000b] in test2
[:00000008] ret2: {["7f50674a72c0"]={val_type="table",parent="7f5067492f00",extra="t2",key="t2",},["7f50674cc800"]={val_type="table",parent="7f5067493f80",extra="old_snapshot",key="old_snapshot",},}
[:00000002] KILL self运行测试
./skynet/skynet etc/config.testexterndebug代码实现： lualib/service.lua
atexit(func)接口用于注册服务退出时执行的函数，类似 C 语言的 atexit 接口，先注册的函数后执行exit(waittime, timeout1, timeout2)接口用于退出服务- waittime 等待退出时间（单位秒） 默认 0 秒
- timeout1 执行 atexit 的超时时间（单位秒） 默认 5 秒
- timeout2 执行 skynet.exit 的超时时间（单位秒） 默认 5 秒
./skynet/skynet etc/config.test-exit- test1 为正常退出的用例
- test2 为 timeout1 超时用例
- test3 为 timeout2 超时用例
一个基于 wlua 实现的排行榜，内核还是 skynet 的。 提供 http 接口使用。 地址： rank
如果是给 skynet 服务使用，可以考虑开启 cluster 端口，这样其他节点就可以很方便的调用了。
群号 677839887