HoshizukiMio 6f9da1217a
Some checks failed
build / build (push) Has been cancelled
fix(sign): 签名带随机数,缓存会重放旧签名导致周期性掉线
反汇编 wrapper.node 的签名函数可见其调用 std::mt19937::_M_gen_rand;实测同一组
(cmd, seq, src) 每次输出都不同 —— 之前观察到的「确定性」其实是缓存造成的假象。

- sign.config.toml 默认 cache_size = 0(此前是 4096,正是掉线来源)
- 缓存条目加 TTL(cache_ttl_secs,默认 5s,0 表示不过期)
- 登录/续期类命令永不缓存(cache_exclude,默认 wtlogin. / trc.login / trpc.login)
- 补两个回归测试:登录命令绕过缓存、条目按 TTL 过期
2026-11-16 22:47:04 +08:00
2026-11-15 22:22:53 +08:00
2026-11-15 22:22:53 +08:00
2026-11-15 22:22:53 +08:00
2026-11-15 22:22:53 +08:00
2026-11-15 22:22:53 +08:00
2026-11-15 22:22:53 +08:00
2026-11-15 22:22:53 +08:00
2026-11-15 22:22:53 +08:00

qq-sign-server

LinuxQQ / NTQQ 的自建签名服务。

环境要求

  • Linux x86_64(原生签名只在 Linux 上可用)
  • Rust 1.82+(rustup 安装)
  • gcc(编译 symbols.c 桩符号库)
  • binutils(ar)、xz-utils(解包安装包)
  • patchelf(修补原生模块依赖)

Debian / Ubuntu:

sudo apt-get install -y build-essential binutils xz-utils patchelf

编译

git clone https://git.hoshizukimio.com/HoshizukiMio/qq-sign-server.git
cd qq-sign-server
cargo build --release

产物:target/release/qq-sign-server。

单元测试:

cargo test

只做类型检查(不产出二进制,适合在非 Linux 主机上验证代码能编过):

rustup target add x86_64-unknown-linux-gnu
cargo check --target x86_64-unknown-linux-gnu --all-targets

准备运行时文件

服务运行需要客户端自带的原生模块 —— 本仓库不包含、也不分发任何客户端文件,请从你手上的 安装包中取出并修补:

# 1) 取出包装器模块
ar p linuxqq.deb "$(ar t linuxqq.deb | grep -E '^data\.tar' | head -n1)" \
  | tar -xJ ./opt/QQ/resources/app/wrapper.node -O > wrapper.node

# 2) 去掉服务端用不到的依赖,补上 C++ 运行库与桩符号库
patchelf \
  --remove-needed libbugly.so \
  --remove-needed libX11.so.6 \
  --remove-needed libX11-xcb.so.1 \
  --remove-needed libXext.so.6 \
  --remove-needed libvips-cpp.so.42 \
  --add-needed libstdc++.so.6 \
  --add-needed libsymbols.so \
  wrapper.node

# 3) 编译桩符号库(源码见本仓库 symbols.c)
gcc -std=c99 -shared -fPIC -O2 -o libsymbols.so symbols.c

# 4) 写下构建号,服务启动时会用它做一致性校验
printf '%s' '<x.y.z-build>' > wrapper.version

Docker 构建

docker build -t qq-sign-server \
  --build-arg QQ_VERSION=<x.y.z-build> \
  --build-arg QQ_DEB_URL=<linuxqq .deb 直链> .

镜像里已完成解包、patchelf 与桩符号库编译,运行:

docker run -d --name sign -p 127.0.0.1:8080:8080 qq-sign-server

或者用 compose(先在 docker-compose.yml 的 build.args 里填好 QQ_DEB_URL):

docker compose build

许可

AGPL-3.0-only,见 LICENSE 与 NOTICE。

Description
Self-hosted LinuxQQ / NTQQ sign server: runtime offset detection, Lagrange V2 (yogurt/acidify) compatible
Readme AGPL-3.0 247 KiB
Languages
Rust 96.3%
Dockerfile 2.9%
C 0.8%