基于z-image-trubo的自动化文生图机器人微服务架构部署文档

系统由四个微服务组成，部署的顺序同以下描述顺序

• z-servie-network：基础设施，仅用于维持共享网络存活，供其他容器挂载。
• z-servie-ngrok：网关，将公网 HTTPS 流量穿透到内网 n8n，实现 Telegram Trigger 回调(由于telegram的api地址是https的，n8n无法通过localhost本地域名去调用tg的api，所以才需要ngrok服务提供的公网域名去代理n8n的端口，如果你的n8n本身就有公网访问的环境，这个服务可以不需要)。
• z-servie-fastapi：执行单元，封装 ComfyUI 的复杂接口为简单 API（文生图/图生图）。依赖局域网内的 ComfyUI 服务。
• z-servie-n8n：处理 Telegram 消息逻辑（路由、参数解析），调度 z-service-fastapi。依赖 Ngrok 接收消息，依赖 FastAPI 执行绘图。

** 注 **：ngrok启动后可以通过127.0.0.1:4040地址查看启用的公网域名地址配置到，也可以通过以下命令查看日志:docker logs -f z-service-ngrok

1. 项目目录结构 ​

项目结构：

/workspace/
├── z-service-network/
│   └── docker-compose.yml
│
├── z-service-ngrok/
│   ├── .env
│   └── docker-compose.yml
│
├── z-service-fastapi/
│   ├── .env
│   ├── Dockerfile
│   ├── requirements.txt
│   ├── main.py
│   ├── workflow_txt2img.json
│   ├── workflow_img2img.json
│   └── docker-compose.yml
│
└── z-service-n8n/
│   ├── .env
    ├── n8n_data/ (自动生成)
    ├── docker-compose.yml
    └── n8n-image-bot.json

2. 配置说明 ​

对各服务可能涉及到修改的配置做一些说明

2.1 z-service-network配置### ​

2.1.1 .env

- WEBHOOK_URL=修改为ngrok的公网域名

2.1.2 docker-compose.yml

- command:代理的n8n的端口，这里配置为5678
- ports:ngrok的网页端端口 ，这里配置为4040