Docker 部署

镜像说明

MCP Gateway 提供两种部署方式：

All-in-One 部署

所有服务打包在一个容器中，适合单机部署或本机使用

多容器部署

各个服务独立部署，适合生产环境或集群部署

镜像仓库

镜像发布到以下三个仓库：

Docker Hub: docker.io/ifuryst/unla-*
GitHub Container Registry: ghcr.io/amoylab/unla/*
阿里云容器镜像服务: registry.ap-southeast-1.aliyuncs.com/amoylab/unla-*

GHCR 支持多层目录，所以组织形式会更清晰，Docker 和阿里云的仓库只能一层目录，因此后面镜像名用 - 拼接。

镜像标签

latest: 最新版本
vX.Y.Z: 特定版本号

目前 MCP Gateway 正在快速迭代中！因此建议通过版本号部署会更可靠一点。

可用镜像

# All-in-One 版本
docker pull docker.io/ifuryst/unla-allinone:latest
docker pull ghcr.io/amoylab/unla/allinone:latest
docker pull registry.ap-southeast-1.aliyuncs.com/amoylab/unla-allinone:latest

# API Server
docker pull docker.io/ifuryst/unla-apiserver:latest
docker pull ghcr.io/amoylab/unla/apiserver:latest
docker pull registry.ap-southeast-1.aliyuncs.com/amoylab/unla-apiserver:latest

# MCP Gateway
docker pull docker.io/ifuryst/unla-mcp-gateway:latest
docker pull ghcr.io/amoylab/unla/mcp-gateway:latest
docker pull registry.ap-southeast-1.aliyuncs.com/amoylab/unla-mcp-gateway:latest

# Mock User Service
docker pull docker.io/ifuryst/unla-mock-server:latest
docker pull ghcr.io/amoylab/unla/mock-server:latest
docker pull registry.ap-southeast-1.aliyuncs.com/amoylab/unla-mock-server:latest

# Web 前端
docker pull docker.io/ifuryst/unla-web:latest
docker pull ghcr.io/amoylab/unla/web:latest
docker pull registry.ap-southeast-1.aliyuncs.com/amoylab/unla-web:latest

All-in-One 部署

All-in-One 部署将所有服务打包在一个容器中，适合单机部署或本机使用。包含以下服务：

API Server: 管理平台后端，可理解为控制面
MCP Gateway: 核心服务，负责实际的网关服务，可理解为数据面
Mock User Service: 模拟用户服务，提供测试用的用户服务
Web 前端: 管理平台前端，提供可视化的管理界面
Nginx: 反向代理其他几个服务

使用 Supervisor 管理服务进程，日志会全部输出到 stdout。

端口说明

对外服务端口

8080: Web 界面端口
5235: MCP Gateway 端口

内部服务端口

5234: API Server 端口
5335: MCP Gateway 管理端口
5236: Mock User Service 端口

5335 是 MCP Gateway 管理端口，承载诸如 reload 的内部接口，生产环境切勿对外暴露！

数据持久化

建议挂载以下目录：

/app/configs: 配置文件目录
/app/data: 数据目录
/app/.env: 环境变量文件

部署步骤

创建目录并下载配置

mkdir -p unla/{configs,data}
cd unla/
curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/configs/apiserver.yaml -o configs/apiserver.yaml
curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/configs/mcp-gateway.yaml -o configs/mcp-gateway.yaml
curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/.env.example -o .env.allinone

启动容器

# 使用阿里云容器镜像服务镜像（建议在中国境内使用）
docker run -d \
           --name unla \
           -p 8080:80 \
           -p 5234:5234 \
           -p 5235:5235 \
           -p 5335:5335 \
           -p 5236:5236 \
           -e ENV=production \
           -v $(pwd)/configs:/app/configs \
           -v $(pwd)/data:/app/data \
           -v $(pwd)/.env.allinone:/app/.env \
           --restart unless-stopped \
           registry.ap-southeast-1.aliyuncs.com/amoylab/unla-allinone:latest

# 使用 GitHub Container Registry 镜像
docker run -d \
           --name unla \
           -p 8080:80 \
           -p 5234:5234 \
           -p 5235:5235 \
           -p 5335:5335 \
           -p 5236:5236 \
           -e ENV=production \
           -v $(pwd)/configs:/app/configs \
           -v $(pwd)/data:/app/data \
           -v $(pwd)/.env.allinone:/app/.env \
           --restart unless-stopped \
           ghcr.io/amoylab/unla/allinone:latest

注意事项

安全配置

确保配置文件和环境变量文件正确配置
强烈建议生产环境使用强密码
不要对外暴露管理端口 5335

版本管理

建议使用版本号标签而不是 latest
生产环境建议配置适当的资源限制

权限配置

确保挂载的目录有正确的权限

多容器部署

多个服务独立部署，适合生产环境或集群部署。包含以下服务：

mcp-gateway: 核心服务，负责实际的网关服务，可理解为数据面
web(包含apiserver): 管理平台及后端，可理解为控制面
mock-server: 模拟服务，提供测试用的服务

适合在生产环境使用，可以按需部署，尤其针对 mcp-gateway 可以多副本部署，实现高可用。

部署特点

数据库支持

使用 PostgreSQL 作为数据库存储 session、代理配置等信息

缓存支持

使用 Redis 用于配置更新通知、OAuth 存储等用途

负载均衡

支持多副本部署和负载均衡配置

Docker Compose 部署

下载配置文件

curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/deploy/docker/multi/docker-compose.yml -o docker-compose.yml
curl -sL https://raw.githubusercontent.com/amoylab/unla/refs/heads/main/.env.example -o .env

修改配置

编辑 docker-compose.yml 和 .env 文件：

修改数据库、Redis 相关的账号密码
按需修改暴露的端口
配置 LLM 服务参数

启动服务

docker compose up -d

配置负载均衡

按需配置 Nginx 等 LB 层

示例配置

docker-compose.yml

services:
  postgres:
    image: postgres:16
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: "**********"
      POSTGRES_DB: mcp-gateway
    volumes:
      - ./db:/var/lib/postgresql/data
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
    restart: always

  redis:
    image: redis:7
    ports:
      - "6379:6379"
    volumes:
      - ./redis:/data
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
    command: redis-server --appendonly yes --save "900 1" --save "300 10" --save "60 10000" --requirepass "**********"
    restart: always

  web:
    image: ghcr.io/amoylab/unla/web:latest
    ports:
      - "8080:80"
      - "5234:5234"
    environment:
      - ENV=production
      - TZ=Asia/Shanghai
    volumes:
      - ./.env:/app/.env
      - ./data:/app/data
    depends_on:
      - postgres
      - mcp-gateway
      - mock-server
    restart: always

  mcp-gateway:
    image: ghcr.io/amoylab/unla/mcp-gateway:latest
    ports:
      - "5235:5235"
    environment:
      - ENV=production
      - TZ=Asia/Shanghai
    volumes:
      - ./.env:/app/.env
      - ./data:/app/data
    depends_on:
      - postgres
    restart: always

  mock-server:
    image: ghcr.io/amoylab/unla/mock-server:latest
    ports:
      - "5236:5236"
    environment:
      - ENV=production
      - TZ=Asia/Shanghai
    volumes:
      - ./.env:/app/.env
    depends_on:
      - postgres
    restart: always

Nginx 配置示例

server {
    server_name unla.amoylab.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
    }

    location /api/ {
        proxy_pass http://127.0.0.1:5234/api/;
        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;
    }

    location /ws/ {
        proxy_pass http://127.0.0.1:5234/api/ws/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        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;
    }

    location /gateway/ {
        proxy_pass http://127.0.0.1:5235/;
        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;

        proxy_buffering off;
        proxy_cache off;
        chunked_transfer_encoding off;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }

    location /mock/ {
        proxy_pass http://127.0.0.1:5236/;
        proxy_set_header Host $host;
    }
}

重要访问 URL

配置完成后，可通过以下 URL 访问服务：

Web 管理界面: https://unla.amoylab.com/
MCP Gateway: https://unla.amoylab.com/gateway/*
示例 MCP 端点: https://unla.amoylab.com/gateway/user/mcp

请根据您的实际域名和配置调整上述 URL。

快速开始

安装部署

配置说明

Web 配置

客户端使用

开发文档

API 文档

端点示例

镜像说明

All-in-One 部署

多容器部署

镜像仓库

镜像标签

可用镜像

All-in-One 部署

端口说明

对外服务端口

内部服务端口

数据持久化

部署步骤

注意事项

多容器部署

部署特点

数据库支持

缓存支持

负载均衡

Docker Compose 部署

示例配置

重要访问 URL

​镜像说明

All-in-One 部署

多容器部署

​镜像仓库

​镜像标签

​可用镜像

​All-in-One 部署

​端口说明

对外服务端口

内部服务端口

​数据持久化

​部署步骤

​注意事项

​多容器部署

​部署特点

数据库支持

缓存支持

负载均衡

​Docker Compose 部署

​示例配置

​重要访问 URL

镜像说明

镜像仓库

镜像标签

可用镜像

All-in-One 部署

端口说明

数据持久化

部署步骤

注意事项

多容器部署

部署特点

Docker Compose 部署

示例配置

重要访问 URL