Remote Vibe Station

项目简介

Remote Vibe Station 是一个服务器优先的 AI 编程工作空间。它将 OpenCode 部署在可信的 Linux 主机上，通过 Docker 提供隔离的运行环境，用户可以从任何设备通过 Telegram 或浏览器访问和控制 AI 编程助手，整个项目采用 MIT 协议开源。

核心功能

• Telegram 一站式控制台：通过 Telegram 发送提示词、斜杠命令，接收进度流、审批提示、运行时通知和语音转录（由 Groq 提供语音识别支持）。
• Mini App 可视化操作界面：基于 React + Vite 构建的 Telegram Mini App，提供项目切换、文件浏览器、终端、Git 操作、容器控制、供应商设置和运行时更新等功能。
• 按需浏览器访问：通过 Traefik 转发认证生成有时限的浏览器链接，安全访问 OpenCode Web UI，无需暴露服务器端口。
• 多供应商模型网关：CLIProxy 聚合多个供应商账号（OpenAI 兼容接口），为 OpenCode 提供统一的模型目录，支持按需切换不同供应商。
• 基于镜像的运维：所有服务以 Docker 镜像方式发布，一键引导脚本完成整个技术栈部署，包含 TLS 证书配置、防火墙加固和 Docker 日志轮转。

技术实现

后端基于 NestJS 构建编排层，负责项目管理、提示词编排、会话管理和供应商偏好设置。消息层使用 Telegraf（Node.js Telegram 框架），接收用户指令并转发至后端，同时将后端的回复通过 outbox 机制推送至 Telegram。前端 Mini App 使用 React + Vite 开发，调用后端 REST API 和 SSE 实时事件流。反向代理层使用 Traefik，实现 TLS 终端、基于主机名/路径的路由以及 OpenCode 转发认证中间件。模型网关使用 CLIProxy，聚合多个供应商账号后暴露统一的 OpenAI 兼容接口供 OpenCode 调用。运行时以 Docker Compose 编排，各服务（bot、backend、miniapp、opencode、cliproxy、proxy）均为独立容器，通过网络卷共享项目文件。引导安装脚本（bootstrap-runtime.sh）在全新 Ubuntu/Debian 主机上自动完成 Docker 安装、主机加固（UFW、fail2ban）、证书申请和服务启动。

快速上手

1. 准备一台干净的 Ubuntu/Debian 兼容主机，确保有公网 IP 和域名（或使用 sslip.io 自动解析）。
2. 在 Telegram 通过 BotFather 创建一个 Telegram Bot，获取 Bot Token，并记录自己的 Telegram Chat ID 作为管理员 ID。
3. 在主机上运行一键引导脚本： curl -fsSL https://raw.githubusercontent.com/nyxandro/remote-vibe-station/master/scripts/bootstrap-runtime.sh | sudo bash -s -- --bot-token "" --admin-id "" --domain auto --tls-email "ops@example.com"
4. 脚本执行完成后，在 Telegram 向机器人发送 /start，按菜单引导完成初始化配置，即可通过 Telegram 提示词驱动 OpenCode 工作。

适用人群

• 需要在移动设备（手机/平板）上进行编程工作的开发者；
• 多人协作团队，希望在远程高性能服务器上统一运行编程环境的成员；
• 对本地算力不满意，希望利用远程服务器强劲 GPU/CPU 资源的 AI 编程用户；
• 重视代码隐私，不希望代码留在本地设备上，希望集中管控的开发者；
• 已有多个 AI 编程工具供应商账号，希望统一管理和切换的高级用户。