部署说明
OmniAgent 的私有化部署指南；OmniAgent 支持企业私有化部署，确保数据安全和隐私。
企业版
私有化部署是 OmniAgent 企业版功能。了解更多请访问 企业版介绍。
部署架构
┌─────────────────────────────────────────────────────┐
│ 企业内网 │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 客户端1 │ │ 客户端2 │ │ 客户端3 │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │
│ └───────────────┼───────────────┘ │
│ │ │
│ ┌────────▼────────┐ │
│ │ OmniAgent │ │
│ │ 管理服务器 │ │
│ └────────┬────────┘ │
│ │ │
│ ┌───────────────┼───────────────┐ │
│ │ │ │ │
│ ┌────▼────┐ ┌─────▼────┐ ┌─────▼────┐ │
│ │ AI模型 │ │ 数据库 │ │ 存储服务 │ │
│ │ (本地) │ │(PostgreSQL)│ │ (MinIO) │ │
│ └─────────┘ └──────────┘ └──────────┘ │
└─────────────────────────────────────────────────────┘部署方式
系统要求
- Docker 20.10+
- Docker Compose 2.0+
- 8GB+ 内存
- 50GB+ 硬盘空间
部署步骤
获取部署文件
下载企业版部署包：
wget https://releases.omniagent.cc/enterprise/docker-compose.tar.gz
tar -xzf docker-compose.tar.gz
cd omniagent-enterprise配置环境变量
复制并修改环境配置：
cp .env.example .env
vim .env主要配置项：
# 基础配置
DOMAIN=omniagent.yourdomain.com
ADMIN_EMAIL=admin@yourdomain.com
# 数据库
POSTGRES_PASSWORD=your_secure_password
# AI 模型配置
AI_PROVIDER=ollama
OLLAMA_HOST=http://ollama:11434
# 许可证
LICENSE_KEY=your_license_key初始化配置
访问 https://your-domain/admin 完成初始化设置。
Docker Compose 配置参考
version: '3.8'
services:
omniagent:
image: omniagent/server:enterprise
ports:
- "80:80"
- "443:443"
environment:
- DATABASE_URL=postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/omniagent
- REDIS_URL=redis://redis:6379
volumes:
- ./data:/app/data
- ./config:/app/config
depends_on:
- db
- redis
- ollama
db:
image: postgres:15
environment:
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=omniagent
volumes:
- postgres_data:/var/lib/postgresql/data
redis:
image: redis:7-alpine
volumes:
- redis_data:/data
ollama:
image: ollama/ollama
volumes:
- ollama_data:/root/.ollama
deploy:
resources:
reservations:
devices:
- capabilities: [gpu]
volumes:
postgres_data:
redis_data:
ollama_data:使用 Helm 部署
# 添加 Helm 仓库
helm repo add omniagent https://charts.omniagent.cc
helm repo update
# 安装
helm install omniagent omniagent/omniagent-enterprise \
--namespace omniagent \
--create-namespace \
--set license.key=your_license_key \
--set domain=omniagent.yourdomain.com \
--set persistence.size=100GiValues 配置
# values.yaml
domain: omniagent.yourdomain.com
license:
key: your_license_key
replicas: 3
resources:
requests:
cpu: 1000m
memory: 2Gi
limits:
cpu: 4000m
memory: 8Gi
persistence:
enabled: true
size: 100Gi
storageClass: standard
database:
external: false
# 或使用外部数据库
# external: true
# host: your-db.example.com
# password: your_password
ollama:
enabled: true
gpu: true
models:
- llama3
- qwen2
ingress:
enabled: true
annotations:
kubernetes.io/ingress.class: nginx
cert-manager.io/cluster-issuer: letsencrypt
tls:
- secretName: omniagent-tls
hosts:
- omniagent.yourdomain.com适用于小规模团队或测试环境。
系统要求
- Ubuntu 22.04 LTS / CentOS 8+
- 16GB+ 内存
- 100GB+ SSD
- NVIDIA GPU（推荐，用于本地模型）
部署步骤
安装依赖
# Ubuntu
sudo apt update
sudo apt install -y postgresql redis-server nginx
# 安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh下载并安装
wget https://releases.omniagent.cc/enterprise/omniagent-server-linux-amd64.tar.gz
sudo tar -xzf omniagent-server-linux-amd64.tar.gz -C /opt/
sudo ln -s /opt/omniagent/bin/omniagent-server /usr/local/bin/配置服务
创建 systemd 服务：
sudo cat > /etc/systemd/system/omniagent.service << EOF
[Unit]
Description=OmniAgent Server
After=network.target postgresql.service
[Service]
Type=simple
User=omniagent
ExecStart=/usr/local/bin/omniagent-server
Restart=always
Environment=CONFIG_PATH=/etc/omniagent/config.yaml
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable omniagent
sudo systemctl start omniagent安全配置
HTTPS 配置
建议使用 Let's Encrypt 免费证书：
# 使用 certbot
sudo apt install certbot
sudo certbot certonly --standalone -d omniagent.yourdomain.com防火墙配置
# 只开放必要端口
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable身份认证
支持多种认证方式：
- 内置用户管理
- LDAP / Active Directory
- OAuth2 (Google, Azure AD, 等)
- SAML 2.0
监控与维护
日志查看
# Docker 部署
docker compose logs -f omniagent
# 单机部署
journalctl -u omniagent -f备份恢复
# 备份数据库
pg_dump omniagent > backup.sql
# 备份配置和数据
tar -czf omniagent-backup.tar.gz /opt/omniagent/data /etc/omniagent升级流程
# 拉取新镜像
docker compose pull
# 重启服务
docker compose up -d
# 验证版本
docker compose exec omniagent omniagent --version常见问题
遇到部署问题？请联系 企业技术支持。