wa-app

wa-app 是 WA 应用链路服务，提供账号与资料管理、号码探测、注册、登录态检查、长连接会话、消息与联系人处理、账号在线态与转出检测，并内置管理 dashboard。

• 账号与资料：维护 WAAccount、客户端 profile、注册记录和登录态投影；支持资料编辑、头像、换绑号码，注册时从多机型画像池分配设备指纹。
• 号码与注册：支持号码探测、SMS 探测、注册请求、OTP 提交和登录态检查。
• 账号安全：两步验证（2FA PIN）状态管理与登录适配。
• 连接与消息：支持长连接会话、消息接收与 ack、1:1 文本消息发送、会话查看、联系人解析（usync）和头像拉取。
• 在线态与转出检测：账号在线态由长连接实况派生；转出/远程登出按 device_removed / device_logout 判定并周期复核，避免状态漂移。
• 数据提取：从消息中提取 OTP/Flag 候选值，并按敏感数据规则保存引用或脱敏投影。
• 管理界面：提供 dashboard，用于账号、联系人、消息、连接状态、安全和账号资料操作。

推荐使用本仓库提供的 Docker Compose 启动服务：

cp .env.example .env
docker compose pull
docker compose up -d

如果你只是本地快速启动，也可以直接 docker compose up -d（不创建 .env 也能启动，未配置值使用 compose 默认值）。

默认端口（固定）：

• Dashboard：http://127.0.0.1:8080（docker-compose.yml 映射）
• gRPC：127.0.0.1:50091

若你确实要改主机映射端口，请直接改 docker-compose.yml 的 ports 行（非配置项）。

.env 中保留少量运行必需配置：

• WA_APP_IMAGE_TAG：镜像标签，生产建议使用固定版本。
• WA_APP_AUTH_PASSWORD：可选 dashboard 单密码登录；为空则关闭鉴权。
• WA_APP_DATA_DIR：容器内持久化目录；默认 /var/lib/wa-app。
• WA_APP_PG_DSN：可选 PostgreSQL DSN；为空时使用内置 SQLite 持久化。
• WA_APP_REDIS_URL：可选 Redis URL；为空时使用内置 SQLite 运行态存储。
• WA_COMMON_PROXY：可选 WA 出站代理；配置后所有出站走该共享代理，为空则直连。
• WA_APP_DEVICE_PROFILES_FILE：可选设备画像池文件路径；为空时使用内置多机型画像。
• WA_APP_PLAY_INTEGRITY_API_URL / WA_APP_PLAY_INTEGRITY_API_TOKEN：可选 Play Integrity token service；两者都为空时注册页不显示选择控件并默认走 GPIA error_code。

PostgreSQL 和 Redis 都是可选组件。需要启用时，在 docker-compose.yml 中取消对应服务注释，并在 .env 中填写 WA_APP_PG_DSN / WA_APP_REDIS_URL。

Dockerfile 支持在 wa-app 仓库内直接构建，不依赖 common-lib 构建上下文：

docker build -t wa-app-service:local .

在 byte-v-forge 聚合目录构建也可用：

docker build -f wa-app/Dockerfile -t wa-app-service:local .

WA APK 逆向工程、字段形状对齐记录、patch 模板和本地分析脚本统一维护在私有仓库：

• https://github.com/byte-v-forge/wa-reverse

wa-app 只保留运行时代码和服务说明，不提交 APK、反编译产物、抓包、WAMSYS blob 或逆向记录。

• LINUX DO - 新的理想型社区