OnlyOffice虚拟机安装指南

本文详细介绍了在虚拟机中从零搭建OnlyOffice Document Server测试环境的完整流程，涵盖宿主机虚拟化启用（BIOS设置+WSL2配置）、Docker运行时部署、官方镜像拉取与容器化运行、虚拟机网络桥接及9980端口开放、宿主机跨网访问验证，以及进阶的Minikube+Helm Kubernetes集群集成方案；步骤清晰、问题导向，精准覆盖初学者常遇的“启动失败”“无法访问”“服务不可用”等典型障碍，助你快速构建稳定、可验证、可扩展的协同办公文档服务环境。

如果您计划在虚拟机中搭建OnlyOffice测试环境，但尚未完成基础虚拟化平台配置或镜像部署，则可能是由于宿主机虚拟化功能未启用、Docker未就绪或网络服务未正确映射。以下是完成虚拟机内OnlyOffice测试环境搭建的步骤：

一、启用宿主机虚拟化支持

虚拟机运行依赖底层硬件虚拟化能力（如Intel VT-x/AMD-V），若未开启将导致WSL2、Docker Desktop或Minikube等组件无法启动。

1、进入BIOS/UEFI设置界面，找到“Intel Virtualization Technology”或“SVM Mode”，将其设为Enabled。

2、Windows系统中以管理员身份运行PowerShell，执行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

3、继续执行：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

4、下载并安装WSL2内核更新包（wsl_update_x64.msi），安装完成后执行：wsl --set-default-version 2

二、部署Docker运行时环境

Docker是运行OnlyOffice Document Server容器的核心载体，需确保其在虚拟机或宿主机上稳定可用。

1、在CentOS 7虚拟机中执行以下命令安装Docker CE：

sudo yum install -y yum-utils && sudo yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

2、执行：sudo yum install -y docker-ce docker-ce-cli containerd.io

3、启动服务并设为开机自启：sudo systemctl start docker && sudo systemctl enable docker

4、验证安装结果：sudo docker run hello-world

三、拉取并运行OnlyOffice Document Server镜像

该步骤直接启动官方维护的轻量级Document Server容器，适用于快速验证编辑、预览、协作等核心功能。

1、执行镜像拉取命令：sudo docker pull onlyoffice/documentserver:7.3

2、创建本地数据挂载目录：sudo mkdir -p /app/onlyoffice/logs /app/onlyoffice/data

3、运行容器并映射端口与卷：sudo docker run -i -t -d --name onlyoffice -p 9980:80 -v /app/onlyoffice/logs:/var/log/onlyoffice -v /app/onlyoffice/data:/var/www/onlyoffice/Data onlyoffice/documentserver:7.3

4、检查容器状态：sudo docker ps | grep onlyoffice

四、配置虚拟机网络与外部访问

仅启动容器不足以实现跨主机访问，需确保虚拟机网络模式允许外部流量抵达OnlyOffice监听端口。

1、若使用VirtualBox，将网卡设为“桥接网卡”模式，并确认虚拟机已获取独立局域网IP。

2、在虚拟机内开放防火墙端口：sudo firewall-cmd --permanent --add-port=9980/tcp && sudo firewall-cmd --reload

3、从宿主机浏览器访问：http://[虚拟机IP地址]:9980

4、页面加载成功后，可上传.docx文件进行实时协同编辑测试，验证文档解析与渲染能力。

五、集成Minikube构建Kubernetes测试集群

当需模拟生产级高可用部署场景时，可在虚拟机中通过Minikube启动单节点K8s集群，再部署OnlyOffice Helm Chart。

1、下载minikube二进制文件并赋予执行权限：chmod +x minikube && sudo mv minikube /usr/local/bin/

2、启动Minikube（指定驱动为docker）：minikube start --driver=docker --cpus=2 --memory=4096

3、启用Ingress插件：minikube addons enable ingress

4、添加OnlyOffice Helm仓库并安装：helm repo add onlyoffice https://onlyoffice.github.io/helm-chart && helm install onlyoffice onlyoffice/documentserver

今天关于《OnlyOffice虚拟机安装指南》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于OnlyOffice的内容请关注golang学习网公众号！