乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > 不用安装 Office:Docker 部署 WPS,浏览器即可编辑 Word、Excel、PPT

不用安装 Office:Docker 部署 WPS,浏览器即可编辑 Word、Excel、PPT

当前时间： 2026-08-16 23:37:33 分类：办公文件 评论(0)
不用安装 Office:Docker 部署 WPS,浏览器即可编辑 Word、Excel、PPT

云服务器、NAS 上想编辑 Word、Excel、PPT，又不想装 Office 或给宿主机装完整桌面？linuxserver/wps-office 把 WPS Office 装进 Docker 容器，你在 本机浏览器 里打开就是完整 WPS 界面——宿主机无需安装 Office，支持文档、表格、演示和 PDF。

电脑不用装 Office，浏览器就能办公。本文带你完成 WPS Office Docker Compose 部署：镜像加速拉取、编写 docker-compose.yml、HTTPS 登录、新建文档、侧边栏上传并编辑——全程零基础可跟做。

浏览器中的 WPS Office 中文主界面

图 1：部署成功后，浏览器里就是完整 WPS Office 中文界面

一、WPS Office 容器是什么？

linuxserver/wps-office 是 LinuxServer.io 维护的 容器化 WPS Office 办公套件，基于 Selkies 技术把 GUI 画面编码后通过 Web 推流到浏览器。核心特点：

能力
说明
浏览器访问
打开 https://服务器IP:3001 即可操作 WPS，无需 VNC 客户端
全功能办公
支持 Writer（文字）、Spreadsheet（表格）、Presentation（演示）、PDF
宿主机无 Office
WPS 跑在 容器内，宿主机保持纯 CLI
中文界面
通过 LC_ALL=zh_CN.UTF-8 设置中文
文件传输
侧边栏支持浏览器与容器之间 上传 / 下载 文件
持久化
/config
 卷保存用户配置、桌面文件与文档

典型场景：云服务器临时编辑合同报告；内网共享在线办公；NAS 按需启动用完即关。

与 OnlyOffice 的区别：本镜像提供 完整 WPS 桌面客户端体验，适合个人或小团队内网使用。

二、环境要求

项目
建议
操作系统
Linux（本文 Ubuntu 24.04）
Docker
已安装 Docker 与 Docker Compose V2
架构
x86-64（amd64）
；arm64 不支持
内存
≥ 2 GB（推荐 4 GB）
CPU
双核即可；无 AVX2 老 CPU 加 PIXELFLUX_WAYLAND=false
磁盘
≥ 5 GB
端口
13000
（HTTP）、3001（HTTPS，推荐）

验证 Docker：

docker --version
docker compose version

若尚未安装 Docker，可使用轩辕镜像一键脚本：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

三、拉取镜像并 Compose 部署

本文使用固定版本标签 version-11.1.0.11723-2（WPS 11.1.0）。

3.1 检查端口与用户 ID

ss -tlnp | grep -E ':3000|:3001'
id

本文实测：宿主机 3000 被 PM2 占用 → 映射 13000；3001 空闲 → 直接用；PUID/PGID 为 0/0（root）。

3.2 创建目录

mkdir -p /www/wwwroot/wps-office/config
cd /www/wwwroot/wps-office

3.3 拉取镜像

docker pull docker.xuanyuan.run/linuxserver/wps-office:version-11.1.0.11723-2
官方镜像
轩辕镜像加速拉取
linuxserver/wps-office:version-11.1.0.11723-2docker.xuanyuan.run/linuxserver/wps-office:version-11.1.0.11723-2

3.4 编写 docker-compose.yml

services:
  wps-office:
    image: docker.xuanyuan.run/linuxserver/wps-office:version-11.1.0.11723-2
    container_name: wps-office
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - LC_ALL=zh_CN.UTF-8
      - CUSTOM_USER=admin
      - PASSWORD=你的强密码
      - PIXELFLUX_WAYLAND=false
    volumes:
      - ./config:/config
    ports:
      - "13000:3000"
      - "3001:3001"
    shm_size: "1gb"
    restart: unless-stopped
配置项
说明
CUSTOM_USER
 / PASSWORD
HTTP 基本认证
，务必设置
LC_ALL=zh_CN.UTF-8
WPS 中文界面
shm_size: 1gb必设
，Electron 应用必需
13000:3000
避开宿主机 3000 被占用
PIXELFLUX_WAYLAND=false
老 CPU 无 AVX2 时更稳定

3.5 启动

docker compose up -d
docker compose logs -f wps-office

成功时日志关键行：

[ls.io-init] CPU does not support AVX2. Falling back to X11
INFO:selkies.__main__:Starting Selkies in 'websockets' mode.
INFO:data_websocket:Data WebSocket Server listening on port 8082
INFO:main:SelkiesStreamingApp initialized: encoder=x264enc, display=1024x768

看到 Falling back to X11 表示已自动回退，可正常使用。按 Ctrl+C 退出日志跟踪。

四、浏览器访问与登录

方式
地址
说明
HTTP
http://服务器IP:13000
能打开登录框，WPS 可能提示需 HTTPS
HTTPS（推荐）https://服务器IP:3001
自签名证书，需手动信任

本文实测：https://192.168.1.10:3001

浏览器弹出 HTTP 基本认证，输入 CUSTOM_USER 与 PASSWORD：

HTTP 基本认证登录框

图 2：访问 http://192.168.1.10:13000 时的 HTTP 基本认证界面

若通过 HTTP 进入后看到以下报错，说明 WPS 强制要求 HTTPS：

HTTPS 强制要求报错

图 3：HTTP 访问时提示需要安全连接（HTTPS）

处理：改用 https://服务器IP:3001 访问：

HTTPS 基本认证登录框

图 4：访问 https://192.168.1.10:3001 时的 HTTPS 登录界面

证书警告：内网可点「高级 → 继续访问」；公网建议 Nginx 反代并配置正式证书。

五、WPS Office 使用演示

登录后进入 WPS Office 中文主界面（见文首图 1），左侧可新建/打开文档。

5.1 打开与新建文档

打开文件对话框

图 5：打开文件对话框，支持按文档类型筛选

新建文档界面

图 6：新建界面——支持文字、表格、演示、PDF 及思维导图等

WPS Writer 新建文档模板

图 7：WPS 文字新建页——空白文档与商业计划书等模板

5.2 上传与编辑

Selkies 侧边栏 Files 面板支持从浏览器上传文件到容器 /config/Desktop/。

桌面上的已上传文档

图 8：侧边栏上传后，桌面目录出现「开户确认书.docx」

双击打开即可在浏览器中完整编辑：

编辑 Word 文档

图 9：在 WPS Writer 中编辑「开户确认书.docx」

六、安全提醒

  • • 默认无认证——未设 PASSWORD 时任何人可访问。
  • • Web 界面含 无密码 sudo 终端，有 GUI 访问权的人等同容器内 root。
  • • 不要裸奔公网；内网也建议强密码 + 防火墙限制 IP。
  • • 完整功能依赖 HTTPS；公网请用 Nginx 反代 + 正式证书。

七、常见问题 FAQ

Q1：3000 端口被占用？

宿主机 3000 被 PM2 等占用时，改映射为 13000:3000，排查：ss -tlnp | grep :3000。

Q2：页面提示需要 HTTPS？

请访问 https://服务器IP:3001，并接受自签名证书。

Q3：日志里 Falling back to X11 有影响吗？

无 AVX2 老 CPU 自动回退，可正常使用。建议加 PIXELFLUX_WAYLAND=false。

Q4：界面黑屏或崩溃？

确认 shm_size: "1gb" 已设置。

Q5：如何升级 / 停止？

# 升级
cd /www/wwwroot/wps-office
docker compose pull && docker compose down && docker compose up -d

# 停止（保留 config）
docker compose down

八、命令速查

操作
命令
拉取镜像
docker pull docker.xuanyuan.run/linuxserver/wps-office:version-11.1.0.11723-2
启动
cd /www/wwwroot/wps-office && docker compose up -d
查看日志
docker compose logs -f wps-office
HTTPS 访问
https://服务器IP:3001
停止服务
cd /www/wwwroot/wps-office && docker compose down

总结

linuxserver/wps-office = 不用安装 Office，浏览器里就是 WPS 办公环境：

  • • 使用轩辕镜像加速拉取 linuxserver/wps-office:version-11.1.0.11723-2
  • • docker compose up -d → https://服务器IP:3001 登录
  • • 新建/打开/编辑 Word、Excel、PPT，侧边栏可上传文件
  • • 踩坑记住：3000 改映射 13000、必须用 HTTPS（3001）、老 CPU 加 PIXELFLUX_WAYLAND=false
  • • 按需启停，用完 docker compose down 释放内存

延伸阅读（复制打开）：

LinuxServer GitHub：

https://github.com/linuxserver/docker-wps-office

Docker Hub：

https://hub.docker.com/r/linuxserver/wps-office

linuxserver/wps-office 轩辕镜像页：

https://xuanyuan.cloud/zh/r/linuxserver/wps-office

轩辕镜像首页：

https://xuanyuan.cloud

如果你在拉取 Docker 镜像时遇到速度慢、超时等问题，可以试试轩辕镜像的加速服务。欢迎收藏 linuxserver/wps-office 镜像页，获取最新标签与更新说明：

https://xuanyuan.cloud/zh/r/linuxserver/wps-office

环境变量速查、安全提醒与更多 FAQ，详细步骤请查看：

https://xuanyuan.cloud/blog/docker-wps-office

本文基于 linuxserver/wps-office:version-11.1.0.11723-2 镜像，Ubuntu 24.04 服务器实测