Eyun 文档

Appearance

Aid 本地代理部署 ​

Aid 本地代理用于让登录链路走你自己的网络出口。常见场景是账号常用地和平台线路不匹配，或者需要把微信登录固定在门店、办公室、家宽或同城设备上。

推荐顺序

普通用户优先使用 Windows 本地代理。需要长期在线、固定出口时，再部署 Linux 节点。

选择哪种 Aid ​

方式推荐对象适合放在哪里
Windows 本地代理客服、运营、测试人员办公电脑、门店电脑、家用电脑
Linux 固定节点需要长期在线的团队同城市服务器、家用电脑、自购盒子、办公室小主机、虚拟机

不建议普通云服务器

不要优先把 Aid 部署在普通云服务器上。云服务器出口 IP、带宽质量和登录城市经常不贴近微信账号常用环境，容易出现扫码异常、掉线或风控。

如果必须使用服务器，优先选择微信账号常用城市或同城网络环境。

Windows 本地代理 ​

下载 Windows 64 位工具，解压后打开程序，复制界面里的 Aid 编号。

系统下载地址
Windows 64 位wechat-AidNet-win64.exe.zip

在 获取登录二维码（Step 2） 中传入：

json
{
  "wcId": "",
  "deviceType": "ipad",
  "aid": "703314"
}

登录期间不要退出 Aid 工具。

Linux 一键部署 ​

Linux 版本适合把一台长期在线设备作为固定 Aid 出口节点。支持：

text
x86_64
aarch64 / arm64

要求：

text
Linux systemd 系统
root 权限或 sudo 权限
可以访问 https://aid.nodemsg.com

推荐命令：

bash
curl -sSL https://aid.nodemsg.com/releases/linux/install.sh | sudo bash

如果当前已经是 root 用户：

bash
curl -sSL https://aid.nodemsg.com/releases/linux/install.sh | bash

不需要安装 Node.js、frpc、gost，也不需要手动配置 token。

安装后会创建什么 ​

项目路径或服务
安装目录/opt/aidnet
数据目录/var/lib/aidnet
主程序/opt/aidnet/aidnet.js
本地后台/opt/aidnet/local-ui.js
专用 Node.js/opt/aidnet/bin/node
frpc/opt/aidnet/bin/frpc
gost/opt/aidnet/bin/gost
主服务aidnet.service
本地后台服务aidnet-local-ui.service
本地后台端口18080

脚本会自动注册 systemd 服务并启动：

bash
systemctl enable aidnet
systemctl enable aidnet-local-ui
systemctl restart aidnet
systemctl restart aidnet-local-ui

查看 Aid 编号 ​

安装完成后，Aid 编号会写入日志。

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

持续查看日志：

bash
journalctl -u aidnet -f

正常日志类似：

text
[reg] ✓ Aid 编号: 703314  port=23018
[status] ✓ 隧道已建立
[status] ✓ 就绪  Aid=703314  出口 → 本机 socks5

把 6 位 Aid 编号填到 Step 2 的 aid 参数里。

本地后台 ​

安装后会自动启动本地后台：

text
http://盒子IP:18080

例如：

text
http://192.168.1.20:18080

默认账号密码：

text
账号：admin
密码：123456

首次登录后建议修改密码。本地后台可以查看 Aid 编号、服务状态、日志，也可以一键诊断、复制诊断报告、重启 Aid 服务。

常用维护命令 ​

查看服务状态：

bash
systemctl status aidnet
systemctl status aidnet-local-ui

重启服务：

bash
systemctl restart aidnet
systemctl restart aidnet-local-ui

查看日志：

bash
journalctl -u aidnet -f
journalctl -u aidnet --no-pager -n 200
journalctl -u aidnet-local-ui -f

覆盖更新 ​

重复执行安装命令即可覆盖更新：

bash
curl -sSL https://aid.nodemsg.com/releases/linux/install.sh | sudo bash

覆盖更新会重新下载主程序、本地后台、frpc 和 gost。/var/lib/aidnet 会保留，机器 Aid 身份也会保留。正常情况下，Aid 编号不会变化。

客户端启动后会自动检查版本：

text
启动 30 秒后检查一次
之后每 6 小时检查一次

有新版本时会自动下载并重启服务。

技术侧验证 ​

查询自己机器的 Aid 是否可用：

bash
curl -s "https://aid.nodemsg.com/api/socks5?machine_id=机器ID" \
  -H "x-tenant-key: YOUR_TENANT_KEY"

返回 200 且包含 socks5 字段，说明这台 Aid 可用。开发者只能验证自己接入的机器，不提供全量节点列表。

json
{
  "code": "703314",
  "socks5": "socks5://703314@aid.nodemsg.com:1080",
  "machine_id": "gewe-xxx",
  "region": "江苏 徐州",
  "isp": "电信",
  "score": 95
}

常见不可用状态：

返回含义
offline客户端离线
cooldown节点暂时冷却保护

网络要求 ​

Linux 设备只需要正常出站，不需要公网 IP，也不需要端口映射。

需要能访问：

text
https://aid.nodemsg.com:443
aid.nodemsg.com:443
aid.nodemsg.com:1080

AidNet 是反向连接：

text
Linux 设备主动连接 aid.nodemsg.com
服务端通过反向隧道回连设备本机 socks5
取码程序统一连接 aid.nodemsg.com:1080

常见问题 ​

安装时提示需要 root 权限 ​

使用 sudo 执行：

bash
curl -sSL https://aid.nodemsg.com/releases/linux/install.sh | sudo bash

一直卡在下载 ​

先确认网络能访问安装脚本：

bash
curl -I https://aid.nodemsg.com/releases/linux/install.sh

如果连接失败，通常是 DNS 异常、出站 HTTPS 被拦截，或机器无法访问 aid.nodemsg.com。

安装后看不到 Aid 编号 ​

查看最近日志：

bash
journalctl -u aidnet --no-pager -n 200

也可以打开本地后台，点击“一键诊断”，把诊断报告发给技术支持。

服务异常退出 ​

先重启服务：

bash
systemctl restart aidnet

再查看状态和日志：

bash
systemctl status aidnet
journalctl -u aidnet --no-pager -n 300