轻量开源档案管理系统DocuSeal从零搭建核心落地方法实操指南

准备环境

本方法用Docker+Docker Compose实现，无服务器也可用本地虚拟机/云服务器试用版，推荐配置：2核4G内存（至少1核2G）、20G以上可用空间。

安装Docker与Docker Compose

• 云服务器（Linux CentOS7+/Ubuntu20.04+）

  执行以下一键脚本（复制全部回车即可）：

  ``` 国内镜像源一键安装Docker curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun 启动Docker并设置开机自启 systemctl start docker systemctl enable docker 下载Docker Compose二进制文件（国内加速） curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose 赋予执行权限 chmod +x /usr/local/bin/docker-compose 验证安装成功 docker -v docker-compose -v ```

• 本地Windows/Mac

  直接下载Docker Desktop（含Docker Compose）：https://www.docker.com/products/docker-desktop/ ，安装后打开并等待右下角Docker图标变绿。

核心落地：配置与启动DocuSeal

创建工作目录，所有文件放在这里，避免混乱。

步骤1：创建目录与配置文件

• Linux云服务器

  ``` 创建工作目录 mkdir -p /opt/docuseal 进入目录 cd /opt/docuseal 编辑docker-compose.yml配置文件 vi docker-compose.yml ```

• 本地Windows

  在D盘或桌面新建文件夹命名为`docuseal`，右键新建文本文档，粘贴下方内容后保存，重命名为`docker-compose.yml`（注意取消“隐藏已知文件扩展名”）。

• 本地Mac

  ``` 创建工作目录 mkdir -p ~/docuseal 进入目录 cd ~/docuseal 编辑docker-compose.yml配置文件 nano docker-compose.yml ```

完整可直接复制的docker-compose.yml内容：

``` version: '3.8' services: docuseal: 国内镜像源拉取，速度更快 image: hub.fastgit.xyz/docuseal/docuseal:latest container_name: docuseal restart: always ports: - "3000:3000" volumes: - ./data:/data - ./config:/config environment: 管理后台初始账号密码，首次登录后立即修改 ADMIN_EMAIL: admin@example.com ADMIN_PASSWORD: Admin@123456 存储方式：默认本地/data目录，无需修改 STORAGE_TYPE: local ```

注意：Linux用vi编辑的话，按`i`进入插入模式粘贴，粘贴后按`Esc`退出插入，输入`:wq`回车保存退出；Mac用nano编辑的话，按`Ctrl+O`回车保存，`Ctrl+X`退出。

步骤2：启动服务

进入工作目录后执行命令：

``` docker-compose up -d ```

等待1-2分钟，查看状态确认成功：

``` docker-compose ps ```

看到`STATUS`列是`Up`开头即可。

步骤3：首次登录与初始配置

• 访问地址：云服务器用`http://云服务器公网IP:3000`，本地用`http://localhost:3000`
• 登录：用配置文件的`admin@example.com`和`Admin@123456`
• 必做的初始安全配置：登录后点击右上角头像→Profile，修改邮箱为自己常用的，修改密码为复杂密码（含大小写字母、数字、特殊符号）
• 可选配置：点击Settings→General，修改系统名称为“XX公司/单位档案管理系统”

核心落地方法：档案分类与批量导入

这是档案管理系统的核心功能，做好这两步能直接用起来。

档案分类（标签+文件夹树）

DocuSeal支持双重分类机制：标签灵活打标，文件夹树固定层级，适合大部分场景。

1. 创建固定文件夹树

• 点击左侧菜单“Folders”→右上角“New Folder”
• 输入文件夹名称，比如“行政档案”，选择父文件夹为“Root”（根目录），点击Create
• 继续在“行政档案”下创建子文件夹：“会议纪要”“红头文件”“人事任命”（操作类似，父文件夹选对应的上级）
• 同理创建“业务档案”“财务档案”等一级文件夹

2. 创建灵活标签

• 点击左侧菜单“Tags”→右上角“New Tag”
• 输入标签名称，比如“2024年度”“机密”“待归档”，可以设置颜色，点击Create

批量导入档案

DocuSeal支持单文件批量上传和压缩包批量解压上传（保留文件夹结构），重点讲压缩包方式，效率最高。

1. 准备压缩包

• 在本地电脑整理好已有档案，按照刚才创建的文件夹树建好本地目录，比如：

行政档案/
├─ 会议纪要/
│  ├─ 2024-01-01 总经理办公会.pdf
│  └─ 2024-01-15 业务研讨会.docx
└─ 红头文件/
└─ 2024-001号 关于春节放假的通知.pdf

• 选中“行政档案”这个文件夹，右键压缩成ZIP格式（不要用RAR，系统仅支持ZIP）

2. 上传并解压

• 点击左侧菜单“Upload”→选择“Upload ZIP file with folders”
• 选择刚才的ZIP压缩包，点击“Start Upload”
• 上传完成后，点击左侧“Folders”就能看到刚才的文件夹结构和文件了
• 可选批量打标：在文件夹视图下，点击右上角的“Select All”，选中要打标的文件，点击顶部“Add Tags”，选择标签比如“2024年度”，点击Add

核心落地方法：档案检索与权限控制

这是日常使用最多的两个功能，检索要快，权限要准。

档案快速检索

• 顶部搜索框支持全文检索（PDF、Word、Excel等常见格式都能识别内容）、文件名检索、标签+文件夹组合检索
• 组合检索示例：在搜索框输入`folder:行政档案 tag:2024年度 放假`，就能找到行政档案目录下2024年度含“放假”关键词的文件

基础权限控制

适合小团队/单位，给不同人分配不同的文件夹权限。

1. 创建普通用户

• 点击左侧菜单“Users”→右上角“New User”
• 输入用户邮箱、设置初始密码，点击Create

2. 分配文件夹权限

• 点击左侧“Folders”，选择要分配权限的文件夹，比如“财务档案”
• 点击右侧的“Share”→输入刚才创建的用户邮箱，选择权限（Viewer仅查看，Editor可编辑、上传、下载，Manager可管理权限），点击Share

数据备份（必做）

数据是档案管理的核心，务必定期备份。

• 进入工作目录，直接压缩`data`文件夹（所有档案、数据库都在这里）即可备份
• Linux云服务器备份命令：
``` cd /opt/docuseal tar -zcvf docuseal_backup_$(date +%Y%m%d).tar.gz data ```
• 备份后下载到本地或另一台服务器