核心内容摘要
PP-DocLayoutV3效果展示：手写签名与印刷文字共存文档中仅标记印刷区域的智能过滤
Z-Image-ComfyUI网页端口映射自定义端口配置教程
为什么需要自定义端口配置当你在本地或云服务器上部署 Z-Image-ComfyUI 时系统默认会将 ComfyUI 的 Web 界面绑定到某个固定端口通常是8188。
但现实场景中这个默认端口常常已被占用——比如你同时运行着 Stable Diffusion WebUI、Ollama、Jupyter 或其他服务又或者你在企业内网、学校实验室、多用户共享服务器环境中管理员已对端口做了统一策略限制再比如你想通过反向代理Nginx / Caddy对外提供安全访问就需要把 ComfyUI 映射到标准 HTTP80或 HTTPS443端口下。
这时候“改端口”就不是可选项而是必选项。
但很多新手卡在第一步改了配置文件重启后页面打不开或者改完端口工作流加载失败甚至误操作导致 ComfyUI 启动报错退出。
本教程不讲原理堆砌只聚焦一件事用最稳、最简、最可复现的方式把 Z-Image-ComfyUI 的网页界面映射到你指定的任意端口并确保所有功能包括模型加载、图像预览、节点执行、历史记录完全正常。
全程无需编译、不碰 Dockerfile、不改源码仅靠三处关键配置 一次脚本微调10 分钟内完成。
Z-Image-ComfyUI 端口机制解析小白也能懂Z-Image-ComfyUI 是基于 ComfyUI 框架构建的镜像而 ComfyUI 的端口行为由三层控制逻辑共同决定第一层启动脚本参数最高优先级1键启动.sh最终调用的是python main.py命令它支持--port参数直接指定监听端口。
这是最直接、最推荐的修改入口。
第二层ComfyUI 配置文件次优先级.comfy/config.json中的port字段会在未显式传参时生效。
但注意Z-Image 镜像默认不生成该文件需手动创建。
第三层环境变量与网络层限制底层保障云平台如阿里云、腾讯云的安全组、本地防火墙ufw/iptables、Docker 容器端口映射规则都会影响“外部能否访问到该端口”。
这部分我们会在第 4 节统一处理。
关键结论只需改1键启动.sh中的启动命令就能 99% 场景下搞定端口映射。
其他两层作为兜底和验证手段不建议新手优先折腾。
实操步骤三步完成自定义端口配置
1 修改启动脚本精准定位并替换端口参数登录你的 Z-Image-ComfyUI 实例SSH 或 Web 终端进入/root目录cd /root用nano编辑启动脚本若无 nano可用vi或vimnano 1键启动.sh找到类似以下这行命令通常在文件末尾以python main.py开头python main.py --listen
0.
0.
0:8188 --cpu --disable-auto-launch注意不同镜像版本写法略有差异可能为python main.py --port 8188 --listen
0.
0.
0python main.py --port8188 --listen甚至没有显式--port只靠--listen后的地址隐含端口统一修改原则将所有出现8188的位置替换成你想要的新端口例如
7860、
23333等避开 1–1023 系统保留端口保留--listen
0.
0.
0允许外部访问不要改成
127.
0.
1那只能本机访问若原命令中同时存在--port和--listen优先保留--port参数并确保两者端口号一致修改后保存nano 中按CtrlO → Enter → CtrlX示例修改结果python main.py --port 7860 --listen
0.
0.
0:7860 --cpu --disable-auto-launch
2 验证配置是否生效启动前快速检查在修改完脚本后不要直接运行。
先做两件事检查端口是否被占用避免启动失败运行以下命令确认目标端口如7860当前空闲ss -tuln | grep :7860若无任何输出说明端口可用若有输出换一个端口重试如
8080。
临时测试启动不后台运行手动执行修改后的命令去掉和后台符号观察日志python main.py --port 7860 --listen
0.
0.
0:7860 --cpu --disable-auto-launch正常应看到类似输出Starting server on
0.
0.
0:7860 To see the GUI go to: http://
127.
0.
1:7860出现Starting server on ...即表示端口已成功绑定。
❌ 若报错Address already in use说明端口冲突请返回第
1 步换端口。
小技巧此时可在本机浏览器打开http://[你的服务器IP]:7860若能加载 ComfyUI 页面且左侧工作流可点击、图像能正常预览说明核心功能完全正常。
3 永久生效更新一键启动逻辑并重启服务确认临时启动无误后回到1键启动.sh确保它已保存最终修改。
然后赋予执行权限如有必要chmod x 1键启动.sh现在你可以安全地运行它./1键启动.sh等待约 10–20 秒模型加载期间终端可能无响应属正常现象然后在浏览器中访问http://[你的服务器IP]:7860页面完整加载左侧工作流可拖拽、连接、执行右侧图像预览区可点击查看大图、下载 PNG历史记录History面板可展开查看每次生成结果全部通过即表示自定义端口配置已 100% 生效。
4.
常见问题排查与进阶配置
1 浏览器打不开先查这四点现象最可能原因快速验证方式解决方案无法访问此网站/连接被拒绝云服务器安全组未放行端口登录云控制台 → 安全组 → 检查入方向规则是否包含7860/tcp添加入方向规则端口范围7860协议TCP授权对象
0.
0.
0/0或限定 IP连接已重置/ERR_CONNECTION_RESET本地防火墙拦截如 Ubuntu ufwsudo ufw statussudo ufw allow 7860页面加载但工作流空白 / 图像不显示ComfyUI 启动时未正确读取端口查看终端日志最后一行是否为Starting server on
0.
0.
0:7860回到第
2 步确认main.py启动命令中--port和--listen端口一致页面能打开但点击“队列”无反应浏览器缓存旧 JS 文件强制刷新CtrlF5或CmdShiftR清除浏览器缓存或尝试无痕模式
2 进阶需求反向代理 自定义域名Nginx 示例如果你希望用https://ai.yourdomain.com访问 ComfyUI而非暴露 IP 和端口推荐使用 Nginx 反向代理。
以下是精简可靠的配置保存为/etc/nginx/conf.d/comfyui.confserver { listen 80; server_name ai.yourdomain.com; location / { proxy_pass http://
127.
0.
1:7860; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # 必须添加否则 WebSocket用于实时日志、进度条会断开 proxy_http_version
1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; } }启用后执行sudo nginx -t sudo systemctl reload nginx此配置已实测兼容 Z-Image-ComfyUI 的所有功能包括节点执行日志实时推送、图像生成进度条、批量队列状态更新。
3 多模型共存为不同 Z-Image 变体分配独立端口Z-Image 提供 Turbo / Base / Edit 三个变体你完全可以同时运行它们只需端口隔离变体推荐端口启动命令片段Z-Image-Turbo7860--port 7860 --listen
0.
0.
0:7860Z-Image-Base7861--port 7861 --listen
0.
0.
0:7861Z-Image-Edit7862--port 7862 --listen
0.
0.
0:7862每个变体放在独立目录如/root/zimage-turbo,/root/zimage-base各自维护一份1键启动.sh互不干扰。
这样你就能在同一个服务器上随时切换不同能力的文生图引擎。
5.
总结端口配置的本质是“让请求准确抵达”回顾整个过程你其实只做了三件本质的事告诉 ComfyUI “我在哪个门等你”通过--port参数确保外面的人能找到这扇门开放安全组 / 防火墙让门牌号清晰可见、不被遮挡反向代理或直连 IP 端口Z-Image-ComfyUI 的强大不在于它有多复杂而在于它足够轻量、足够透明——所有控制权都在你手中。
你不需要成为 DevOps 专家也不必啃完 ComfyUI 源码只要理解这三层关系就能随心所欲地把它嵌入你现有的 AI 工作流中。
下一步你可以尝试把7860端口绑定到公司内网 DNS让设计同事直接访问生成海报用7861运行 Base 模型做风格微调实验在7862上部署 Edit 模型对接电商后台实现“上传商品图 → 自动生成多角度展示视频”。
端口只是入口真正的创造力从你敲下第一个提示词开始。
附Z-Image 各变体端口配置速查表变体推荐用途默认端口建议关键优势启动命令核心片段Z-Image-Turbo快速出图、批量生成、低配设备7860⚡亚秒级延迟16G 显存即可跑--port 7860 --listen
0.
0.
0:7860Z-Image-Base微调训练、插件开发、深度定制7861完整参数量社区生态友好--port 7861 --listen
0.
0.
0:7861Z-Image-Edit图像编辑、Inpainting、指令驱动修图7862精准语义理解支持中英双语提示--port 7862 --listen
0.
0.