介绍
VRC-Notifier是一个专门为 VRChat 玩家设计的后台监控工具，它可以持续地在后台监控您所指定的好友的状态变化，比如上线信息、下线信息、状态切换信息、和世界切换信息，并通过邮箱 SMTP 服务或者 Gotify 等其他开源平台实时通知你。
功能
- 智能好友监控 - 选择性监控指定好友，而非全部好友列表
- 仅监控状态模式 - 无限制监控所有好友的在线状态，不监控世界变化
- 邮件通知 - 支持自定义 SMTP 服务器，实时接收状态变化通知
- Gotify 推送 - 支持开源推送平台 Gotify，手机实时接收通知
- 世界轮询 - 智能轮询机制追踪好友所在世界变化（标准模式）
- API 保护 - 多层限流保护机制，确保不触发官方 API 限制
- 防抖动机制 - 避免服务器抖动导致的误判，确保通知准确性
- 精美界面 - 现代化 Web UI，支持明暗主题切换
- Docker 支持 - 一键部署，支持 Docker Compose
- 国际化支持 - 中英双语翻译
使用
部署本项目，并启用本项目。在终端会收到访问密钥输入生成的访问密钥即可登录 VRChat 官方账号（账号不会明文保存，相关数据均已加密并保存在本地）。
进入好友列表，便会自动刷新一次好友列表，后面工具将不会主动地自动刷新以降低 API 的请求频率。刷新完后好友列表会进入六十秒等待期（不会调用任何 API），以防止用户在此多次频繁地使用 API 导致限流问题。
用户可选择标准模式和仅监控状态模式。标准模式会监控好友的世界信息，但最多只能监控五个好友；仅监控状态模式下可以监控所有好友，但无法监控他们的世界变化信息，两种模式均在关于按钮中呈现。
接下来用户只要配置 SMTP 服务或者 Gotify 服务或者 Webhook 服务就可以将好友状态及其变化推送到推送平台了。
快速开始
环境要求
- Node.js 18.0 或更高版本
- 支持的平台：Windows / macOS / Linux
安装步骤
方式一：直接运行
# 克隆仓库
git clone https://github.com/shanyaojinjn/vrc-notifier.git
cd vrc-notifier
# 安装依赖
npm install
# 启动服务
npm start
方式二：Docker 部署（推荐）
- 创建项目目录并进入
mkdir vrc-notifier && cd vrc-notifier
- 创建 docker-compose.yml 文件
version: '3.8'
services:
vrc-notifier:
image: crpi-tj1a3tjj9c5r6p8g.cn-hangzhou.personal.cr.aliyuncs.com/vrc-notifier/vrc-notifier:latest
container_name: vrc-notifier
restart: unless-stopped
ports:
- "5270:5270"
volumes:
# 数据持久化存储
- ./data:/app/data
environment:
- TZ=Asia/Shanghai
command: sh -c "apk add --no-cache tzdata && node server.js"
networks:
- vrc-network
networks:
vrc-network:
driver: bridge
- 启动服务
docker-compose up -d
- 访问服务
打开浏览器访问 http://localhost:5270 即可使用。
注意事项：
- 数据将保存在
./data目录中，请确保该目录有写入权限 - 如需停止服务，运行
docker-compose down - 查看日志：
docker-compose logs -f
机制与解答
我们有非常灵活的 API 调用机制，包含防 API 请求失误抖动机制纠错系统（三次防抖动纠错）、自动保护账号机制（触发限流之前底层自动保护）、世界信息轮询系统（以轮盘形式轮询以节省 API 使用）。工具兼容有 API 冗余，可与其他工具并存（如 VRCX）。
游戏并上线可能会使得本工具掉线，原因是因为 IP 发生变动等其他原因，再次登录即可。如果你先启动游戏再启动本工具即可规避这个问题（或保持 IP 统一）。如果出现无法加载的情况，请耐心等待或者更换网络环境（查看终端，看是否触发保护）。
| API 类型 | 官方建议 | 我们的限制 | 安全余量 |
|---|---|---|---|
| 用户资料 | ≤1 次/分钟 | 1 次/分钟 | 100% 合规 |
| 好友状态 | ≤5 次/分钟 | 2 次/分钟 | 60% 余量 |
| 世界信息 | ≤10 次/分钟 | 6 次/分钟 | 40% 余量 |
全局限流保护
当检测到限流触发时，系统会自动进入全局暂停模式：
- 自动暂停所有 API 请求 60 秒
- 向用户发送警告通知
- 前端显示实时限流状态
安全与隐私
本项目是一个需要自己部署的项目，请你选择安全的部署环境和平台以保障你的账号安全。相关数据工具已进行严格加密。如果服务器部署平台发生了问题，那么账号信息还是会有泄露风险，本工具尽可能保护帐号安全。
本项目有着非常严格的 API 请求规则。**如果触发 API 限流那么本工具会在触发之前便进行限流保护，如果触发次数过多，便自动停止该工具运行，以保障用户帐号安全。**如果用户不恶意进行高频次 API 请求，那么本工具将不会使得用户账号面临封禁危险。
注意
- 不要擅自部署到危险的平台上
- 不要恶意多次请求 API
- 不要拿本工具去恶意监视好友
更新
- 2026/3/2 修复在使用 Docker 部署时，无法正常调取时间的问题
开源协议
本项目基于 MIT 协议开源。
GitHub 仓库：https://github.com/shanyaojinjn/vrc-notifier Docker Hub：https://hub.docker.com/r/shanyaojinjin/vrc-notifier
