Comfy Bridge：用 Android 手机远程控制本机 ComfyUI 工作流

平时使用 ComfyUI 时，我们往往需要一直坐在电脑前：打开工作流、上传参考图、调整参数、点击运行，再等待图片或视频生成。为了让这套操作更适合手机，我做了一个开源项目 Comfy Bridge。

它由一个运行在 Windows 电脑上的 Bridge Agent 和一个 Android App 组成。手机不直接连接 ComfyUI，而是通过 Agent 提交任务、查看进度和下载作品。这样既能隐藏复杂的节点编号和本机路径，也能把大型 ComfyUI 工作流变成适合手机操作的简单表单。

项目已经开源，代码、Android APK 和配套工作流都可以免费下载。

项目地址与下载

• GitHub 仓库：github.com/LLLimit/comfy-bridge
• 当前版本：Comfy Bridge v1.3.0
• 开源许可证：MIT（第三方工作流除外）

当前 APK 使用 Android Debug 证书签名，适合测试和手动安装，不是应用商店正式签名版本。如果安装更新时提示签名不一致，请先卸载旧测试版再安装。卸载前请自行备份需要保留的数据。

它是怎样工作的

整体链路如下：

Android App
    │
    │  HTTP / WebSocket
    ▼
Windows Bridge Agent
    │
    │  ComfyUI API
    ▼
本机 ComfyUI

各部分的职责很清楚：

• Android App：填写提示词和参数、上传参考素材、查看任务进度和作品；
• Windows Agent：设备鉴权、参数校验、工作流映射、任务管理和媒体存储；
• ComfyUI：加载模型和节点，真正执行图片或视频生成任务。

手机端不会接触 ComfyUI 节点 ID、完整工作流 JSON 或 Windows 文件路径。Agent 会读取 workflow-packs 中的配置，把复杂节点转换成动态表单。

主要功能

• Android 手机提交 ComfyUI 图片和视频任务；
• 根据工作流配置自动生成手机表单；
• 支持提示词、Seed、宽高、画面比例和视频时长；
• 支持多张参考图和多段参考音频；
• 通过 WebSocket 实时显示任务状态；
• 在手机上预览、保存或删除生成作品；
• Windows 图形控制台管理 Agent、ComfyUI 和可选 FRP 配置；
• 使用设备 Token 进行访问认证；
• 支持添加和适配更多 ComfyUI 工作流。

一、准备运行环境

电脑端建议准备：

• Windows 10 或 Windows 11；
• 已经能够正常出图或出视频的 ComfyUI；
• Python 3.12 或更高版本；
• 手机与电脑处于同一局域网，或者已经配置安全的远程访问通道。

如果只安装现成 APK，不需要在电脑上安装 Flutter。只有修改或自行编译 Android App 时，才需要 Flutter、Android SDK、JDK 和 ADB。

二、下载并启动 Windows Agent

可以在 GitHub 页面点击 Code → Download ZIP，也可以使用 Git：

git clone https://github.com/LLLimit/comfy-bridge.git
cd comfy-bridge

先启动 ComfyUI，确认浏览器中能够正常访问，例如：

http://127.0.0.1:8188

然后双击项目根目录中的：

start-agent.cmd

首次运行会在项目目录内创建 Python 虚拟环境，并把相关缓存放在项目的 .tooling 目录。完成后会打开 Windows 图形控制台。

在控制台中重点确认以下配置：

保存配置并启动 Bridge。控制台中显示服务正常后，请保持该窗口运行。

三、安装 Android App

从 v1.3.0 Release 下载：

comfy-bridge-1.3.0-arm64-release.apk

把 APK 发送到 Android 手机并安装。如果系统阻止安装，需要在 Android 设置中临时允许当前文件管理器或浏览器“安装未知应用”。安装完成后可以关闭这项权限。

当前 APK 面向 ARM64 Android 设备，最低支持 Android 7.0。

四、配置局域网连接

先查出 Windows 电脑的局域网 IPv4 地址，例如：

192.168.1.20

在手机 App 的“设置”中填写：

Agent 地址：http://192.168.1.20:8787
设备 Token：Windows 控制台中显示的 Token

保存后执行连接测试。如果连接正常，回到生成页面刷新工作流列表。

需要注意：

1. 手机和电脑必须位于同一个局域网；
2. Windows 防火墙需要允许 Agent 或 TCP 8787 端口；
3. 不要把 ComfyUI 的 8188 端口直接暴露给手机或公网；
4. Android 模拟器访问宿主 Windows 时，可以尝试 http://10.0.2.2:8787。

五、导入配套工作流

Release 中提供了三个可以拖入 ComfyUI 的画布工作流：

Z-Image 生图

用于文字生成图片，手机端可以填写提示词并调整宽高。原工作流来自 Bilibili UP 主 DragonBro。

MiniMax H3 文戏低配版

支持提示词、画面比例、像素量、视频时长、1～6 张参考图、1～3 段参考音频，以及可选二次采样。

MiniMax H3 文戏高配版

支持双阶段音视频生成、首尾帧、多参考图、多参考音频和高配分辨率倍数等参数。

MiniMax H3 两个工作流来自 Bilibili UP 主 Work-Fisher，原始分享视频：MiniMax H3 文戏工作流分享。

下载 JSON 后，可以直接拖入 ComfyUI 画布。工作流文件只包含节点与参数，不包含模型和自定义节点。如果 ComfyUI 提示缺少节点或模型，需要按照画布提示自行安装。

项目仓库中的 workflow-packs 还包含供 Agent 调用的 API 版本和手机表单映射。画布 UI 工作流与 Agent API 工作流用途不同，不要直接用普通画布 JSON 替换 Agent 的 workflow.json。

六、从外网连接电脑

局域网测试正常后，如果希望在外面使用，可以配置 HTTPS 反向隧道或 FRP。

推荐方案：HTTPS 反向隧道

推荐把一个 HTTPS 域名安全地转发到：

http://127.0.0.1:8787

例如使用 Cloudflare Tunnel 时，可以创建：

https://agent.example.com

然后在手机 App 中填写 HTTPS 地址和设备 Token。HTTP API 与 WebSocket 必须同时能够通过代理。

FRP TCP 方案

FRP 的几个端口不要混淆：

• 7000：frpc 连接 frps 的控制端口；
• 8787：Windows 本机 Agent 端口；
• 18188：示例公网远程端口，手机实际连接这个端口。

示例 frpc.toml：

[[proxies]]
name = "windows-agent"
type = "tcp"
localIP = "127.0.0.1"
localPort = 8787
remotePort = 18188

手机中填写：

http://你的域名或服务器IP:18188

这可以用于临时测试，但普通 HTTP 不会加密手机到服务器之间的 Token 和数据。长期使用应在公网服务器上通过 Nginx 或 Caddy 提供 HTTPS/WSS，再反向代理到 FRP 端口。

七、安全注意事项

Device Token 相当于 Bridge 的访问密码，请认真保护：

• 不要把 Token 上传到 GitHub、网盘截图或公开日志；
• 不要直接把电脑的 8787 和 ComfyUI 的 8188 端口暴露到公网；
• 跨公网连接优先使用 HTTPS/WSS 或可信 VPN；
• Token 泄露后立即重新生成；
• 从第三方获取工作流或自定义节点后，先检查来源再安装；
• 正式分发自己编译的 APK 时，应更换包名并配置正式签名。

项目源码不会提交设备 Token、FRP 凭据、签名密钥、生成作品、上传素材、数据库或本机 SDK 路径。

八、常见问题

手机无法连接 Agent

依次检查：

1. Windows 控制台中的 Bridge 是否正在运行；
2. 手机填写的是否为电脑局域网 IP，而不是 127.0.0.1；
3. 手机和电脑是否处于同一网络；
4. Windows 防火墙是否放行 8787；
5. Device Token 是否完整且没有多余空格。

能连接但没有工作流

检查项目根目录的 workflow-packs 是否存在，并重启 Agent。也可以先使用内置的 demo_image mock 工作流验证 App 与 Agent 的连接。

工作流运行时报缺少节点

Release 中的 JSON 不包含模型和自定义节点。请在 ComfyUI 中打开工作流，根据红色节点或缺失提示安装对应依赖。

任务提交成功但没有生成结果

查看 Windows Agent 控制台和 ComfyUI 控制台日志，确认 ComfyUI 地址正确、模型能够加载、显存足够，并检查输出节点是否与工作流包配置一致。

APK 无法覆盖安装

当前 APK 使用 Debug 签名。如果手机中已经安装了使用其他证书签名的同包名应用，需要先卸载旧版本。卸载会清除该 App 的本地设置，请提前记录 Agent 地址和 Token。

九、给开发者

项目主要技术栈：

• Android App：Flutter / Dart；
• Windows Agent：Python、FastAPI、WebSocket、PySide6；
• 协议：OpenAPI、JSON Schema；
• 许可证：MIT。

开发者可以新增 workflow-packs/<workflow-id>，通过 config.json 把 ComfyUI 节点输入映射为手机表单字段。完整结构和转换脚本都在 GitHub 仓库中。

写在最后

Comfy Bridge 的目标不是在手机上完整复制 ComfyUI 画布，而是把已经调试好的工作流变成随时可用的移动工具：手机负责输入参数和查看结果，电脑继续负责模型、节点与算力。

如果这个项目对你有帮助，欢迎到 GitHub 仓库 点 Star、提交 Issue，或者贡献新的工作流适配。

项目地址：https://github.com/LLLimit/comfy-bridge