Pixelle-Video 的 Docker 部署如何配置 ComfyUI 连接地址访问宿主机服务？

Pixelle-Video 的 Docker 部署如何配置 ComfyUI 连接地址访问宿主机服务【免费下载链接】Pixelle-Video AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video如果你用 Docker Compose 部署了 Pixelle-Video而图像/视频生成所依赖的 ComfyUI 是跑在宿主机容器外面上的那么默认配置里的http://127.0.0.1:8188会指向容器内部而不是宿主机连接自然不通。这篇文章解决的就是这个问题把config.yaml中的comfyui_url改成容器能访问到宿主机的地址让 Docker 部署的 Pixelle-Video 正确连上宿主机上的 ComfyUI 服务。适用前提宿主机已安装 Docker 和 Docker Compose宿主机上已安装并启动 ComfyUI默认运行在http://127.0.0.1:8188你选择的是本地 ComfyUIselfhost 工作流方案而不是 RunningHub 云端工作流。准备工作在宿主机上启动 ComfyUIComfyUI 不需要跑在容器里。按照 安装文档在宿主机上克隆仓库、安装依赖后启动# 克隆 ComfyUI git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI # 安装依赖 pip install -r requirements.txt # 启动 ComfyUI python main.pyComfyUI 默认运行在http://127.0.0.1:8188。注意 ComfyUI 还需要下载对应的模型文件才能工作这部分要按 ComfyUI 自身的文档完成Pixelle-Video 的文档中没有代管这部分流程。启动后先做一步确认在宿主机自己的浏览器里访问http://127.0.0.1:8188能打开 ComfyUI 界面才说明宿主机服务本身可用。这一步也是后面排错时文档给出的检查手段。启动 Docker 部署进入项目根目录包含 docker-compose.yml 和 config.example.yaml 的目录可以直接运行项目提供的启动脚本bash docker-start.sh启动脚本会依次完成检查config.yaml如果不存在从config.example.yaml复制生成如果它被错误地创建成了目录Docker 挂载问题会先删除再重建检查 Docker Compose 是否可用不可用则报错退出执行docker compose build构建镜像执行docker compose up -d启动服务。docker-compose.yml 里还包含一个init服务同样负责在config.yaml缺失时从config.example.yaml创建防止挂载一个不存在的文件时 Docker 会把它创建成目录的问题。启动成功后脚本会提示以下地址Web UIhttp://localhost:8501APIhttp://localhost:8000API 文档http://localhost:8000/docs注意如果启动过程中执行了脚本里的目录清理删除被误建的config.yaml目录说明之前容器挂载出过错重建后需要重新填写配置。修改 comfyui_url 指向宿主机config.yaml挂载在容器的/app/config.yaml上config.yaml在项目根目录直接编辑宿主机上的文件即可。config.example.yaml 中comfyui段的默认值是comfyui: comfyui_url: http://127.0.0.1:8188 # ComfyUI server URL (required for selfhost workflows) comfyui_api_key: # Note for Docker users: Use host.docker.internal:8188 (Mac/Windows) or host IP address (Linux)问题就出在默认值容器内的127.0.0.1指向容器自身而 ComfyUI 在宿主机上。按配置文件注释给出的说明修改Mac / Windows 宿主机comfyui: comfyui_url: http://host.docker.internal:8188启动脚本生成config.yaml时的提示也明确写着 use host.docker.internal:8188 for local Mac/Windows。Linux 宿主机host.docker.internal不适用改用宿主机的 IP 地址例如以你的实际 IP 为准comfyui: comfyui_url: http://192.168.x.x:8188两个注意点comfyui_url只在 selfhost 工作流下是必需的配置注释标注为 required for selfhost workflows。config.example.yaml里image和video的default_workflow默认值都是 RunningHub 云端工作流runninghub/image_flux.json、runninghub/video_wan2.1_fusionx.json如果你要走本地 ComfyUI需要把它们改成对应的selfhost/...工作流否则连接地址改了也不会被使用。comfyui_api_key是可选配置不填就留空字符串。修改完成后重启服务让容器读到新配置启动脚本输出的常用命令里就包含这条docker-compose restart如果你用的是docker composev2插件而不是独立的docker-compose对应换成docker compose restart。验证连接是否生效按从内到外的顺序验证文档中对应的检查方式如下确认宿主机 ComfyUI 在运行在宿主机浏览器访问http://127.0.0.1:8188故障排查文档中ComfyUI 连接失败一节给出的第 3 步在浏览器中访问 ComfyUI 地址测试。确认 Pixelle-Video 服务本身正常浏览器打开http://localhost:8501看到 Web 界面、http://localhost:8000/docs看到 API 文档。docker-compose.yml 中两个服务也配置了健康检查分别请求容器内的http://localhost:8000/health和http://localhost:8501/_stcore/health可用docker-compose logs -f查看日志判断启动情况。在 Web UI 中测试 ComfyUI 连接进入「⚙️ 系统配置」配置说明给出的本地部署流程是——填写 ComfyUI URL 后点击「测试连接」确认服务可用。测试连接通过说明容器已经能访问宿主机上的 ComfyUI。端到端验证配置完成并保存后配置会写回config.yaml按 快速开始 生成一个视频图像/视频由本地 ComfyUI 出图即为最终确认。连接失败时检查哪些项故障排查文档给出的ComfyUI 连接失败可能原因与解决方案可能原因ComfyUI 未运行URL 配置错误防火墙阻止。处理步骤确认 ComfyUI 正在运行检查 URL 配置默认http://127.0.0.1:8188Docker 部署下应为host.docker.internal:8188或宿主机 IP在浏览器中访问 ComfyUI 地址测试检查防火墙设置。针对 Docker 场景再补一条文档依据明确的检查点如果宿主机是 Linux 却填了host.docker.internal会解析失败——config.example.yaml 的注释明确区分了 Mac/Windows 用host.docker.internal:8188、Linux 用宿主机 IP 地址两种写法改错平台时按此对照修正即可。边界说明如果你不需要本地 ComfyUI可以直接使用 RunningHub 云端工作流只需在config.yaml的comfyui段填写runninghub_api_key图像/视频工作流保持默认的runninghub/...即可此时comfyui_url填什么都不影响该路径Docker 网络问题也不会出现。本地 ComfyUI 方案在宿主机上建议配备 NVIDIA 显卡6GB 显存这是 安装文档系统要求一节对本地部署 ComfyUI 的说明。【免费下载链接】Pixelle-Video AI 全自动短视频引擎 | AI Fully Automated Short Video Engine项目地址: https://gitcode.com/GitHub_Trending/pi/Pixelle-Video创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考