
docker-wps-office 是基于 Linux 系统、通过 Docker 容器化运行的 WPS 办公套件,依托 Wine 技术让 Linux 服务器也能运行 Windows 版 WPS,支持文档、表格、演示文稿等全格式编辑,适配多系统浏览器访问,核心优势是私有化存储、轻量化运行、多人协作,尤其适合自由职业者、小型团队等需要灵活办公且重视数据安全的用户,无需依赖第三方平台,文档全程存储在自有服务器,格式兼容性也远优于普通在线文档。
使用过程中能感受到,这款工具虽上手简单,但需注意目录映射的权限设置,比如确保主机与容器的 UID/GID 对齐,避免文件保存后权限混乱;另外字体映射需提前配置,否则可能出现文档排版错乱,日常使用中及时备份配置文件,能减少容器重启后的设置丢失问题。

仅在局域网内使用时,其局限性十分明显:比如异地出差想修改服务器里的报价表,只能依赖笨重的笔记本或存在泄密风险的网盘传输;团队成员在外办公时,无法实时协作修改文档,只能反复传版本文件,不仅效率低,还容易出现内容冲突,完全失去了私有化办公的灵活性。
而将 docker-wps-office 与 cpolar 内网穿透结合后,这些问题迎刃而解:无需申请公网 IP,就能生成加密的公网 HTTPS 地址,在外网通过浏览器即可访问私有 WPS,数据全程不离开自有服务器;加密隧道避免端口暴露风险,跨设备访问也无需复杂配置,不管是咖啡馆改 PPT,还是高铁上调整合同,都能随时操作,既保留了私有化的安全,又实现了移动办公的自由。

与其被各种云办公套牢,不如自己搭一个 "专属 WPS 工作站",毕竟数据是自己的,自由也是自己的!
安装教程在下面!希望能帮助到有需要的人💪
本文将手把手教你用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)登录:
shell
ssh root@IP
没有ssh的小伙伴可以参考这篇文章:
连接成功:极空间别再吃灰了!开启SSH,秒变全能服务器! - cpolar 极点云官网

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

3.安装Portainer
docker命令安装(本教程使用):
shell
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:
shell
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步骤:
使用一键脚本安装命令:
shell
sudo curl https://get.cpolar.sh | sh

安装完成后,执行下方命令查看cpolar服务状态:(如图所示即为正常启动)
shell
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
点击更新

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

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

总结
docker-wps-office 搭配 cpolar,让私有化办公摆脱了局域网的限制,既保障了数据安全,又提升了办公的灵活性。无需复杂配置,就能实现跨场景的便捷办公,满足个人和小团队的日常办公需求,是低成本且实用的办公解决方案。