前言

临时使用其他电脑或者人在外地时,想修改存放在家中NAS里的Word、Excel和PPT文件,通常需要先把文档下载到本地,再安装对应的办公软件。修改完成后还要重新上传,很容易出现文件版本混乱。

如果极空间能够持续运行,可以把WPS Office放进Docker容器中,再通过浏览器远程进入这套桌面环境。这样文档仍然保存在NAS的映射目录中,其他设备只负责打开页面和进行操作。

本文使用的docker-wps-office并不是原生的在线协作文档系统,而是通过容器、Wine和网页远程桌面运行WPS Office。进入浏览器后,看到的仍是一套完整的桌面版WPS界面,可以新建、打开、编辑和保存办公文档。

本文将完成WPS Office容器部署、账号密码设置、本地文档目录和字体目录映射,并演示文档创建、保存和上传操作。最后再为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的小伙伴可以参考这篇文章:

《极空间别再吃灰了!开启SSH,秒变全能服务器! - 极点云官网》

957c00e3b3f0ce8aa95df96aa41b8715

2.2验证docker是否开启

使用命令:

docker -v 
systemctl status -v

没有docker的小伙伴可以参考这篇文章:《极空间开箱实录:从拆箱到远程访问保姆级教程,30分钟上手! - 极点云官网》

image-20251017103712618

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

image-20251226160112805

也可以使用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

image-20251226160221578

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

image-20251226160344576

新建一个文本文档:

image-20251226160404620

image-20251226160428519

点击保存到桌面上:

image-20251226160503331

打开映射的本地文档:

image-20251226160525839

使用本地输入法的设置:

image-20251226160820709

上传文件的操作:

image-20251226160908164

在本地部署了docker-wps-office,却只能在内网使用?

想在外网随时随地访问容器中的WPS桌面,又苦于没有公网IP、不敢直接映射端口、或受限于NAT/防火墙?

这时候,作为一款简单高效的内网穿透工具,在不改动网络架构、不暴露服务器全端口的前提下,将你本地运行的VNC或Web VNC服务通过加密隧道安全地映射到公网HTTPS地址。

无需复杂配置,一条命令即可生成专属外网链接——无论你在咖啡馆、高铁还是异地家中,只要打开浏览器,输入URL,就能秒连回你的私有WPS办公桌面,文件不上传、数据不外泄,真正实现 “办公随行,安全可控”。

接下来,我们就来看看如何为docker-wps-office打通内外网通道。

4.安装

将你本地电脑中的服务(如 SSH、Web、数据库)映射到公网。即使你在家里或外出时,也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤:

使用一键脚本安装命令:

sudo curl https://get.cpolar.sh | sh

e464b045413a024674a93ea472511b0f

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

sudo systemctl status cpolar

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

打开浏览器访问本地9200端口,使用账户密码登录即可,登录后即可对隧道进行管理。

3af79ad708cc47c5bbea0b63c2c7230d

5.配置公网地址

登录web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道:

  • 隧道名称:可自定义,本例使用了:wps,注意不要与已有的隧道名称重复
  • 协议:http
  • 本地地址:3000
  • 域名类型:随机域名
  • 地区:选择China Top

image-20251226162936282

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

image-20251226162955456

访问成功。

image-20251226163024224

6.保留固定公网地址

为其配置二级子域名,该地址为固定地址,不会随机变化。

image-20250918151358733

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

image-20251226163112518

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

image-20251226163644836

修改隧道信息,将保留成功的二级子域名配置到隧道中

  • 域名类型:选择二级子域名
  • Sub Domain:填写保留成功的二级子域名
  • 地区: China Top

点击更新

image-20251226163720594

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

image-20251226163733363

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

image-20251226163752335

总结

完成以上配置后,WPS Office已经可以在极空间的Docker容器中运行。通过浏览器登录后,可以进入图形化桌面,打开文字、表格、演示和PDF等常见文件。

将极空间中的办公文档目录挂载到容器桌面后,在WPS中创建或修改的文件可以直接保存回NAS。这样无论使用哪台电脑登录,看到的都是同一份本地文档,不必反复上传和下载。

为3000端口建立公网隧道后,原本只能在家庭局域网中访问的WPS页面,也可以从其他网络环境打开。继续配置固定二级子域名后,远程办公入口能够保持不变。

需要注意的是,这套方案本质上是远程操作容器中的桌面版WPS,并不等同于OnlyOffice等多人实时协作平台。正式开放公网访问前,应修改admin/admin默认账号密码,并谨慎评估privilegedseccomp=unconfined和目录挂载带来的权限风险。建议只映射确实需要编辑的文件夹,同时定期备份办公文档和容器配置。

更多推荐