𝐗𝐀𝐈 𝐂𝐨𝐧𝐭𝐫𝐨𝐥

XAI Router 私有化

本页是 XAI Router 私有化部署指南，用于部署独立的专属实例。

一、部署前准备

  • Linux 服务器（建议 2C2G 及以上）
  • 已安装 Docker 与 Docker Compose
  • 三个已解析到服务器公网 IP 的域名：
    • API：api-xai.your-domain.com
    • 账户管理：manage-xai.your-domain.com
    • 配置管理：admin-xai.your-domain.com

二、Docker Compose 快速部署

1) 生成 docker-compose.yml

curl -X POST https://deploy.xairouter.com/xai?raw=true \
  -H "Content-Type: application/json" \
  -d '{
    "xai_mail": "[email protected]",
    "xai_api": "api-xai.your-domain.com",
    "xai_manage": "manage-xai.your-domain.com",
    "xai_admin": "admin-xai.your-domain.com"
  }' > docker-compose.yml

2) 启动服务

docker-compose -f docker-compose.yml up -d

3) 配置 Nginx

curl -X POST https://deploy.xairouter.com/nginx?raw=true \
  -H "Content-Type: application/json" \
  -d '{
    "xai_api": "api-xai.your-domain.com",
    "xai_manage": "manage-xai.your-domain.com",
    "xai_admin": "admin-xai.your-domain.com"
  }' > /etc/nginx/nginx.conf

sudo systemctl restart nginx && sudo systemctl enable nginx

4) 配置 HTTPS

建议为三个域名全部启用 HTTPS（例如 Let’s Encrypt）。

5) 部署验证

docker-compose ps

浏览器访问：

  • https://manage-xai.your-domain.com
  • https://admin-xai.your-domain.com

三、Kubernetes 部署（可选）

curl -X POST https://deploy.xairouter.com/xai/k8s?raw=true \
  -H "Content-Type: application/json" \
  -d '{
    "xai_mail": "[email protected]",
    "xai_api": "api-xai.your-domain.com",
    "xai_manage": "manage-xai.your-domain.com",
    "xai_admin": "admin-xai.your-domain.com"
  }' > xai-router-k8s.yaml

kubectl apply -f xai-router-k8s.yaml

部署后请根据集群实际 StorageClass、Ingress 与 TLS 配置进行调整。

四、上线后建议

  • 首次登录后立即更换管理员凭据
  • 按团队结构创建子账户（支持不限层级/数量）
  • 配置模型映射、速率限制与账单告警策略