零代码搭建个人单机版文书档案系统 附完整实操步骤

前置准备

确认本地电脑已安装Docker：Windows用户直接访问https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe下载安装包；Mac用户访问https://desktop.docker.com/mac/main/amd64/Docker.dmg下载，双击安装；Linux用户执行一键安装命令：

``` curl -fsSL https://get.docker.com | sudo sh ```

安装完成后，Windows/Mac需启动Docker Desktop，Linux执行`sudo systemctl start docker`启动服务。

部署单机版文书档案系统

拉取系统镜像

打开终端（Windows用PowerShell，Mac/Linux用终端），执行以下命令拉取开源单机版文书系统镜像：

``` docker pull registry.cn-hangzhou.aliyuncs.com/opensource/onlyoffice-docspace:latest ```

该镜像为官方开源版本，无广告，完全免费用于个人单机场景。

启动系统容器

执行以下命令启动容器，需注意：本地数据和日志会挂载到你指定的路径，避免删除容器后数据丢失：

``` docker run -d \ --name my-docspace \ -p 8080:80 \ -v /Users/你的用户名/Documents/docspace/data:/var/www/docspace/data \ -v /Users/你的用户名/Documents/docspace/logs:/var/www/docspace/logs \ registry.cn-hangzhou.aliyuncs.com/opensource/onlyoffice-docspace:latest ```

Windows用户需将路径改为`C:\Users\你的用户名\Documents\docspace`，Linux用户改为`/home/你的用户名/Documents/docspace`，替换“你的用户名”为电脑当前用户名即可。

初始化系统

1. 打开浏览器，输入http://localhost:8080，进入初始化向导；
2. 填写管理员邮箱（需有效，忘记密码可通过该邮箱重置）和密码，密码长度需≥8位，包含字母和数字；
3. 设置系统名称（如“个人工作文书库”），点击「完成」，等待系统初始化（约1.5分钟）。

核心操作（直接上手使用）

上传文书文件

登录系统后，左侧导航栏点击「文档」→「上传」，选择本地要归档的文书文件，支持格式包括pdf、docx、xlsx、pptx、jpg、png等，单次最多上传100个文件，大文件会自动分片传输。

分类管理文书

1. 点击左侧「分类」→「新建分类」，输入分类名称（如“2023年度合同”“内部通知”），可设置分类可见范围为仅自己可见；
2. 上传文件时，在「分类」下拉框选择对应分类；已上传文件可点击文件右侧三个点→「移动」，选择目标分类即可。

检索文书内容

在页面顶部搜索框输入关键词，系统会自动匹配文件名和文件内文字内容，支持精准匹配和模糊搜索，搜索结果1秒内返回，点击结果可直接在线预览文书。

常见问题快速排查

容器启动失败

执行命令查看容器日志：`docker logs my-docspace`，若提示端口冲突，修改启动命令中的端口，如将`-p 8080:80`改为`-p 8081:80`，重新执行启动命令。

无法访问系统页面

执行`docker ps`，确认容器状态为「Up」，若状态非运行，执行`docker start my-docspace`启动容器；若容器正常，检查电脑防火墙是否放行8080端口。