Remote Bridge

轻量级远程命令执行网关，让 AI Agent 安全地在本地机器执行命令、传输文件。

🚀 一句话告诉 Claude

告诉 Claude 以下任一指令，它会自动操作：

当本机作为服务器：

作为 Remote Bridge 服务器启动，共享密钥是 8888

Claude 会：启动本地 Server → 打开 http://localhost:3000 → 等待客户端连接

当本机作为客户端（Daemon）：

作为 Remote Bridge 客户端启动，服务器地址是 ws://你的IP:3000/ws，共享密钥是 8888

Claude 会：启动 Daemon → 连接到远程服务器 → 等待执行命令

特性

• 远程命令执行，实时返回 stdout/stderr/exitCode
• WebSocket 双向通信，心跳自动重连
• 文件分块传输，最大 100MB
• 完整审计日志
• 命令黑名单 + 超时控制 + 速率限制
• 内置 Web 终端

快速开始

一行命令启动（npx）

无需克隆项目，有 Node.js 18+ 即可：

作为服务器：

npx remote-bridge-prod server --token=8888

访问 http://localhost:3000 打开 Web 控制台（默认账号：admin / admin）。

作为客户端（Daemon）：

# 在你想暴露给 AI 的目录执行
cd /path/to/your/project
npx remote-bridge-prod daemon --server=ws://服务器IP:3000/ws --token=8888

当前目录即为 Daemon 的工作目录，AI 可在此目录下执行命令、传输文件。

停止：

npx remote-bridge-prod stop server   # 停止服务器（读取 ./bridge.pid）
npx remote-bridge-prod stop daemon   # 停止客户端（读取 ./bridge-daemon.pid，需在启动目录执行）
npx remote-bridge-prod stop          # 省略时默认停 daemon

停止依赖启动目录下的 PID 文件，请在与启动时相同的目录执行；如自定义过 PID 路径，加 --pid-file=/path/to.pid。

Server（传统方式）

./server.sh          # 启动（自动安装依赖）
./server.sh stop     # 停止
./server.sh restart  # 重启

访问 http://localhost:3000/ 打开 Web 终端。

Daemon

Daemon 从当前目录启动，每个目录对应一个独立实例：

# 在任意目录启动
cd /path/to/your/project
/path/to/remote-bridge/daemon.sh          # 启动
/path/to/remote-bridge/daemon.sh stop     # 停止（需在同一目录执行）
/path/to/remote-bridge/daemon.sh restart  # 重启

多个目录同时启动多个 Daemon，前端下拉框会显示各自的目录名加以区分。

文档

• 架构设计 — 系统架构、通信协议、数据流
• API 参考 — 完整 API 文档和示例

配置

通过环境变量配置，详见 API 参考。

常用配置：

| 环境变量 | 默认值 | 说明 | |---------|--------|------| | SERVER_PORT | 3000 | Server 端口 | | AUTH_TOKEN | default-token | API Token | | BRIDGE_SERVER | ws://localhost:3000/ws | Server 地址 | | EXEC_TIMEOUT | 30000 | 命令超时（ms） |

许可

MIT © 2026