1. 首次部署
石墨办公-部署运维文档
  • 系统环境要求速查
  • 首次部署
    • 部署流程
    • 快速开始
    • 石墨办公套件
      • 办公套件资源规划建议
      • 单机部署【k8s】
      • 单机部署【k3s】
      • 集群高可用部署【k8s】
      • License授权激活
    • 石墨文档中台
      • 单机部署【k8s】
      • 单机部署【k3s】
      • 集群部署【k8s】
      • License授权激活
  • 运维平台
    • 简介
    • 办公套件
    • 文档中台
    • 运维管理
  • 常见问题
    • 安装阶段常见问题
    • 数据备份机制
  1. 首次部署

快速开始

本文介绍如何使用部署工具,以 All-in-One 模式快速搭建本地环境,体验石墨产品功能。
本文以石墨 办公套件 的在线安装为例,该流程同样适用于 文档中台 的在线安装。
注意
快速部署仅适用于产品体验和测试目的,如需在生产环境中进行完整部署,请参考《部署指南》。

前置条件#

在开始之前,请按以下要求准备安装资源:
服务器最低要求:
操作系统架构CPU内存磁盘
Ubuntu 24.04 LTSx86_6416C32G100G SSD
操作系统:推荐 Ubuntu24.04 最小化安装,不要额外安装软件如Docker、K8s等。
系统分区:不要把 /root、/var、/tmp 单独分区。
时间同步:确认服务器时间同步正常,否则可能影响登录和服务鉴权。
网络要求:必须支持互联网连接(下载部署包、镜像资源)
权限要求:需使用 Root 用户执行安装。
端口开放:TCP 22(SSH)、18080(安装器WebUI)、80/443(业务访问)
业务域名:若使用域名访问石墨,请提前做好域名解析。(可选)

安装物料#

获取安装器#

方式一
通过ssh工具上传石墨提供的安装器文件 mdp-installer-amd64 至服务器 /root/ 目录。
方式二
在服务器上通过 wget 下载,此方式需要有石墨提供的下载链接,操作方法如下:
image.png

获取发行包#

下载石墨提供的产品发行包至本地电脑,WebUI 安装时需要上传。
文件名示例:co1.8.20260711.3286-drive-release.tar.gz

安装步骤#

注意文中图片仅供参考,安装包文件随环境和版本变化,请以实际场景为准。

1、启动安装器#

ssh root用户登录服务器,按下列指令操作启动安装器
image.png

2、打开安装器UI页面#

MDP Installer is running:
Local: http://127.0.0.1:18080/
Network: http://172.17.9.61:18080/
点击终端输出的 Network 地址,或复制到浏览器打开进入安装引导页面。
image.png

3、上传发行包#

发行包校验通过,点击“继续” 进入 配置 页面。
image.png

4、部署配置确认#

根据部署环境配置“域名/IP”、部署模式、节点登录信息、数据目录,离线仓库和第三方中间件保持默认。
image.png

5、部署配置预览#

确认无误则点击“继续”
image.png

6、执行配置预检#

所有检查通过后,点击“继续”
image.png
若发现有异常,需按提示修复,再点击“重新扫描” 验证检查结果。

7、开始部署#

image.png
页面展示安装计划执行的步骤,点击“开始部署”
此时弹出“确认开始安装”提示,确认开始后无法停止,如发现还有配置需要调整可以“取消” 返回上一步做修改。
image.png

8、部署阶段#

开始部署后,页面会展示当前执行的任务状态和相应日志,执行耗时;单机部署执行时间约10分钟左右(视服务器性能、网络带宽因素时间会有不同)。
image.png

9、交付验证#

a. 运行安装后检查,执行服务测试用例,验证各服务接口运行状态。
image.png
b. 按部署交付页面的访问信息,登录验证
image.png
💡
访问信息需做好记录,页面关闭且安装器退出来将无法再次查看 访问信息。
c. 登录mdp后台检查服务状态
mdp -> 系统服务 -> 集群管理,可以看集群节点和应用运行均为正常,表示服务启动正常。
image.png
d. 功能巡检
若交付页面的 安装后检查 未通过或部分通过,可在mdp后台再次提交巡检任务
image.png
e. 登录石墨前台页面
测试套件的创建、编辑、保存、导出、导入功能。
image.png

10、部署完成#

上述检查验证通过,整个安装过程就结束了。

下一步#

探索 石墨部署指南 了解生产环境部署方案,包括单机部署、集群部署、License授权激活、运维平台使用等。
修改于 2026-07-21 06:21:51
上一页
部署流程
下一页
办公套件资源规划建议
Built with