需先启用宿主机虚拟化、部署docker、运行onlyoffice镜像、配置网络访问，最后可选minikube集成；各步依次为bios开启vt-x/svm、安装wsl2、centos装docker、拉取并运行onlyoffice/documentserver:7.3镜像、桥接网络并开放9980端口、宿主机访问验证，以及通过minikube+helm部署k8s集群。
如果您计划在虚拟机中搭建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
