Bridge 远程 CLI 项目
ProjectBridge是专有软件. 所有权利都保留;npm发布使得软件包可以安装,但不准许复制,修改,再发行,或创作衍生作品,除非是版权持有人单独授权.
安装和运行
npx --yes @brrew/projectbridge@latest remote --server https://YOUR-BRIDGE.example
要录取并让东道主坚持一步,运行:
npx --yes @brrew/projectbridge@latest remote --persistent --server https://YOUR-BRIDGE.example
在 Windows 上, 从高级管理员 PowerShell 上运行 。 它在 % ProgramData ProjectBridge 下安装了全机代理, 配置一个运行于 NT 的 AtStartup 任务为 NT 的 AUTHORITY\ SYSTEM, 并且不依赖于登录用户 。 Windows为初始安装需要Node.js 20+和npm. 如果Node.js仅在安装账户中可用,安装者会在程序Data下分出可执行的节点和npm,因此背景代理不依赖于该用户配置文件. 尽可能将现有的每个用户入学人数迁移到方案数据库。 在 macOS 和 Linux 上,持续的启动仍然被范围化到安装用户. 对于已经注册的宿主,单独的安装服务命令仍然可用.
只删除持久启动项( 保留入学证书) :
npx --yes @brrew/projectbridge@latest uninstall-service
如果仪表板取消了这个主机,则本地证书是故意的,不会被再使用. 开始新的、经仪表板核准的入学,并恢复持续启动:
npx --yes @brrew/projectbridge@latest reenroll --persistent --server https://YOUR-BRIDGE.example
命令使用已保存的服务器时 --server 被省略,停止旧的背景代理,请求新的一次性配对代码,并等待您在仪表盘中再次批准主机. 审批期间保持航站楼开放. 使用 reenroll 无 --persistent 仅在您想要前景连接时; 使用 reenroll --persistent 用于通常的安装器流.
要完全卸载本地代理, 背景启动, 保存证书, 并安装运行时间, 运行 :
npx --yes @brrew/projectbridge@latest uninstall --yes
交互运行请求确认, 除非 --yes 提供。 这只删除本地文件;它不会改变主机在ProjectBridge仪表板中的记录. 必要时另取出记录.
检查并安装最新 npm 发布到管理的运行时间 :
npx --yes @brrew/projectbridge@latest update
CLI 开始一个短寿命的入学请求,并要求您批准认证的ProjectBridge仪表板中的匹配主机. 在交互式安装期间,主机会显示一个 ASCII splash 屏幕并询问是否允许远程工具调用(y/N,默认编号。 柜台审批 单独核实和注册主机。 该代理人安全地存储了特定东道方的证书,发送经认证的最新健康信息,检查授权的任务,并报告限定的结果。 持续设置配置代理在背景中运行,并在中断后重新连接. 在运行期间,它定期检查更新情况,并利用包登记册的安全运输和完整性检查加以应用.
所需资源
- 节点.js 20+
- HTTPS 访问ProjectBridge服务器
- 用户必须签入 ProjectBridge 仪表板批准匹配的入学申请
ProjectBridge不默认选择服务器. 设定 --server https://YOUR-BRIDGE.example 命令,或设置 PROJECTBRIDGE_SERVER 在运行它之前。 选中的服务器会随本地注册而保存 。 现有注册继续使用所保存的服务器; 传递不同的 --server 对于一个已经注册的宿主来说,是安全失败的,而不是默默地重定向它. 只为了地方发展, http://localhost:8792 已接受。 设定 PROJECTBRIDGE_CONFIG 以覆盖每个用户配置路径; Windows 全机模式总是使用 %ProgramData%\ProjectBridge\remote.json。关于配对、心跳、任务投票和任务结果的请求将发送给选定的服务器。 代理检查 npm 用于软件包更新; npm 注册访问与ProjectBridge服务器连接分离.
MCP 工具名兼容性
MCP工具标识器由ProjectBridge MCP服务器提供,它与这个远程主机代理包是分开的. 当前服务器使用 pb_ 前缀(例如, pb_list_hosts, (中文(简体) ), pb_host_task,以及 pb_host_system_process_terminate) 保留在 MCP 客户端的 40 个字符工具名限制内。 更新此 npm 主机代理包不会替换 MCP 服务器; 更新/ 重新启动服务器安装 .
远程主机控制
在新安装时, 远程工具呼叫默认禁用, 除非安装者明确回答 y 迅速获得当地同意。 现有注册主机在迁移期间保持目前的同意,经确认后可从仪表板上启用或禁用 host.control.enable 编号 : host.control.disable 任务 :
npx --yes @brrew/projectbridge@latest remote-control status
npx --yes @brrew/projectbridge@latest remote-control enable
npx --yes @brrew/projectbridge@latest remote-control disable
启用时,一个已注册的主机可以提供有界限的文件系统列表/stat/read/search,原子文件写作和独有的文本补丁,目录创建,文件移动/删除, shell命令,以及交互式进程会话(启动/读取/输入/终止). 进程细节和已编辑的ProjectBridge配置视图也可用. shell 命令作为运行代理机的操作系统账户执行,该账户拥有权限;启用主机控制不会提升权限. 需要变异 confirm: true 在任务。 外壳输出和文件读取被绑定,主机文件读取可以以字节抵消来恢复并准确的 Base64 块有效载荷(散列范围被标签为文件或块),目录列表/搜索结果会暴露续作光标. 文件删除拒绝目录, 文件补丁拒绝模糊匹配 。 交互进程会话仅活到代理进程,重启后不恢复.
授权状态存储于主机的入学配置 remote_control_enabled (Windows全机模式与系统/管理员ACL在程序数据下存储);证书从未由 host.config.get安装器的本地 y otop- in允许运行代理机的OS账户下列出的工具; 它不会提升权限 。 Dashboard 批准录用主机,但不能代替当地选入。 一旦设备投入使用并启用了本地遥控器,即不经每个任务仪表板批准而发出改变国家的行动。 如果主机停止接受维护请求,则从仪表板上禁用主机控制. 持续运作取决于东道主支持的背景服务设施和配置.
可选REA工具
REA是可选的,在普通的ProjectBridge入学期间没有安装. 在项目Bridge主机注册后,使用:
projectbridge rea status
projectbridge rea install
projectbridge rea remove
在交互式终端中安装并删除确认请求 。 使用 --yes 只当您明确希望批准非互动操作时。 要在初始主机设置中选择, 添加 --with-rea 页:1 remote 或者说 install-service 命令。 没有这面旗帜,标准安装仍然无REA.
主机从认证的ProjectBridge工艺品端点下载一个被绑定的版本捆绑;它不安装 latest 直接从npm。 服务器必须先安装一个经批准的平台捆绑。 见寄存器的 docs/REA_DEPLOYMENT.md 用于发布中转和平台要求。 REA的外部分析提供者(Hopper,Ghidra,IDA,JADX,浏览器和JDK)仍然分别安装了可选的依赖性.