极空间部署docker-wps-office:浏览器远程办公与公网访问

📅 2026/8/4 14:30:21
极空间部署docker-wps-office:浏览器远程办公与公网访问
目录前言1.docker-wps-office是什么2.前提条件2.1ssh远程连接到极空间2.2验证docker是否开启3.安装Portainer4.安装cpolar5.配置公网地址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 rootIP没有ssh的小伙伴可以到cpolar官网参考这篇文章《极空间别再吃灰了开启SSH秒变全能服务器 - cpolar 极点云官网》2.2验证docker是否开启使用命令docker -v systemctl status -v没有docker的小伙伴可以去cpolar官网参考这篇文章《极空间开箱实录从拆箱到远程访问保姆级教程30分钟上手 - cpolar 极点云官网》3.安装Portainerdocker命令安装本教程使用docker run -d \ --name wps \ --privileged \ --security-opt seccompunconfined \ -e PUID1000 \ -e PGID1001 \ -e TZAsia/Shanghai \ -e CUSTOM_USERadmin \ -e PASSWORDadmin \ -v ./config:/config \ -v /vol1/1000/办公文档:/config/Desktop \ -v ./Fonts:/usr/share/fonts/wps-fonts \ -p 3000:3000 \ -p 3001:3001 \ --shm-size1gb \ --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: # 环境变量配置 - PUID1000 # 用户 ID建议与主机一致 - PGID1001 # 用户组 ID建议与主机一致 - TZAsia/Shanghai # 时区设置 - CUSTOM_USERadmin # HTTP 基本认证用户名默认无认证 - PASSWORDadmin # 用户密码 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.安装cpolarcpolar 可以将你本地电脑中的服务如 SSH、Web、数据库映射到公网。即使你在家里或外出时也可以通过公网地址连接回本地运行的开发环境。❤️以下是安装cpolar步骤使用一键脚本安装命令sudo curl https://get.cpolar.sh | sh安装完成后执行下方命令查看cpolar服务状态如图所示即为正常启动sudo systemctl status cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机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、seccompunconfined及显卡设备挂载并尽量降低容器权限。公网远程桌面能够访问文件、输入内容并操作完整应用风险高于普通网页。建议限制固定地址的分享范围增加额外访问认证并定期备份文档和config目录。还应核对PUID、PGID和实际挂载路径避免因权限或目录错误导致文件无法保存。