如何在同一服务器部署运行两个不同端口的Prefect项目

同一服务器完全支持运行多个互相隔离的Prefect项目，通过不同端口独立访问。非首个端口无法访问的问题均为配置冲突导致，不属于Prefect本身的功能限制。

• 仅修改了宿主机映射端口，未同步修改容器内Prefect服务的监听端口，导致容器内服务端口冲突
• 多个实例共用同一份Prefect元数据存储（同一路径的SQLite文件、同一个PostgreSQL库表），触发服务锁、注册信息冲突
• 多个Docker Compose项目使用默认同名网络，导致服务路由混乱
• 未给多实例配置独立的工作目录，运行时临时文件、配置文件互相覆盖

将两个项目的Compose配置文件分别放在完全独立的两个目录下（比如./prefect-project-a、./prefect-project-b），不要放在同一路径下启动。

项目A（监听127.0.0.1:8080）配置示例 #

在./prefect-project-a目录下创建docker-compose.yml：

version: "3.8"
services:
  prefect-server:
    image: prefecthq/prefect:2-latest
    command: prefect server start --host 0.0.0.0
    ports:
      - "127.0.0.1:8080:4200"
    environment:
      - PREFECT_SERVER_API_PORT=4200
      - PREFECT_HOME=/opt/prefect/storage
    volumes:
      - ./server_data:/opt/prefect/storage
    networks:
      - prefect-a-net
networks:
  prefect-a-net:
    name: prefect-a-net

项目B（监听127.0.0.1:8081）配置示例 #

在./prefect-project-b目录下创建docker-compose.yml：

version: "3.8"
services:
  prefect-server:
    image: prefecthq/prefect:2-latest
    command: prefect server start --host 0.0.0.0
    ports:
      - "127.0.0.1:8081:4201"
    environment:
      - PREFECT_SERVER_API_PORT=4201
      - PREFECT_HOME=/opt/prefect/storage
    volumes:
      - ./server_data:/opt/prefect/storage
    networks:
      - prefect-b-net
networks:
  prefect-b-net:
    name: prefect-b-net

• 两个实例的PREFECT_HOME对应的存储卷必须完全独立，禁止两个容器挂载同一个宿主机目录作为Prefect工作目录，否则会触发元数据锁、配置覆盖问题
• 第二个实例的PREFECT_SERVER_API_PORT值必须和端口映射中容器侧的端口一致（示例中为4201），不能沿用默认的4200，否则容器内服务会因为端口被占用启动失败
• 两个实例必须使用独立命名的自定义网络，不要依赖Compose自动生成的默认网络，避免路由冲突
• 如果使用PostgreSQL作为元数据库，需要为两个实例创建独立的数据库，禁止共用同一个库的同一个Schema
• 启动时先进入对应项目目录，分别执行docker-compose up -d启动，启动后可通过docker ps确认端口映射规则，通过docker logs <容器ID>排查第二个实例的启动报错
• 部署完成后两个实例完全隔离，各自的Flow、Deployment、工作队列数据不会互通

内容的提问来源于stack exchange，提问作者Enes KÖKÇÜ