AID - QiWe API｜企微 API 开发文档

Aid 本地代理

登录走你自己电脑、盒子或手机的网络出口。适合账号常用地和平台线路不一致，或要固定在门店、办公室、家里。工具由第三方提供。

三种方式拿到的都是 6 位 Aid 编号。填进创建设备（步骤1）的 aid。从创建设备到扫码完成、账号在线期间，对应端的 Aid 不要关。

怎么选

三种方式流程相同，按你能长期开着的设备选一个即可。

Windows

首次测试、客服电脑、门店和家用电脑。解压即用，电脑开着才能在线。

Linux

长期在线、无人值守。用同城设备或盒子，不要优先用普通云服务器。

Android

手机流量或家里宽带当出口。

请求示例

三种方式填的字段相同。先拿到编号，再按这个 Body 创建设备。

Body

{
"method": "/client/createClient",
"params": {
"aid": "703314",
"deviceName": "我的iPad",
"deviceType": 0,
"clientVersion": ""
}
}

Windows

适合第一次测试，以及客服、门店、家里那台一直开着的电脑。64 位工具，解压就能用，不用安装。

下载并打开

下载压缩包，解压后打开主程序。本机防火墙若拦截，允许它出站访问 aid.nodemsg.com（443、1080）。

下载 Windows 64 位 Aid

等到 6 位编号

等待界面出现 6 位 Aid 编号，并显示就绪或隧道已建立。编号没出来前不要去创建设备。

填进请求

把编号填进 aid，按上面的请求示例调用创建设备（步骤1）。

扫码并保持运行

扫码登录。登录完成前不要退出程序；账号在线期间电脑也要开着，工具保持运行。

使用建议

电脑网络要在账号常用城市，或同城环境。不要用差很远的 VPN 出口。

登录过程中不要切换 Wi-Fi、VPN 或系统代理。

关掉休眠和自动关机。合盖、休眠、关机或退出工具后，Aid 会立刻离线。

这台电脑不能 24 小时开着时，改用 Linux。要用手机流量，改用 Android。

Linux

适合把一台长期在线的同城设备当成固定出口。可装在同城服务器、家用电脑、办公室小主机、虚拟机，或向客服买插电即用的盒子。不建议优先用普通云服务器：出口 IP 和常用地往往对不上，容易扫码异常或掉线。

确认环境

x86_64 或 arm64、带 systemd 的 Linux、root 或 sudo、能访问 https://aid.wkteam.cn。设备只要能出网，不需要公网 IP 或端口映射。

执行安装

已经是 root 时去掉 sudo。脚本会装好依赖并注册，不用手动配 token。

安装命令

curl -sSL https://aid.wkteam.cn/releases/linux/install.sh | sudo bash

取出 6 位编号

日志或本地后台都可以。也可以打开 http://设备IP:18080，默认账号 admin / 123456，第一次登录后立刻改密码。

从日志取编号

journalctl -u aidnet --no-pager | grep 'Aid 编号'

填进请求并保持运行

把编号填进 aid 并扫码。之后保持 aidnet 服务运行，不要删 /var/lib/aidnet（删了编号会变）。

使用建议

设备必须和账号常用地同城。云服务器只在同城、且你能接受风控风险时再用。

用网线，关掉休眠。盒子或小主机插上电和网即可长期跑。

更新直接再跑一遍安装命令，数据目录会保留，编号一般不变。

企业网若拦出站，放行 aid.nodemsg.com:443 和 aid.nodemsg.com:1080。

日常维护

systemctl status aidnet
systemctl restart aidnet
journalctl -u aidnet --no-pager -n 200

Android

适合用手机流量或家里宽带当登录出口。这是 安卓 Aid App，装一台手机就够。

安装 App

用 Android 手机打开下载页并安装。系统拦截时，允许「未知来源」后再装。

下载 Android AID App

等到 6 位编号

打开 App，等待界面出现 6 位 Aid 编号。把 App 加入电池白名单，不要进后台清理。

扫码并保持运行

扫码登录。完成前不要杀进程、不要切 Wi-Fi / 流量。出现滑块时，在这个 App 里完成。

使用建议

手机网络要在账号常用城市。家里宽带、门店 Wi-Fi、本机流量都可以，不要用差很远的热点。

登录过程中不要开关飞行模式，也不要在 4G 和 Wi-Fi 之间来回切。

国产手机默认会杀后台，请关闭该 App 的电池优化，并允许后台运行。

Android 不适合长期无人值守。要 7×24 在线，改用 Linux 或盒子。

排查

编号出不来、提示不可用或扫完就掉，先看这里。

看不到 Aid 编号

检查网络，重启工具，等显示就绪。Windows 看界面；Linux 执行 journalctl -u aidnet --no-pager -n 200；Android 把 App 拉回前台并检查流量。

登录提示 Aid 不可用

确认对应端还在运行，填的是当前界面上的 6 位，没有多复制空格。编号变了要用新的。

扫码后很快掉线

出口所在城市要接近账号常用地。登录后不要关 Aid：Windows 别休眠，Linux 别停服务，Android 别杀后台。

Linux 安装卡住或要 root

用带 sudo 的安装命令。下载失败时先执行 curl -I https://aid.wkteam.cn/releases/linux/install.sh 检查 HTTPS 和 DNS。