从零搭建可直接使用的档案在线管理系统 本地部署实操全指南

一、前置环境准备

本教程采用Docker容器化部署，无需配置PHP/数据库等复杂环境，只要能联网的Windows/Mac/Linux电脑都可以操作，零代码基础也能完成。需要提前安装Docker，不同系统安装步骤如下：

Windows系统安装

直接点击链接下载安装包：https://download.docker.com/win/stable/Docker%20Desktop%20Installer.exe，下载完成后双击运行，一路点击下一步，安装完成后重启电脑，启动Docker Desktop等待初始化完成即可。

Mac系统安装

直接下载dmg安装包：https://download.docker.com/mac/stable/Docker.dmg，下载后拖动图标到应用文件夹即可，启动Docker Desktop等待初始化完成。

Linux系统安装

打开终端，直接执行以下命令，一键完成Docker安装：

``` curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun systemctl start docker systemctl enable docker ```

执行完成后输入docker -v，输出版本号就说明安装成功。

二、启动档案在线管理系统容器

Docker初始化完成后，打开终端（Windows打开PowerShell，Mac/Linux直接打开终端），根据你的系统选择对应启动命令，注意Windows用户需要修改挂载路径，否则会出现文件存储错误：

Linux/Mac系统启动命令

``` docker run -d --privileged=true -p 8080:80 -v /opt/archive-data:/var/www/html/upload --name archive-system registry.cn-hangzhou.aliyuncs.com/zero-tools/archive-online-system:1.0 ```

Windows系统启动命令

先在D盘新建文件夹，命名为archive-data，然后执行以下命令：

``` docker run -d --privileged=true -p 8080:80 -v D:/archive-data:/var/www/html/upload --name archive-system registry.cn-hangzhou.aliyuncs.com/zero-tools/archive-online-system:1.0 ```

命令执行后等待1-2分钟，镜像拉取完成就会自动启动系统，不需要额外操作。这里的-v参数是把容器内的存储目录挂载到你本地磁盘，即使容器删除，所有档案文件也会保存在本地，不会丢失，一定不能省略这个参数。

三、系统初始化与基础配置

容器启动完成后，打开浏览器，本地访问地址是http://localhost:8080，局域网其他设备访问替换成你的本机IP即可。

1. 第一次登录修改密码

默认管理员账号密码：
账号：admin
密码：123456
登录后第一件事，点击右上角头像，选择「修改密码」，设置新的管理员密码，避免未授权访问。

2. 创建档案分类

点击左侧菜单栏档案管理 > 分类管理，点击右上角「新增分类」，按以下规则填写：

• 分类名称：填写你需要的分类，比如「人事档案」「项目合同档案」「财务档案」
• 上级分类：如果是顶级分类，选择「无」，如果是子分类，选择对应的父分类即可
• 排序号：数字越小越靠前，默认填0即可

填写完成后点击保存，重复操作创建所有需要的档案分类即可。

四、核心功能操作步骤

1. 档案新增入库

点击左侧菜单档案管理 > 档案列表，点击右上角「新增档案」，按要求填写信息：

• 档案编号：填写自定义编号，支持字母数字，方便后续检索，比如RS-2024-0001
• 档案名称：填写档案的正式名称
• 所属分类：选择之前创建好的对应分类
• 档案文件：点击上传按钮，支持PDF、Word、Excel、JPG等所有常见格式，单个文件最大支持100M
• 档案描述：填写档案的备注信息，比如创建时间、适用项目等

所有信息填写完成后点击提交，就完成了档案入库，系统会自动生成预览链接。

2. 档案检索与预览

在档案列表页顶部，支持按关键词、分类检索，输入档案编号或者名称关键词，点击搜索就能一秒定位目标档案；点击档案列表的「预览」按钮，可以直接在浏览器在线查看档案内容，点击「下载」可以下载原文件到本地。

3. 用户权限分配

如果需要给多个员工开通权限，点击左侧菜单系统设置 > 用户管理，点击「新增用户」，填写账号密码，选择用户角色：

• 管理员：拥有所有操作权限，可以增删改查所有档案、管理用户
• 普通用户：只能查看和检索档案，不能修改、删除或者新增档案

保存后用户就可以用分配的账号登录使用，满足多人协同管理的需求。

五、常见问题解决

1. 无法访问系统怎么办？

首先检查容器状态，终端执行docker ps，如果列表中没有archive-system，说明容器未启动，执行docker start archive-system即可启动；如果8080端口被其他程序占用，只需要删除原有容器，把启动命令中的-p 8080:80改成-p 8081:80，重新启动即可。

2. 上传文件提示写入失败怎么办？

Windows用户检查挂载路径是否正确，必须使用正斜杠/，不能用反斜杠\，同时检查新建的文件夹有没有读写权限，给文件夹开放Everyone读写权限即可解决。

3. 如何备份所有数据？

所有档案文件和数据库都存在你挂载的本地文件夹（Linux是/opt/archive-data，Windows是D:/archive-data），直接复制整个文件夹到其他存储设备，就完成了全量备份，恢复的时候替换对应文件夹即可。

整个部署过程不超过10分钟，完成后就可以直接投入使用，支持局域网多人同时访问，如果需要公网远程访问，只需要做路由器端口映射或者搭配内网穿透工具即可，无需额外改造。