目录
前言
1.docker-wps-office是什么?
2.前提条件
2.1ssh远程连接到极空间
2.2验证docker是否开启
3.安装Portainer
4.安装cpolar
5.配置公网地址
6.保留固定公网地址
总结
前言
在不同电脑之间处理Word、Excel和PPT文件时,最麻烦的不只是文档同步,还包括软件安装、字体差异和使用环境不一致。对于已经长期运行NAS的用户,可以考虑把一套固定的办公环境放到服务器中,再通过浏览器远程使用。
docker-wps-office是一套社区维护的容器镜像。它并不是OnlyOffice或Collabora Online那样的原生Web办公系统,而是通过Wine在Linux容器中运行桌面版WPS Office,再把图形桌面显示到浏览器中。
这种方式的优势是能够保留较完整的桌面版WPS操作体验,并将指定的NAS目录映射到容器桌面。创建或编辑的文件可以直接保存在极空间中,换一台设备时仍能进入同一套办公环境。
本文将演示如何在极空间中部署docker-wps-office,配置账号、文档目录、字体和图形设备,并通过浏览器完成文档新建、保存和上传。随后再使用cpolar为3000端口配置公网地址,让人在其他网络环境中也能进入这套远程WPS桌面。
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的小伙伴可以到cpolar官网参考这篇文章:
《极空间别再吃灰了!开启SSH,秒变全能服务器! - cpolar 极点云官网》
2.2验证docker是否开启
使用命令:
docker -v systemctl status -v
没有docker的小伙伴可以去cpolar官网参考这篇文章:《极空间开箱实录:从拆箱到远程访问保姆级教程,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 Office已经可以在极空间的Docker容器中运行。通过浏览器打开极空间IP和3000端口后,可以进入远程桌面,使用WPS新建、编辑和保存文档。
将NAS中的文档目录挂载到/config/Desktop后,容器内保存到桌面的文件可以同步出现在极空间对应目录中。这样即使更换访问设备,文档和办公环境仍然保留在NAS上。
通过cpolar为3000端口建立公网隧道后,原本只能在局域网中使用的远程桌面,也可以从其他网络环境访问。继续配置固定二级子域名后,入口地址能够保持不变。
需要说明的是,这套方案并不是原生在线文档平台,也不等同于OnlyOffice或Collabora Online。浏览器中看到的是容器里的WPS桌面,因此它更适合个人远程办公,而不是多人同时编辑同一份文档。
当前示例使用了admin/admin默认凭据,并启用了特权模式和宽松的seccomp策略。正式开放公网前,应立即修改账号密码,确认是否真的需要privileged、seccomp=unconfined及显卡设备挂载,并尽量降低容器权限。
公网远程桌面能够访问文件、输入内容并操作完整应用,风险高于普通网页。建议限制固定地址的分享范围,增加额外访问认证,并定期备份文档和config目录。还应核对PUID、PGID和实际挂载路径,避免因权限或目录错误导致文件无法保存。