GeWe开放平台
官方网站后台系统企业微信
官方网站后台系统企业微信
  1. 登录模块
  • 平台介绍
  • 快速开始 ⭐
  • Webhook
    • Webhook 事件 ⭐
    • 回调结构说明v1.0
    • 回调结构说明 v2.0
    • 调试指南⭐
    • 常见问题
  • API 参考
    • 登录模块
      • 获取登录二维码(步骤1)
        POST
      • 执行登录(步骤2)
        POST
      • 设置回调地址
        POST
      • 掉线重连
        POST
      • 弹框登录
        POST
      • Aid本地代理指南
        POST
    • 联系人模块
      • 获取通讯录列表
      • 获取通讯录列表缓存
      • 获取群/好友简要信息
      • 获取群/好友详细信息
      • 搜索好友
      • 添加联系人/同意添加好友
      • 删除好友
      • 设置好友仅聊天
      • 设置好友备注
      • 获取手机通讯录
      • 上传手机通讯录
      • 搜索企微
      • 添加企微好友
      • 同步企微好友
      • 获取企微好友详情
      • 检测好友关系
    • 群模块
      • 创建微信群
      • 修改群名称
      • 修改群备注
      • 修改我在群内的昵称
      • 邀请/添加 进群
      • 删除群成员
      • 退出群聊
      • 获取群信息
      • 获取群成员列表
      • 获取群成员详情
      • 获取群公告
      • 设置群公告
      • 同意进群
      • 添加群成员为好友
      • 获取群二维码
      • 群保存到通讯录
      • 管理员操作
      • 聊天置顶
      • 设置消息免打扰
      • 扫码进群
      • 确认进群申请
      • 解散群聊
    • 消息模块
      • 下载
        • 下载文件
        • 下载图片
        • 下载语音
        • 下载视频
        • 下载emoji
        • cdn下载
      • 发送文字消息
      • 发送文件消息
      • 发送图片消息
      • 发送语音消息
      • 发送视频消息
      • 发送链接消息
      • 发送名片消息
      • 发送emoji消息
      • 发送appmsg消息
      • 发送小程序消息
      • 发送定位
      • 转发文件
      • 转发图片
      • 转发视频
      • 转发链接
      • 转发小程序
      • 撤回消息
    • 朋友圈模块
      • 点赞/取消点赞
      • 删除朋友圈
      • 设置朋友圈可见范围
      • 是否允许陌生人查看朋友圈
      • 设置某条朋友圈为隐私/公开
      • 下载朋友圈视频
      • 发送文字朋友圈
      • 发送图片朋友圈
      • 发送视频朋友圈
      • 发送链接朋友圈
      • 上传朋友圈图片
      • 上传朋友圈视频
      • 转发朋友圈
      • 自己的朋友圈列表
      • 联系人的朋友圈列表
      • 某条朋友圈详情
      • 评论/删除评论
    • 标签模块
      • 添加标签
      • 删除标签
      • 标签列表
      • 修改好友标签
    • 个人模块
      • 获取个人资料
      • 获取自己的二维码
      • 获取设备记录
      • 隐私设置
      • 修改个人信息
      • 修改头像
    • 收藏夹模块
      • 同步收藏夹
      • 获取收藏夹内容
      • 删除收藏夹
    • 视频号模块
      • 关注
      • 评论
      • 浏览
      • 用户主页
      • 获取私信SessionId
      • 关注列表
      • 消息列表
      • 评论列表
      • 获取赞与收藏的视频列表
      • 搜索视频号
      • 创建视频号
      • 根据id点赞
      • 根据id点小红心
      • 获取我的视频号信息
      • 修改我的视频号信息
      • 发送视频号消息
      • 发送视频号朋友圈
      • 获取私信人信息
      • 发私信文本消息
      • 发私信图片消息
      • 扫码关注
      • 搜索并关注
      • 扫码浏览
      • 扫码评论
      • 扫码点赞
      • 扫码点小红心
      • 延迟点赞、小红心
      • 扫码登录视频号助手
      • 扫码获取视频详情
      • 我的视频号二维码
      • 上传CDN视频
      • 发布CDN视频
      • 发布视频-新
      • 同步私信消息
    • 账号管理
      • 账号密码登录
      • 检查是否在线
      • 退出
      • 设置代理
      • Mac转ipad接口
  • 账号与风控
    • 养号规范
    • 风险说明
    • 解封指南
  1. 登录模块

Aid本地代理指南

POST
Aid 本地代理部署
Aid 让微信登录链路走你自己的网络出口,适合账号常用地与平台线路不一致、或希望登录固定在某台设备(门店电脑、办公室、家里、同城盒子等)的场景。
部署完成后,在 获取登录二维码 或 弹框登录 接口传入 aid 即可接入。
重要:从发起登录到扫码完成、实例在线期间,请保持 Aid 客户端运行,不要关闭程序或退出服务。
接入流程(4 步)
  1. 部署 Windows 客户端 / Linux 节点,或向客服购买 Aid 专用盒子
  2. 从界面 / 日志 / 本地后台获取 6 位 Aid 编号
  3. 调用登录接口,填入 aid,并保留 regionId(建议与账号常用地同省)
  4. 扫码登录;实例在线期间保持 Aid 节点运行
选型建议:个人或临时使用优先 Windows 本地代理;需要 7×24 在线、固定出口的团队,部署 Linux 固定节点,或联系客服购买 Aid 专用盒子(插电、插网线即用)。
与其他网络方式对比
方式参数特点适用
地区代理regionId开箱即用快速测试
自定义代理proxyIp自行提供 SOCKS5已有代理资源
Ttuid 代理ttuid需配合工具,与地区/自定义联用中等稳定性需求
Aid 本地代理aid走本机真实网络,稳定性高长期在线、固定出口
代理形态怎么选
方式适合谁常见落点
Windows 本地代理客服、运营、测试办公室 / 门店 / 家里电脑
Linux 固定节点需长期在线的团队Aid 专用盒子、同城服务器、家用电脑、小主机、虚拟机
Aid 专用盒子(可选)
不想自己装机、配 Linux?可联系 GeWe 客服 购买 Aid 专用盒子:插上电源、连上网线即可,出厂已预装 Aid 节点。按下方「获取 Aid 编号」拿到 6 位编号后填入登录接口即可。
不建议优先部署在普通云服务器
云服务器出口 IP、带宽、所在地往往与账号常用环境不一致,易出现扫码异常、掉线或风控。如必须用服务器,请选与账号常用地同城的机器。
一、Windows 本地代理
下载 64 位客户端 → 解压运行 → 复制界面中的 6 位 Aid 编号 → 填入登录接口 aid 字段。
文件说明
gewe-AidNet-win64.exe.zipWindows 64 位,解压后运行主程序
Windows 网络要求
本机需能正常访问互联网,并允许客户端出站连接 aid.nodemsg.com(HTTPS 443、SOCKS 1080)。无需公网 IP 或端口映射。
请求示例(获取登录二维码)
{
  "appId": "",
  "type": "mac",
  "regionId": "320000",
  "proxyIp": "",
  "aid": "703314"
}
{
"appId": "wx_xxxxxxxx",
"regionId": "320000",
"proxyIp": "",
"aid": "703314"
}
aid 填客户端显示的 6 位编号;regionId 仍须填写,建议选账号常用地同省;type 支持 mac / ipad;使用 aid 时 proxyIp 留空即可。
二、Linux 一键部署
适合将长期在线设备作为固定 Aid 出口节点,安装后由 systemd 托管、开机自启。可自行在 Linux 设备安装,也可使用向客服购买的 Aid 专用盒子(插电、插网线即用,无需自行装系统)。
支持架构
  • x86_64
  • aarch64 / arm64
环境要求
  1. 带 systemd 的 Linux 系统(Ubuntu、Debian、CentOS 等)
  2. root 或 sudo 权限
  3. 可访问 https://aid.nodemsg.com
安装命令
若当前已是 root
无需单独安装 Node.js、frpc、gost,也无需手动配置 token,脚本会自动完成依赖与注册。
安装目录与服务一览
项目路径或服务
安装目录/opt/aidnet
数据目录(含 Aid 身份,勿删)/var/lib/aidnet
主程序/opt/aidnet/aidnet.js
本地后台/opt/aidnet/local-ui.js
专用 Node.js/opt/aidnet/bin/node
frpc / gost/opt/aidnet/bin/frpc、/opt/aidnet/bin/gost
主服务aidnet.service
本地后台服务aidnet-local-ui.service
本地后台端口18080
安装后自动注册并启动:
获取 Aid 编号
Linux 安装完成后编号写入日志,可用以下命令查看:
实时跟踪日志:
正常日志示例:
也可打开本地后台(见下节)直接查看编号。将 6 位编号填入登录接口 aid 参数。
本地后台(Linux)
安装后自动启动,浏览器访问:
http://设备内网IP:18080
例如 http://192.168.1.20:18080。默认账号 admin,密码 123456,首次登录请修改密码。
后台可查看 Aid 编号、服务状态、运行日志;支持一键诊断、复制诊断报告、重启 Aid 服务。
工作原理
Aid 采用反向隧道,本地设备无需公网 IP:
  1. 你的设备(Windows / Linux)主动连接 aid.nodemsg.com
  2. 服务端通过隧道回连设备本地 SOCKS5 代理
  3. GeWe 登录请求经 aid.nodemsg.com:1080 走你的网络出口完成取码
因此只要设备能正常出网即可,不需要在路由器上做端口映射。
网络要求
设备需能访问以下地址(出站):
  1. https://aid.nodemsg.com:443
  2. aid.nodemsg.com:443
  3. aid.nodemsg.com:1080
企业网络若有限制,请放行上述域名与端口,或联系网络管理员协助。
常用维护命令(Linux)
查看状态:
重启服务:
查看日志:
覆盖更新(Linux)
重新执行安装命令即可:
更新会重新下载主程序、本地后台、frpc、gost,但保留 /var/lib/aidnet 与 Aid 编号不变。
客户端启动约 30 秒后自动检查更新,之后每 6 小时检查一次;发现新版本会自动下载并重启。
技术侧验证(可选)
可用 API 查询某台机器的 Aid 节点是否在线(需向 GeWe 技术支持获取 Tenant Key):
machine_id 可在本地后台或安装日志中查看(格式如 gewe-xxx)。返回 HTTP 200 且 JSON 含 socks5 字段表示可用;仅能查询自己接入过的机器。
成功响应示例:
{
  "code": "703314",
  "socks5": "socks5://703314@aid.nodemsg.com:1080",
  "machine_id": "gewe-xxx",
  "region": "江苏 徐州",
  "isp": "电信",
  "score": 95
}
状态 / 返回含义
HTTP 200 + socks5节点在线可用
offline节点离线,检查客户端是否运行
not_found机器 ID 不存在或未接入
unauthorizedTenant Key 无效或缺失
使用注意
  • 一台 Aid 节点对应一个固定编号;重装系统或删除 /var/lib/aidnet 可能变更编号
  • 同一 Aid 编号可被多个登录请求引用,但出口网络始终是部署该节点的设备
  • 使用 aid 时建议同时填写与账号常用地相近的 regionId,不要与 proxyIp 混用
  • 实例掉线后重新登录,若 Aid 节点未变,可继续使用原编号
  • 更换 Aid 节点或出口网络后,建议用新账号测试或观察一段时间再用于生产账号
常见问题
安装时提示需要 root 权限?
在命令前加 sudo:
一直卡在下载?
先测试能否访问安装脚本:
连不上通常是 DNS 异常、HTTPS 被拦截,或机器无法访问 aid.nodemsg.com。
安装后看不到 Aid 编号?
查看最近 200 行日志:
或打开本地后台 → 一键诊断 → 将诊断报告发给技术支持。
服务异常退出?
先重启再查日志:
Windows 客户端已开,但登录仍失败?
确认界面显示「就绪」或隧道已建立;检查 aid 是否为当前界面 6 位编号;确认登录期间客户端未关闭;检查本机防火墙是否拦截出站连接。
登录后频繁掉线?
保持 Aid 节点持续在线;避免在登录后关闭客户端;检查部署设备网络是否稳定;如出口 IP 与账号常用地差异过大,考虑将节点部署在更贴近常用环境的网络。
如何卸载 Linux 节点?
如需彻底清除 Aid 身份,可额外删除 /var/lib/aidnet(删除后 Aid 编号将变更)。
最后更新:2026/7/6

请求参数

无

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://api.geweapi.com'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{}
修改于 2026-07-06 10:24:44
上一页
弹框登录
下一页
获取通讯录列表
Built with