
Flowise Demo 跑通后别急着发截图用 cpolar 给同事远程验收 Chatflow 链路Flowise 最舒服的地方是可以把一个 LLM 对话链路拖出来、点几下就跑通。但我踩过一个很现实的问题本地 Demo 能聊不代表同事能验收。你把截图发过去对方看不到输入、输出、变量传递也看不到失败时是哪一个节点断了。更好的做法是Flowise 继续跑在本地只在验收窗口里用 cpolar 开一个临时 HTTPS 地址让同事直接打开页面测试 Chatflow。这篇不讲大而全的 AI 工作流平台对比只做一条能复现的链路本地启动 Flowise创建一个最小 Chatflow本机确认对话正常再用 cpolar 临时发给同事验收最后关掉公网入口。使用场景这套流程面向下面几类人已经用 Flowise 做了一个本地 AI 工作流 Demo需要让产品、测试或同事远程点开验收只想验证对话链路不想为一个 Demo 上云部署、买服务器、配域名和证书需要确认 Prompt、模型节点、变量传递、错误提示和返回内容而不是只看几张截图公司网络或家里网络没有公网 IP但需要临时给外部协作者一个 HTTPS 访问入口。边界场景也说清楚如果这是长期给客户用的生产服务应该做正式部署、账号鉴权、日志审计、速率限制和密钥管理。本文这套方案定位是“本地 Demo 的短时远程验收”。最终效果跑完后你会得到这样的链路同事浏览器 - cpolar 临时 HTTPS 地址 - 本机 Flowise Web UI / Chatbot 预览页 - Chatflow 节点 - LLM 模型接口 - 返回对话结果验收时同事可以直接做这些事打开你发过去的 HTTPS 地址进入 Flowise 的 Chatflow 页面或嵌入式 Chatbot 预览页输入测试问题检查回答是否命中预期帮你复测多轮对话、变量填充和异常输入验收结束后你关闭 cpolar 隧道公网地址立即不可访问。本文默认 Flowise 端口是3000cpolar 本地控制台端口是9200。环境准备你需要准备这些东西一台能联网的开发机macOS / Linux / Windows 都可以Docker Desktop或者 Node.js 18 及以上一个可用的 LLM API Key例如 OpenAI 兼容接口、DeepSeek、通义千问、硅基流动等已安装并登录的 cpolar浏览器可以访问http://127.0.0.1:3000和http://127.0.0.1:9200。先确认 Dockerdocker --version docker compose version如果你不走 Docker确认 Node.jsnode -v npm -vNode.js 可以使用 18、20 或 22 这类 LTS 版本。Flowise 版本更新比较快Node 太旧时最容易在安装依赖阶段报错。cpolar 安装入口走官方页面https://www.cpolar.com/download https://www.cpolar.com/docs/macOS 可以用 Homebrew 安装brew tap probezy/core brew install cpolarLinux 可以用官方安装脚本curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash安装后确认版本cpolar version如果你已经安装过 cpolar确保本地控制台能打开curl -s http://127.0.0.1:9200浏览器访问http://127.0.0.1:9200能看到 cpolar 控制台就说明后面可以创建隧道。用 Docker 启动 Flowise我通常先用 Docker 跑 Demo。原因很简单少折腾 Node 依赖本地环境也更干净。创建一个目录mkdir flowise-cpolar-demo cd flowise-cpolar-demo mkdir -p flowise-data直接启动 Flowisedocker run -d \ --name flowise \ -p 3000:3000 \ -v $PWD/flowise-data:/root/.flowise \ flowiseai/flowise:latest查看日志docker logs -f flowise看到服务启动后打开http://127.0.0.1:3000如果你希望给 Flowise Web UI 加一层最基本的用户名和密码可以用环境变量启动docker rm -f flowise docker run -d \ --name flowise \ -p 3000:3000 \ -v $PWD/flowise-data:/root/.flowise \ -e FLOWISE_USERNAMEadmin \ -e FLOWISE_PASSWORDChangeThisPassword_2026 \ flowiseai/flowise:latest这层密码不是完整的企业认证但做临时验收比裸奔强很多。密码不要用示例值换成你自己的强密码。用本地 npm 启动 Flowise如果你不想用 Docker也可以用 npm 跑。安装 Flowisenpm install -g flowise启动npx flowise start指定端口启动npx flowise start --PORT3000加基础登录FLOWISE_USERNAMEadmin \ FLOWISE_PASSWORDChangeThisPassword_2026 \ npx flowise start --PORT3000Windows PowerShell 写法$env:FLOWISE_USERNAMEadmin $env:FLOWISE_PASSWORDChangeThisPassword_2026 npx flowise start --PORT3000启动后同样访问http://127.0.0.1:3000创建一个最小 Chatflow这一步不要一上来就做复杂 Agent、工具调用、向量库和多分支。远程验收前先做一个最小链路方便定位问题。打开 Flowise 后新建一个 Chatflow放这几个节点Chat Input - Prompt Template - Chat Model - Chat Output不同 Flowise 版本的节点名称会有轻微变化思路保持一致输入节点接收用户问题Prompt 节点整理成模型提示词模型节点调用 LLM输出节点把回答返回给聊天窗口。Prompt Template 可以先写得简单一点你是一个项目验收助手。 请根据用户的问题用中文回答。 如果用户问到 Demo 的目标请说明这个 Flowise Chatflow 用来验证本地 AI 对话链路可以被远程访问和复测。 用户问题{question}模型节点里配置你的 API Key、模型名和 Base URL。以 OpenAI 兼容接口为例常见字段是API Key: 你的模型服务密钥 Model Name: gpt-4o-mini / deepseek-chat / qwen-plus / 你实际使用的模型 Base URL: 模型服务提供的 OpenAI-compatible 地址 Temperature: 0.3这里有一个小技巧验收 Demo 时把Temperature设低一点。回答更稳定同事复测时不容易每次都得到完全不同的内容。保存 Chatflow然后点击右上角的聊天预览输入这个 Demo 的验收目标是什么期望看到类似回答这个 Flowise Chatflow 用来验证本地 AI 对话链路可以被远程访问和复测。再测一个边界问题请用三句话说明这条链路里 cpolar 的作用。如果能正常返回说明本地 Chatflow 链路已经跑通。本地可访问入口先理清楚在开公网入口前先把本地入口拆清楚。Flowise 默认 Web UIhttp://127.0.0.1:3000cpolar 本地控制台http://127.0.0.1:9200你要映射的是 Flowise 的3000端口不是 cpolar 的9200端口。先在本机做一次检查curl -I http://127.0.0.1:3000能看到 HTTP 响应头就说明本地 Flowise 服务确实在跑。如果你用 Docker也可以检查容器docker ps --filter nameflowise到这一步再开公网入口排错会轻松很多。否则你很容易把“Flowise 没启动”误判成“cpolar 没穿透成功”。用 cpolar 创建临时 HTTPS 远程验收入口最短命令是cpolar http 3000启动后终端里会显示一个公网访问地址通常包含https://。把这个 HTTPS 地址发给同事即可。如果你更习惯 Web UI打开http://127.0.0.1:9200创建 HTTP 隧道时按下面填隧道名称flowise-demo 协议http 本地地址3000 域名类型随机域名 地区按你的账号和网络选择创建成功后到“状态 - 在线隧道列表”查看公网地址。把https://...这个地址发给同事。同事验收时让对方按测试问题清单走不要只随便问一句“你好”1. 这个 Demo 的验收目标是什么 2. 请用三句话说明这条链路里 cpolar 的作用。 3. 如果输入为空页面有什么反馈 4. 连续问两个相关问题回答是否能保持上下文 5. 输入一段很长的问题响应是否稳定如果你只想让同事看 Chatbot 预览不想让对方进入整个 Flowise 编辑界面可以在 Flowise 里打开该 Chatflow 的分享、嵌入或预览入口把具体路径发给同事。公网域名仍然来自 cpolar本质上还是映射本机3000端口。远程验收时怎么记录结果我通常会把验收结果按“输入、预期、实际、结论”记录下来。可以直接用这个表编号测试输入预期结果实际结果结论1这个 Demo 的验收目标是什么说明远程访问和复测 Chatflow返回目标说明通过2请总结 cpolar 的作用说明临时 HTTPS 入口返回三句话说明通过3空输入不崩溃有提示或无响应页面保持正常通过4连续追问上下文表现稳定返回连贯通过5超长输入不报 500返回可读回答通过这张表很土但很管用。因为 Flowise 这种可视化工作流验收重点不是“页面能打开”而是节点链路在真实输入下是否按预期工作。安全边界要提前说清楚cpolar 在这里的价值是临时提供 HTTPS 访问入口不是把你的 Flowise 变成正式生产系统。我会遵守这几条边界只在验收窗口开启隧道验收结束立即关闭Flowise 开启FLOWISE_USERNAME和FLOWISE_PASSWORD不要把模型 API Key 写进 Prompt 或聊天输出不要在 Demo 里放公司内部文档、客户数据、生产数据库连接串不要把 Docker Socket、数据库端口、SSH 端口顺手一起映射出去不要把 cpolar 的临时地址发到公开群、公开文章或工单系统同事验收时只给必要的人必要时约定验收时间窗口。如果你的 Chatflow 里接了 HTTP Request、数据库、文件读取、代码执行等节点安全边界要再收紧一层。远程验收前先关掉不需要的工具节点只保留本次要验收的对话链路。常见问题和排错1. 本地能打开 Flowise公网地址打不开按这个顺序查curl -I http://127.0.0.1:3000 curl -s http://127.0.0.1:9200如果3000本地不通先修 Flowise。Docker 场景看日志docker logs --tail100 flowise如果9200不通先确认 cpolar 服务已经启动。前台模式可以重新执行cpolar http 3000如果本地和隧道都正常但公网页面异常检查浏览器是否访问的是https://地址以及 Flowise 是否有反向代理 Host 校验或前端资源加载报错。2. 打开页面后提示登录但同事不知道账号密码这是正常的。你给 Flowise 加了基础登录同事需要账号密码才能进入。做法验收前单独发临时密码验收结束后重启 Flowise 并更换密码。Docker 重启示例docker rm -f flowise docker run -d \ --name flowise \ -p 3000:3000 \ -v $PWD/flowise-data:/root/.flowise \ -e FLOWISE_USERNAMEadmin \ -e FLOWISE_PASSWORDNewReviewPassword_2026 \ flowiseai/flowise:latest3. Chatflow 报 API Key 错误优先检查模型节点的 Credential 配置。排查点API Key 是否复制完整Base URL 是否填成模型服务要求的地址Model Name 是否存在账号余额、地域、模型权限是否满足本机网络是否能访问模型服务。可以用curl单独测模型接口。以 OpenAI 兼容接口为例curl https://api.openai.com/v1/models \ -H Authorization: Bearer $OPENAI_API_KEY你使用其他厂商时把域名和环境变量换成对应配置。4. 节点变量为空Prompt 里没有拿到用户输入这类问题通常不是 cpolar 的问题而是 Chatflow 节点连线或变量名不一致。检查这几项Chat Input 是否真的连到了 Prompt TemplatePrompt 里使用的变量名是否和节点输出一致你写的是{question}但节点实际传出的是input或其他字段保存 Chatflow 后是否重新打开预览测试。简单处理方式是先把 Prompt 改成只接收一个变量并在 Flowise 节点面板里确认变量名。5. 同事输入后一直转圈先看 Flowise 日志docker logs --tail200 flowise常见原因模型接口响应慢API Key 权限不足Chatflow 接了外部 HTTP 节点对方接口超时网络代理导致本机访问模型服务不稳定Prompt 太长模型端拒绝或等待时间过长。验收 Demo 时先用短 Prompt 和轻量模型把链路跑通后再加复杂节点。6. cpolar 提示登录实例超过限制不要在多个终端里同时启动多个cpolar http 3000。如果账号在多台设备上都在线也会触发限制。处理方式关闭其他终端里的 cpolar 进程到 cpolar 状态页检查在线设备只保留当前验收机器在线再重新创建 HTTP 隧道。cpolar 状态页https://dashboard.cpolar.com/status验收结束后怎么关闭公网入口如果你用的是前台命令cpolar http 3000在终端按Ctrl C隧道就会停止。如果你通过 Web UI 创建了隧道进入http://127.0.0.1:9200在隧道列表里停止或删除flowise-demo。Flowise 也可以一起停掉。Dockerdocker stop flowise彻底删除容器但保留数据目录docker rm -f flowisenpm 前台启动的 Flowise在终端按Ctrl C最后用手机流量或让同事刷新公网地址确认已经无法访问。这个动作很重要别让一个临时 Demo 入口在公网挂一整天。写在最后Flowise 做本地 AI 工作流 Demo 很快但验收这一步不能只靠截图。截图只能证明你这边打开过不能证明对方能复测也不能证明真实输入下节点链路稳定。我的习惯是本地先用 Flowise 把最小 Chatflow 跑通再用 cpolar 开一个短时 HTTPS 入口让同事按问题清单验收。验收结束马上关隧道把公网暴露时间压到最短。这套流程不复杂但能支撑 AI Demo 的交付闭环能跑、能聊、能远程复测也能及时收口。