单机部署「k8s」

1. 适用场景

K8s 单机部署：

适合轻量级小团队、200 人以下小规模使用、PoC、演示、功能验证和短期测试。

只需要 1 台服务器，服务器同时承担安装节点、K8s 主节点和业务工作节点。

注意

正式上线、长期运行、或后续扩容高可用时，建议使用 K8s 集群部署。

2. 部署流程概览

步骤	要做什么	完成标志
1. 检查系统环境	确认服务器资源、磁盘、网络、时间同步和基础命令	服务器满足部署要求
2. 准备安装物料	获取安装器、产品安装包；离线环境还需准备离线镜像包	文件名和 CPU 架构匹配
3. 上传安装物料	将安装器和安装包上传到部署节点	文件已放到服务器指定目录
4. 启动安装器	启动 `mdp-installer` Web 页面	浏览器可访问安装页面
5. Web 页面安装	选择发行包、配置节点、完成环境检查并开始部署	安装任务全部成功
6. 安装后验收	检查集群、服务、登录、License 和业务功能	核心功能可正常使用

3. 部署前准备

3.1 准备服务器信息

信息	示例	说明
安装节点 IP	`<安装节点IP>`	K8s 单机部署只使用 1 台服务器
CPU 架构	`amd64` / `arm64`	安装器和安装包需与服务器架构一致
网络环境	在线 / 离线	可访问公网选在线；内网或隔离环境选离线
执行用户	`root` 或具备 `sudo` 权限的用户	安装器需要通过 SSH 执行部署任务
SSH 端口	`22`	如修改过 SSH 端口，按实际端口填写
访问协议	HTTP / HTTPS	测试环境可用 HTTP；正式或对外访问建议 HTTPS
访问域名	`<访问域名>` 或 `<安装节点IP>`	用户访问石墨办公套件的入口地址
数据目录	`/data`	建议使用独立数据盘挂载

3.2 准备安装物料

物料	示例文件名	说明
安装器	`mdp-installer-amd64`	`amd64` 架构示例；其他架构按实际文件名替换
产品安装包	`co1.8.20260807.3639-drive-release..tar.gz`	K8s 单机部署选择文件名中不包含 `k3s` 的发行包；文件名以实际交付为准
基础离线镜像包	`smbase_image-amd64.tar.gz`	仅离线安装需要
产品离线镜像包	`offline_app_image.tar.gz`	仅离线安装需要，需与产品安装包版本匹配

注意：

命令中的文件名需要按实际文件名替换，例如 mdp-installer-amd64、co1.8.<版本号>-drive-release.tar.gz。

产品安装包、离线镜像包和服务器 CPU 架构需保持一致。

离线安装前，建议一次性准备好基础离线镜像包和产品离线镜像包，避免部署过程中临时补包。

3.3 检查服务器资源

项目	建议要求
服务器数量	1 台
CPU	16 Core 以上
内存	32 GB 以上
系统盘	根 `/` 分区 100 GB 以上
数据盘	独立挂载 `/data`，可用空间 300 GB 以上
离线安装	数据盘建议额外预留 100 GB 以上，用于镜像包和临时解压文件

在服务器上执行：

确认以下结果：

CPU、内存和磁盘满足部署规格。

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

系统时间同步正常。

服务器可以通过 SSH 登录。

在线安装环境可以访问公网；离线安装环境已准备好离线镜像包。

3.4 检查端口

端口	用途
`22/TCP`	SSH 登录和安装任务执行
`18080/TCP`	安装器 Web 页面
`80/TCP` 或 `443/TCP`	石墨办公套件访问入口

如服务器启用了防火墙或安全组，请提前放通以上端口。

4. 上传安装工具和安装包

以下示例以 amd64 架构为例。其他架构请替换为实际文件名。

4.1 上传安装器

在本地电脑执行：

4.2 上传离线镜像包

在线安装可跳过本步骤。

离线安装需将离线镜像包上传到部署节点：

4.3 登录服务器

4.4 给安装器添加执行权限

4.5 启动安装器 Web 页面

在服务器上执行：

如果希望安装器在后台运行，可以使用：

浏览器访问：

http://<安装节点IP>:18080

5. 通过 Web 页面安装

5.1 选择发行包

进入安装器 Web 页面后，选择本次要部署的产品发行包。

K8s 单机部署请选择文件名中不包含 k3s 的发行包，例如：

co1.8.20260807.3639-drive-release.tar.gz

5.2 配置 SSH 连接

安装器会通过 SSH 登录部署节点并执行安装任务。SSH 设置支持两种认证方式：

私钥认证。

密码认证。

建议使用 root 用户或具备 sudo 权限的用户执行部署。填写后可先测试连接，确认安装器能够正常登录部署节点。

5.3 确认基础配置

选择发行包后继续下一步。没有特殊要求时，可先保持页面默认配置；如部署环境已有明确的域名、证书、网段或中间件规划，则按实际规划填写。

⑦ 启用离线安装模式：
如果使用离线安装模式，需要上传离线包到服务器并浏览文件选择离线镜像包

配置时重点确认：

访问协议和访问域名填写正确。

Pod CIDR、Service CIDR 与现网、办公网、VPN、IDC 网段不冲突。

数据目录使用 /data 或实际规划的数据盘目录。

在线 / 离线安装方式与当前网络环境一致。

5.4 初始化部署

配置完成后，点击初始化部署。页面会展示本次部署的概览信息，请重点检查：

产品包版本。

部署节点 IP。

SSH 用户和端口。

访问域名和协议。

数据目录。

在线或离线安装模式。

中间件选择。

确认无误后继续。

5.5 检查系统环境

安装器会自动检查服务器环境。

检查通过后继续部署。若出现失败项，请根据页面提示处理后重新检查。常见处理方向包括：

磁盘空间不足：清理空间或扩容数据盘。

端口不可用：释放端口或调整端口占用。

SSH 连接失败：检查账号、密码、私钥、端口和安全组。

时间同步异常：配置 NTP 或校准服务器时间。

基础命令缺失：按系统发行版安装缺失命令。

5.6 开始部署

环境检查通过后，点击开始部署。

部署过程中可以查看各组件执行日志。安装期间请保持：

安装器进程持续运行。

浏览器与安装节点网络连通。

服务器不要重启。

不要移动或删除安装包、离线镜像包和数据目录。

5.7 等待安装完成

安装过程需要等待一段时间，具体时间取决于服务器性能、网络环境和镜像拉取速度。

当页面显示所有任务执行成功，且没有失败组件时，表示部署完成。

5.8 确认安装结果

安装完成后，安装器会展示部署完成页面和访问入口信息。请先确认页面中没有失败任务，再继续访问业务系统和 MDP 运维平台。

访问业务地址：

http://<访问域名>/

如果安装时配置了 HTTPS，请访问：

https://<访问域名>/

使用默认账号或管理员账号登录后，请立即修改初始密码。

访问 MDP 运维平台：

http://<访问域名>/mdp/

如需修改 MDP 管理员密码，可在部署节点执行以下命令可修改重置密码。
请按实际安全要求将{password}替换为新的复杂强密码。

6. 安装后验收

6.1 检查 K8s 节点状态

在部署节点执行：

节点状态应为 Ready。

继续检查服务：

正常状态通常为：

Running：服务正在运行。

Completed：任务执行完成。

如出现 CrashLoopBackOff、ImagePullBackOff、Error、Pending 等状态，请先查看对应 Pod 日志并处理。

6.2 检查访问入口

浏览器访问石墨办公套件入口：

http://<访问域名>/

如果配置了 HTTPS，请访问：

https://<访问域名>/

确认登录页可以正常打开。

6.3 检查管理后台和 License

确认以下项目：

管理后台可以访问。

管理员可以登录。

License 页面可以打开。

机器信息可以查看。

可按授权流程申请或更新 License。

6.4 检查业务功能

使用测试账号或管理员创建的账号登录后，至少验证：

可以创建文档、表格、幻灯片。

文档可以编辑、保存、刷新后内容仍然存在。

多人协作编辑可用。

文件导入导出正常。

搜索、团队空间、通讯录等核心功能可用。

首次使用默认测试账号登录后，请立即修改密码。
账号密码为部署交付账号密码！

账号：autotest@example.com
密码：xxxxx

6.5 停止安装器进程

部署完成并验收通过后，可停止安装器 Web 服务：
安装web页面停止：

命令停止安装器：

如果安装器使用 nohup 后台启动，也可以查看日志：

7. 常见问题处理

7.1 浏览器无法打开安装器页面

检查方向：

安装器进程是否仍在运行。

18080 端口是否被防火墙或安全组拦截。

浏览器访问的 IP 是否为安装节点 IP。

可在服务器上执行：

7.2 环境检查不通过

根据页面提示逐项处理。处理完成后，返回安装器页面重新执行环境检查。

优先检查：

CPU、内存、磁盘是否满足要求。

/data 是否为独立数据盘。

服务器时间是否同步。

SSH 用户是否具备部署权限。

7.3 离线安装镜像拉取失败

检查方向：

离线镜像包是否已上传到部署节点。

基础离线镜像包和产品离线镜像包是否完整。

镜像包版本是否与产品安装包匹配。

私有镜像仓库地址、账号、密码是否填写正确。

7.4 Pod 长时间处于异常状态

先查看异常 Pod：

再查看日志：

根据日志处理镜像、配置、资源或依赖连接问题。

8. 安装后保留资料

部署完成后，建议保留以下资料，便于后续运维、升级和问题排查：

安装节点 IP、访问域名和访问协议。

安装器文件名和版本。

产品安装包文件名和版本。

离线镜像包文件名和版本。

Web 页面关键配置截图。

kubectl get node 检查结果。

kubectl get pod -A 检查结果。

License 授权记录。

业务功能验收记录。

部署过程中出现过的问题和处理结果。

1. 适用场景#

2. 部署流程概览#

3. 部署前准备#

3.1 准备服务器信息#

3.2 准备安装物料#

3.3 检查服务器资源#

3.4 检查端口#

4. 上传安装工具和安装包#

4.1 上传安装器#

4.2 上传离线镜像包#

4.3 登录服务器#

4.4 给安装器添加执行权限#

4.5 启动安装器 Web 页面#

5. 通过 Web 页面安装#

5.1 选择发行包#

5.2 配置 SSH 连接#

5.3 确认基础配置#

5.4 初始化部署#

5.5 检查系统环境#

5.6 开始部署#

5.7 等待安装完成#

5.8 确认安装结果#

6. 安装后验收#

6.1 检查 K8s 节点状态#

6.2 检查访问入口#

6.3 检查管理后台和 License#

6.4 检查业务功能#

6.5 停止安装器进程#

7. 常见问题处理#

7.1 浏览器无法打开安装器页面#

7.2 环境检查不通过#

7.3 离线安装镜像拉取失败#

7.4 Pod 长时间处于异常状态#

8. 安装后保留资料#