REQUIREMENTS
部署要求
私有化部署需要准备的服务器配置与软件环境。 所有安装、配置工作由我方工程师完成，客户无需执行命令行操作。
01
服务器配置
按下表选择规格。「人数」指同时在线使用系统的成员数，不是账号总数。
| 规模 | CPU | 内存 | 磁盘 | 适用场景 |
|---|---|---|---|---|
| 试用 / 演示 | 2 核 | 4 GB | 50 GB SSD | 3 人以内，验证效果 |
| 标准 | 4 核 | 8 GB | 100 GB SSD | 10 ~ 30 人日常使用 |
| 生产 | 8 核 | 16 GB | 200 GB SSD | 50 人以上，数据量大 |
| 高可用 | 8 核 × 2 | 16 GB × 2 | 200 GB SSD | 双机 + 负载均衡 |
建议起始配置
第一次部署建议直接上 4 核 8G。再低的配置能跑起来，但导入大 Excel
或多人同时查询时会明显卡顿。
各组件资源占用
以下为参考值，实际占用与数据量和并发有关。
| 组件 | 内存占用 | 说明 |
|---|---|---|
| 数据库 | 1 ~ 2 GB | 随数据量增长 |
| 应用服务 | 1 ~ 2 GB | 可配置 |
| 智能分析服务 | 0.5 ~ 1 GB | 同时会话越多占用越高 |
| Web 服务 | 约 50 MB | 几乎不占资源 |
| 系统预留 | 1 GB | 操作系统本身 |
磁盘规划
- 系统与程序：程序本体约 1 GB，建议预留 20 GB 给依赖与版本更新
- 数据库：按现有业务数据量的 3 倍预留（含索引和备份）
- 导入的 Excel：每万行约占 2 ~ 5 MB（参考值，与列数有关）
- 日志：保留 30 天约需 5 GB
磁盘类型建议 SSD
机械硬盘也能用，但查询和导入会慢数倍，响应时间从 1.4 秒变成 8 秒左右。
支持的服务器形态
| 类型 | 支持情况 |
|---|---|
| 云服务器（阿里云 / 腾讯云等） | 推荐，扩容方便 |
| 自有物理机 | 支持 |
| 内网虚拟机（VMware / KVM） | 支持，需能访问外网或提供离线包 |
| 国产化平台（麒麟 / 统信） | 需提前沟通，单独适配 |
| 共享主机 / Windows 服务器 / ARM 架构 | 需根据具体情况判断 |
02
环境要求
各组件的最低版本要求。以下由我方安装配置，客户无需自行安装。
| 组件 | 版本要求 | 必需 | 作用 |
|---|---|---|---|
| 操作系统 | Ubuntu 20.04 / 22.04 CentOS 7.9 及以上 | 是 | 基础运行环境 |
| JDK | 17 | 是 | 运行应用服务 |
| MySQL | 8.0 及以上 | 是 | 存放业务数据 |
| Redis | 6.0 及以上 | 是 | 会话缓存、登录状态 |
| Nginx | 1.20 及以上 | 是 | 网页访问与转发 |
| Node.js | 24.16 及以上 不支持 25.x | 是 | 运行智能分析服务 |
| Python | 3.10 及以上 | 是 | 数据源连接组件 |
| 系统库 | unixodbc 驱动库 | 是 | 连接 SQL Server 等数据源所需 |
端口要求
| 端口 | 用途 | 对外开放 |
|---|---|---|
| 80 | 网页访问（HTTP） | 是 |
| 443 | 网页访问（HTTPS） | 是 |
| 8080 | 应用服务（可调整） | 否，仅本机 |
| 3306 | 数据库 | 否，仅本机或内网 |
| 6379 | 缓存服务 | 否，仅本机 |
对外只需开放 80 和 443
数据库和缓存端口暴露在公网是数据泄露最常见的原因。云服务器请同时在安全组中限制。
网络与带宽
服务器需要能访问外网（下载依赖、调用模型接口）。带宽按在线人数估算，每个用户约占用 20 ~ 50 KB/s（参考值，与实际查询数据量有关）：
| 同时在线人数 | 建议带宽 |
|---|---|
| 10 人以内 | 5 Mbps |
| 10 ~ 30 人 | 10 Mbps |
| 30 ~ 50 人 | 20 Mbps |
| 50 人以上 | 50 Mbps 或按需扩容 |
连接业务数据库的要求
系统需要读取现有 ERP、进销存等业务数据库，要求：
- 从应用服务器能连通目标数据库端口（MySQL 3306、SQL Server 1433 等）
- 提供一个只读账号（系统只执行查询，不改数据）
- 跨网段时需要网络管理员放行
已有数据库可以共用
服务器上已装 MySQL 8.0 可直接共用（新建独立库和专用账号），不影响现有业务库。
版本低于 8.0 则需要升级或另装。
03
常见问题
Q1 · 我们已经有服务器了，能用现有的吗？▾
可以，只要满足三个条件：
① 内存 8G 以上，现有业务占用后还剩 4G 可用
② 操作系统在支持列表内
③ 有权限安装软件、开放端口
如果和现有业务混用，建议先评估高峰期负载。
① 内存 8G 以上，现有业务占用后还剩 4G 可用
② 操作系统在支持列表内
③ 有权限安装软件、开放端口
如果和现有业务混用，建议先评估高峰期负载。
Q2 · 一定要有公网 IP 吗？▾
不一定。
只在公司内网使用：内网 IP 就够。
需要出差或居家访问：可以配公网 IP，也可以走公司 VPN。
完全不能出网：也能部署，需要离线安装包和本地模型，周期会长一些。
只在公司内网使用：内网 IP 就够。
需要出差或居家访问：可以配公网 IP，也可以走公司 VPN。
完全不能出网：也能部署，需要离线安装包和本地模型，周期会长一些。
Q3 · 会不会改我们的业务数据？▾
不会。系统只执行查询语句，不对业务库做写操作。
另外建议给易码AI 单独建只读账号，从数据库层面彻底杜绝写操作的可能。
另外建议给易码AI 单独建只读账号，从数据库层面彻底杜绝写操作的可能。
Q4 · 数据会不会传到你们那边？▾
私有化部署下不会。所有数据都在客户自己的服务器上，我方不保留副本。
唯一出网的是调用大模型接口时的提问文本。如果提问内容也不能出网，可以部署本地模型完全离线运行。
唯一出网的是调用大模型接口时的提问文本。如果提问内容也不能出网，可以部署本地模型完全离线运行。
Q5 · 支持多少人在线？▾
4 核 8G 配置，通常可支持 20 ~ 30 人同时使用。
只是偶尔用一下的话，账号总数 100 人以内也没问题。人数增加时优先扩内存。
只是偶尔用一下的话，账号总数 100 人以内也没问题。人数增加时优先扩内存。
Q6 · 能连我们的 ERP 吗？▾
支持 MySQL、SQL Server、Doris 等主流数据库，也支持直接导入 Excel。
常见 ERP（聚水潭、金蝶、用友等）的数据都存在这些库里，能连上数据库就能用。
常见 ERP（聚水潭、金蝶、用友等）的数据都存在这些库里，能连上数据库就能用。