私有化最小部署

目标:在一台 Linux 机器上用 Docker Compose 跑起来最小 Evose,验证产品。预计 30 分钟。

这不是生产部署

本指南仅用于快速验证。生产部署请走完整私有化方案。

前置条件

资源	最低	推荐
CPU	4 核	8 核
内存	16 GB	32 GB
磁盘	200 GB SSD	500 GB SSD
OS	Ubuntu 20.04+ / CentOS 7+	Ubuntu 22.04
Docker	20.10+	24+
Docker Compose	v2	v2

你还会需要至少一个 LLM 接入凭据(OpenAI / Anthropic / 通义 / 文心 / 自部署模型 API)。

步骤

1 · 准备环境（5 分钟)

# 验证 Docker
docker --version
docker compose version
 
# 创建工作目录
mkdir -p /opt/evose && cd /opt/evose

2 · 获取部署包（2 分钟)

# 假设你已拿到部署包(联系商务获取)
tar -xzf evose-edition-*.tar.gz
cd evose-edition

部署包目录结构:

evose-edition/
├── docker-compose.yml       # 编排文件
├── .env.example             # 环境变量模板
├── config/                  # 配置目录
└── scripts/                 # 运维脚本

3 · 配置环境变量（5 分钟)

cp .env.example .env
vim .env

最小必填:

# 域名
EVOSE_DOMAIN=evose.example.com
 
# 数据库密码(随机生成)
DB_PASSWORD=<请用 openssl rand -hex 16 生成>
REDIS_PASSWORD=<同上>
 
# 加密密钥(用于凭据加密)
SECRET_KEY=<请用 openssl rand -hex 32 生成>
 
# 初始管理员
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=<至少 12 位强密码>
 
# 至少一个 LLM
LLM_PROVIDER=openai
OPENAI_API_KEY=<your key>
OPENAI_BASE_URL=https://api.openai.com/v1

→ 完整环境变量列表

4 · 启动服务（10 分钟)

# 拉镜像并启动
docker compose pull
docker compose up -d
 
# 等待初始化
docker compose logs -f evose-init
 
# 看到 "Initialization complete" 即可继续

健康检查:

# 应当看到所有服务 healthy
docker compose ps

5 · 访问与初始化（5 分钟)

打开浏览器访问 http://<服务器 IP>:8080(或你配置的域名)
用 .env 中的 ADMIN_EMAIL / ADMIN_PASSWORD 登录
系统自动生成的默认组织 + 默认空间已经就绪
进入 组织管理 · 模型平台,确认你的 LLM 已被识别
进入空间，跟着 SaaS 的 5 分钟教程第 3 步开始（从“用模板创建第一个 Agent”)

验证清单

docker compose ps 所有容器 healthy
浏览器能登录管理后台
模型平台显示已配置的 LLM
在空间能创建并对话第一个 Agent

常见问题

数据库初始化失败？

检查 DB_PASSWORD 是否包含特殊字符（避免 $、空格);确保磁盘有足够空间。

模型调用 401?

进入 组织管理 · 安全 · 凭据,确认 API Key 正确；在 模型平台 点“测试连接”。

想升级 / 备份？

升级流程
备份:docker compose exec postgres pg_dump ...(详见生产文档)

这只是最小部署

跑通后，如果要进入生产，你需要:

必做	文档
高可用（双实例 + 独立数据库)	HA 部署
Kubernetes 编排	K8s 部署
SSO 接入	SSO 配置
HTTPS / 域名 / CDN	系统要求
备份与升级流程	升级
6 层防御	防御策略

接下来

想体验完整功能 → 第一个 Agent
想做生产部署 → 系统要求

私有化最小部署

页面导航