系统环境要求速查

1. 按场景准备资源

使用场景	推荐部署方式	资源准备
轻量级小团队、PoC、演示、功能验证	单机部署（k8s 或 k3s）	1 台服务器
正式上线、长期运行、需要高可用或后续扩容	K8s 集群	3 台及以上服务器

单机部署适合快速完成验证和小规模使用。

集群部署适合正式上线、长期运行和后续扩容。

2. 操作系统要求

操作系统	支持版本	支持架构
Ubuntu	22.04、24.04	x86

在每台服务器上执行：

确认结果：

操作系统为 Ubuntu 22.04 或 Ubuntu 24.04。

CPU 架构为 x86。

安装账号为 root，或具备等同的系统管理权限。

3. 服务器配置要求

3.1 单机部署

适合轻量级小团队、200 人以下。

PoC、演示、功能验证场景，可以按单机资源准备。

项目	要求
服务器数量	1 台
CPU	16 Core 以上
内存	32 GB 以上
系统盘	根 `/` 分区 100 GB 以上
数据盘	独立挂载 `/data`，可用空间 300 GB 以上，支持扩容

3.2 集群部署

正式上线、长期运行、需要高可用或后续扩容的场景，按集群资源准备。

项目	要求
服务器数量	3 台及以上
推荐角色	`3 master + N worker`
每节点 CPU	16 Core 以上
每节点内存	32 GB 以上
每节点系统盘	根 `/` 分区 100 GB 以上
每节点数据盘	独立挂载 `/data`，可用空间 300 GB 以上，支持扩容

分区注意：

根 / 分区保留 100 GB 以上空间。

/root、/var、/tmp 建议放在根分区下统一管理。

数据目录使用独立数据盘，挂载到 /data。

4. 服务器自检命令

在每台服务器上执行：

对照检查：

检查项	通过条件
CPU	16 Core 以上
内存	32 GB 以上
系统盘	根 `/` 分区可用空间 100 GB 以上
数据盘	`/data` 已挂载，可用空间 300 GB 以上
基础命令	`iptables`、`gzip`、`tar` 可以找到
时间同步	系统时间同步正常

5. 浏览器要求

浏览器	版本要求
Chrome	86 以上
Safari	11 以上
Firefox	102 以上
Edge	84 以上

建议优先使用较新的 Chrome 或 Edge 访问安装器和石墨办公套件。

6. 中间件要求

组件	版本要求
Elasticsearch	8.18.x
MongoDB	4.4.x
Redis	6.2.x
MySQL	8.0
达梦	V8 03134284194-20240920-243574-20108
Kafka	2.7 至 3.5
对象存储	兼容 S3 协议

对象存储可选择华为云 OBS、阿里云 OSS、腾讯云 COS、AWS S3。本地部署可评估使用 MinIO。

如果使用安装器内置中间件，按安装页面默认选项继续。
如果使用已有外部中间件，安装前准备好地址、端口、账号、密码、数据库名或 Bucket 名称。

7. 端口要求

部署前确认服务器、安全组、防火墙、负载均衡和网络策略已放通以下端口。

端口	目标	用途
`18080/TCP`	安装器 Web UI	访问安装页面
`80/TCP` 或 `443/TCP`	石墨业务域名	用户访问入口
`22/TCP`	所有部署节点	SSH 登录与安装任务分发
`3306/TCP`	MySQL	数据库连接
`6379/TCP`	Redis	缓存连接
`27017/TCP`	MongoDB	文档库连接
`9092/TCP`	Kafka	消息队列连接
`9200/TCP`	Elasticsearch	搜索服务连接
按服务端口	S3 / OBS / OSS / COS / MinIO	对象存储连接

8. 磁盘 IO 要求

数据盘建议使用 SSD。磁盘性能达到以下标准：

项目	要求
混合读写 IOPS	5000 以上
顺序读写吞吐量	150 MB/s 以上
平均时延	5 ms 左右或更低

安装 fio 后，可在 /data 上测试。

8.1 混合读写测试

关注结果里的 IOPS，混合读写 IOPS 达到 5000 以上即可继续。

8.2 顺序读测试

8.3 顺序写测试

顺序读和顺序写吞吐量达到 150 MB/s 以上即可继续。

测试完成后可删除测试文件：

9. 公网带宽要求

公网访问场景按人数估算带宽：

公网带宽 = 使用人数 x 0.25 Mbps

示例：

使用人数	建议公网带宽
100 人	25 Mbps 以上
200 人	50 Mbps 以上
500 人	125 Mbps 以上

内网访问场景也建议按同样口径评估出口、入口和负载均衡带宽。

10. 部署前确认清单

开始安装前，逐项确认：

操作系统版本符合要求。

CPU、内存、系统盘、数据盘满足要求。

/data 已挂载到独立数据盘。

iptables、gzip、tar 已安装。

系统时间同步正常。

在线或离线安装方式已确定。

安装器端口 18080 可访问。

业务访问端口 80 或 443 已放通。

如使用外部中间件，连接信息已准备完整。

对象存储兼容 S3 协议，Bucket 和账号权限已准备好。

数据盘 IO 测试达到要求。

公网或内网带宽满足预计使用人数。

1. 按场景准备资源#

2. 操作系统要求#

3. 服务器配置要求#

3.1 单机部署#

3.2 集群部署#

4. 服务器自检命令#

5. 浏览器要求#

6. 中间件要求#

7. 端口要求#

8. 磁盘 IO 要求#

8.1 混合读写测试#

8.2 顺序读测试#

8.3 顺序写测试#

9. 公网带宽要求#

10. 部署前确认清单#