目录

前言

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和实际挂载路径，避免因权限或目录错误导致文件无法保存。