前言
还在为办公文档依赖本地WPS客户端而烦恼?
想随时随地在浏览器里打开、编辑Word、Excel、PPT,却不愿上传文件到第三方云盘?其实,你完全可以把“类 WPS”的办公体验私有化部署在自己的服务器上!借助开源办公套件(如OnlyOffice或Collabora Online)与Docker的强大组合,只需一条命令,就能搭建一个功能完整、兼容主流格式、支持多人协作的Web版在线办公平台——无需安装客户端,不依赖公网服务,数据完全掌握在自己手中。本文将手把手教你用Docker 一键部署这套私有化办公系统,实现「浏览器即开即用」的WPS替代方案。无论是在家远程办公、团队协同,还是搭建个人NAS办公中心,从此文档处理,自由又安全。
1.docker-wps-office是什么?
docker-wps-office是一款社区维护的Docker镜像,通过Wine在Linux容器中运行Windows版WPS Office,旨在实现办公软件的容器化封装与便捷启动。
WPS Office是一款功能丰富、轻量高效的综合办公套件,广泛兼容Microsoft Office格式,支持文档(Writer)、表格(Spreadsheets)、演示文稿(Presentation)及PDF文件的编辑与查看,显著提升日常办公效率。
核心功能:
容器化封装:无需安装完整桌面环境或虚拟机,通过Docker将WPS Office封装运行,简化部署流程,便于在统一环境中管理办公应用。
主机用户映射:支持将容器内进程与主机用户UID/GID对齐,确保创建或编辑的文档保留正确的文件所有权,避免权限混乱。
镜像持续维护:社区定期同步基础环境更新与兼容性修复,提升稳定性。
兼容性增强:可选启用宽松的seccomp策略或挂载必要设备节点,适配WPS在容器中运行所需的系统调用,改善启动与功能完整性。
2.前提条件
2.1ssh远程连接到极空间
- 开启【SSH 服务】
- 使用终端(Windows PowerShell / Mac Terminal)登录:
ssh root@IP
没有ssh的小伙伴可以参考这篇文章:
连接成功:极空间别再吃灰了!开启SSH,秒变全能服务器! – cpolar 极点云官网

2.2验证docker是否开启
使用命令:
docker -v
systemctl status -v
没有docker的小伙伴可以参考这篇文章:极空间开箱实录:从拆箱到远程访问保姆级教程,30分钟上手! – cpolar 极点云官网

3.安装Portainer
docker命令安装(本教程使用):
docker run -d \
--name wps \
--privileged \
--security-opt seccomp=unconfined \
-e PUID=1000 \
-e PGID=1001 \
-e TZ=Asia/Shanghai \
-e CUSTOM_USER=admin \
-e PASSWORD=admin \
-v ./config:/config \
-v /vol1/1000/办公文档:/config/Desktop \
-v ./Fonts:/usr/share/fonts/wps-fonts \
-p 3000:3000 \
-p 3001:3001 \
--shm-size="1gb" \
--device /dev/dri:/dev/dri \
--restart always \
lscr.io/linuxserver/wps-office:chinese

也可以使用Docker Compose:
docker-compose.yml
services:
wps-office:
image: lscr.io/linuxserver/wps-office:chinese
container_name: wps
privileged: true # 特权模式,可选开启与否
security_opt:
- seccomp:unconfined # 放宽系统调用限制(可选)
environment: # 环境变量配置
- PUID=1000 # 用户 ID,建议与主机一致
- PGID=1001 # 用户组 ID,建议与主机一致
- TZ=Asia/Shanghai # 时区设置
- CUSTOM_USER=admin # HTTP 基本认证用户名(默认无认证)
- PASSWORD=admin # 用户密码
volumes: # 挂载目录
- ./config:/config # WPS 配置文件
- /vol1/1000/文档:/config/Desktop # 自定义文档映射目录到 WPS 桌面
- ./Fonts:/usr/share/fonts/wps-fonts # 映射字体路径
ports: # 端口映射
- 3000:3000 # HTTP 端口
- 3001:3001 # HTTPS 端口(反代用)
shm_size: "1gb" # 共享内存设置,防止内存不足
devices:
- /dev/dri:/dev/dri # 显卡设备挂载,支持图形加速
restart: always # 自动重启策略
在浏览器中输入 http://极空间IP:3000 就能看到登录界面:
默认账号名/密码:admin/admin

登录成功后,即可访问页面:

新建一个文本文档:


点击保存到桌面上:

打开映射的本地文档:

使用本地输入法的设置:

上传文件的操作:

在本地部署了docker-wps-office,却只能在内网使用?
想在外网随时随地访问容器中的WPS桌面,又苦于没有公网IP、不敢直接映射端口、或受限于NAT/防火墙?
这时候,cpolar就成了关键一环。作为一款简单高效的内网穿透工具,cpolar能在不改动网络架构、不暴露服务器全端口的前提下,将你本地运行的VNC或Web VNC服务通过加密隧道安全地映射到公网HTTPS地址。
无需复杂配置,一条命令即可生成专属外网链接——无论你在咖啡馆、高铁还是异地家中,只要打开浏览器,输入cpolar提供的URL,就能秒连回你的私有WPS办公桌面,文件不上传、数据不外泄,真正实现 “办公随行,安全可控”。
接下来,我们就来看看如何用cpolar为docker-wps-office打通内外网通道。
4.安装cpolar
cpolar 可以将你本地电脑中的服务(如 SSH、Web、数据库)映射到公网。即使你在家里或外出时,也可以通过公网地址连接回本地运行的开发环境。
❤️以下是安装cpolar步骤:
使用一键脚本安装命令:
sudo curl https://get.cpolar.sh | sh

安装完成后,执行下方命令查看cpolar服务状态:(如图所示即为正常启动)
sudo systemctl status cpolar

Cpolar安装和成功启动服务后,在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面,使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可:
打开浏览器访问本地9200端口,使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

5.配置公网地址
登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道:
- 隧道名称:可自定义,本例使用了:wps,注意不要与已有的隧道名称重复
- 协议:http
- 本地地址:3000
- 域名类型:随机域名
- 地区:选择China Top

创建成功后,打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址,接下来就可以在其他电脑或者移动端设备(异地)上,使用地址访问。

访问成功。

6.保留固定公网地址
使用cpolar为其配置二级子域名,该地址为固定地址,不会随机变化。

点击左侧的预留,选择保留二级子域名,地区选择china Top,然后设置一个二级子域名名称,我使用的是wpss,大家可以自定义。填写备注信息,点击保留。

登录cpolar web UI管理界面,点击左侧仪表盘的隧道管理——隧道列表,找到所要配置的隧道,点击右侧的编辑。

修改隧道信息,将保留成功的二级子域名配置到隧道中
- 域名类型:选择二级子域名
- Sub Domain:填写保留成功的二级子域名
- 地区: China Top
点击更新

更新完成后,打开在线隧道列表,此时可以看到随机的公网地址已经发生变化,地址名称也变成了保留和固定的二级子域名名称。

最后,我们使用固定的公网地址在任意设备的浏览器中访问,可以看到成功访问的页面,这样一个永久不会变化的二级子域名公网网址即设置好了。

总结
在远程办公与数据隐私意识日益增强的今天,许多人希望将办公环境完全掌控在自己手中——既不想依赖WPS云、腾讯文档等第三方平台,又希望能随时随地访问功能完整的办公套件。虽然WPS Office本身是一款优秀的桌面软件,但它并不原生支持浏览器直接使用。不过,借助社区维护的docker-wps-office镜像(基于Linux + Wine + VNC),我们可以将其封装进容器,运行一个带图形界面的私有 WPS 桌面;再结合cpolar内网穿透工具,将本地VNC或Web VNC端口安全映射到公网,实现“在外网通过浏览器或VNC客户端远程操作WPS”的能力。这不仅让办公环境真正私有化,还兼顾了灵活性与移动性——你的文档始终留在本地,而WPS桌面却可随身携带。本文将带你快速搭建这一组合,打造属于你的“云端WPS工作站”。
感谢您对本篇文章的喜爱,有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站



