生产环境部署

本文档提供 OpenVort 在生产环境中的安全加固、性能调优和高可用配置建议。适用于已完成基础部署、准备正式上线的团队。

安全加固

修改默认密码

首次部署后必须立即修改以下默认凭据：

• Web 管理面板登录密码
• PostgreSQL 数据库密码
• .env 中的 SECRET_KEY

HTTPS 配置

通过 Nginx 反向代理启用 HTTPS：

server {
    listen 443 ssl;
    server_name ai.yourcompany.com;

    ssl_certificate /etc/ssl/certs/your-cert.pem;
    ssl_certificate_key /etc/ssl/private/your-key.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /ws {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

防火墙规则

仅开放必要端口：

Docker 网络隔离

使用自定义桥接网络，隔离 AI 员工容器：

docker network create --driver bridge openvort-net

DM 配对安全

生产环境务必启用 pairing 或 allowlist 策略，禁止使用 open 模式。详见 DM 配对安全。

性能调优

LLM 选择

推荐使用支持 Prompt Caching 的模型（如 Claude Sonnet 4），可显著降低重复上下文的 Token 消耗和响应延迟。

上下文控制

OpenVort 默认在对话上下文达到 70,000 tokens 时自动压缩（compact），保留关键信息并释放上下文窗口。可在 AI 员工配置中调整此阈值。

数据库优化

• 定期执行 VACUUM ANALYZE 清理 PostgreSQL 死元组
• 为高频查询字段添加索引
• 监控慢查询日志，优化超过 1 秒的查询

高可用配置

数据库高可用

生产环境建议使用 PostgreSQL 主从复制或云数据库服务（如阿里云 RDS），确保数据安全。

自动重启

使用 systemd 配置服务自动重启：

[Unit]
Description=OpenVort Service
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/openvort serve
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

健康检查

配置定期健康检查，及时发现异常：

# Health check endpoint
curl -f http://localhost:8080/api/health || alert "OpenVort is down"

监控项目

上线前检查清单

• 已修改所有默认密码和密钥
• 已配置 HTTPS 并验证证书有效
• 已配置防火墙规则
• 已启用 DM 配对或白名单策略
• 已配置数据库备份（参见 备份与恢复）
• 已配置服务自动重启
• 已配置监控告警
• 已测试 LLM 连通性和 Failover
• 已清理测试数据