单机部署「k3s」

1. 适用场景

这篇文档按 1 台服务器说明。服务器同时承担安装节点、K3s 主节点和业务工作节点。

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

它只需要 1 台服务器，部署快，资源准备简单。

2. 部署前准备

2.1 先准备这些信息

信息	示例	说明
网络环境	在线 / 离线	服务器可访问公网时选择在线；内网、专网或无法访问公网时选择离线
安装节点 IP	`<安装节点 IP>`	单机部署时，该服务器同时作为安装节点、K3s 主节点和业务工作节点
执行用户	`root`	安装过程需要 root 权限，建议仅在部署期间使用，并妥善保管登录凭据
访问协议	HTTP / HTTPS	测试环境可使用 HTTP；生产环境或对外访问场景建议使用 HTTPS
访问域名	`<访问域名>`	用户访问石墨办公套件的域名或 IP 地址
数据目录	`/data`	建议挂载独立数据盘，避免业务数据写入系统盘
安装工具	`mdp-installer-amd64` / `mdp-installer-arm64`	按服务器 CPU 架构选择安装器：`amd64` 适用于 x86_64 架构，`arm64` 适用于 ARM64 架构
产品安装包	`co1.8.20260830.3884-drive-release-k3s.tar.gz`	石墨办公套件安装包，以实际交付文件名为准
离线镜像包	`smbase_image-amd64.tar.gz`、`offline_app_image.tar.gz`	仅离线安装需要；基础镜像包和应用镜像包需与产品安装包版本匹配

2.2 服务器最低要求

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

注意：

不要把 /root、/var、/tmp 单独分区。

数据不要放在系统盘，统一放到 /data。

安装前确认服务器时间同步正常，否则可能影响登录和服务鉴权。

可先执行：

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

注意根据实际情况修改命令中的文件名称，例如安装器包名在x86架构环境为 mdp-installer-amd64。

根据实际场景选择适合的上传方式，本文以scp命令行说明，亦可使用其它图形化ssh工具上传。

在本地电脑执行下面命令，把安装器传到服务器：

离线安装还要上传离线镜像包：

登录服务器：

给安装器加执行权限：

启动安装器 Web 页面：

浏览器访问：

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

4. 通过 Web 页面安装

4.1 上传产品安装包

打开 http://<安装节点IP>:18080。

上传石墨办公套件安装包co1.8.20260830.3884-drive-release-k3s.tar.gz。

上传完成后点击 继续。

4.2 配置访问域名和容器网段

填写用户访问石墨办公套件的方式：

配置项	怎么填
协议	HTTP 或 HTTPS
访问域名 / IP	`<访问域名>` 或 `<安装节点IP>`
Service CIDR	默认 `10.43.0.0/16`
Pod CIDR	默认 `10.42.0.0/16`

Pod CIDR 和 Service CIDR 需避开现网、办公网、VPN、IDC 网段。发现网段重合时，先调整网段，再继续部署。

4.3 配置 K3s 节点

K3s 单机部署只支持单机模式。

注意使用root权限账号执行部署。

配置项	怎么选
部署模式	`Single Node Mode`
节点 IP	`<安装节点IP>`
SSH 端口	通常为 `22`
SSH 密码	`root` 密码或者私钥
节点类型	`master`
namespace	按项目约定填写；没有约定可使用默认值
数据目录	`/data`

4.4 选择中间件

如果没有外部中间件，保持默认勾选，由安装器部署内置组件。

可选择的组件包括：

MySQL

Redis

MongoDB

MinIO

Kafka

Elasticsearch

ClickHouse

如果已有外部中间件，就取消对应组件勾选，并在后续页面填写连接信息。

石墨内置中间件

4.5 在线安装

服务器可以访问公网时，使用在线安装。按页面默认配置继续即可。

4.6 离线安装

服务器处于内网或离线环境时，使用离线安装。

操作步骤：

勾选 启用离线安装模式。

点击 浏览文件，上传离线镜像包。

填写私有镜像仓库地址、用户名和密码。

如果不填写私有镜像仓库信息，安装器会默认在部署节点上启动一套私有镜像仓库。

离线安装前再确认两件事：

离线镜像包和产品安装包版本匹配。

/data 空间足够存放镜像包和临时解压文件。

4.7 检查配置并开始安装

配置完成后点击 初始化配置。

在配置预览页检查域名、节点、网段、数据目录、中间件选择。

点击 继续，等待安装器检查服务器环境。

所有检查项通过后，再点击 继续。

查看安装计划，确认无误后点击 开始部署。

安装过程中可以点开组件查看日志。不要关闭服务器上的安装器进程。

概览

环境检查

执行计划

开始部署

4.8 安装完成

看到以下结果表示安装完成：

安装完成后访问：

5. 安装后验收

5.1 检查 K3s 状态

在服务器上执行：

节点状态应为 Ready。

继续检查服务：

正常状态：

Running：服务正在运行。

Completed：任务执行完成。

如果出现 CrashLoopBackOff、ImagePullBackOff、Error、Pending，先查看日志并处理对应组件。

5.2 停止安装器

安装完成并验收通过后，可以停止安装器进程：

页面操作

命令行操作

5.3 检查管理后台

确认：

管理后台可以访问。

管理员可以登录。

License 页面可以打开。

机器信息可以查看。

5.4 检查业务功能

访问石墨办公套件登录页：

http://<访问域名>/

使用默认测试账号登录：

首次登录后请立即修改密码。

至少验证这些功能：

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

文档可编辑、保存、协作。

文件导入导出正常。

搜索、团队空间、通讯录可用。

访问 MDP 运维平台：

<安装完成页展示的 MDP URL>

如需修改 MDP 管理员密码，可在部署节点执行以下命令。下面示例将密码修改为 xxxxxxxxxx，请按实际安全要求替换为新的强密码。

5.5 检查集成能力

如果项目涉及集成，还要验证：

域名和证书正常。

LDAP / CAS / OAuth2 登录可用。

组织架构同步可用。

6. 安装后保留资料

部署完成后，建议保留：

服务器 IP、域名、访问协议。

产品安装包版本。

离线镜像包版本。

安装配置截图或配置文件。

kubectl get node、kubectl get pod -A 检查结果。

业务功能验收结果。

已知问题和待处理事项。

1. 适用场景#

2. 部署前准备#

2.1 先准备这些信息#

2.2 服务器最低要求#

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

4. 通过 Web 页面安装#

4.1 上传产品安装包#

4.2 配置访问域名和容器网段#

4.3 配置 K3s 节点#

4.4 选择中间件#

4.5 在线安装#

4.6 离线安装#

4.7 检查配置并开始安装#

4.8 安装完成#

5. 安装后验收#

5.1 检查 K3s 状态#

5.2 停止安装器#

5.3 检查管理后台#

5.4 检查业务功能#

5.5 检查集成能力#

6. 安装后保留资料#

1. 适用场景

2. 部署前准备

2.1 先准备这些信息

2.2 服务器最低要求

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

4. 通过 Web 页面安装

4.1 上传产品安装包

4.2 配置访问域名和容器网段

4.3 配置 K3s 节点

4.4 选择中间件

4.5 在线安装

4.6 离线安装

4.7 检查配置并开始安装

4.8 安装完成

5. 安装后验收

5.1 检查 K3s 状态

5.2 停止安装器

5.3 检查管理后台

5.4 检查业务功能

5.5 检查集成能力

6. 安装后保留资料