从零搭建轻量工程档案管理系统 1小时落地即可投入正式使用

发布时间: 2026年06月26日 21:20:02 来源: 安答联动浏览量: 0

前置准备

本次搭建不需要编写代码，全流程可视化操作，所需资源如下：

运行环境：2核4G云服务器（Linux CentOS7+/Ubuntu20+）或Windows10及以上电脑，带宽不低于5M
依赖软件：Docker、Docker Compose，安装命令直接复制执行即可

Linux环境执行以下命令安装依赖：

```bash 安装Docker curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun systemctl enable --now docker 安装Docker Compose curl -L https://github.com/docker/compose/releases/download/v2.17.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ```

Windows环境直接下载安装包：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe，安装完成后默认自带Docker Compose，无需额外配置。

验证安装成功：执行命令docker -v、docker compose version，返回版本号即表示环境正常。

第一步：部署系统服务

1. 新建部署目录，执行命令：mkdir -p /opt/archive && cd /opt/archive（Windows系统直接在D盘新建archive文件夹，打开文件夹后右键启动终端）

2. 新建docker-compose.yml配置文件，将以下完整内容复制粘贴保存：

```yaml version: '3.8' services: archive-mysql: image: mysql:8.0.32 container_name: archive-mysql restart: always environment: MYSQL_ROOT_PASSWORD: 123456 MYSQL_DATABASE: archive TZ: Asia/Shanghai volumes: - ./mysql:/var/lib/mysql command: --default-authentication-plugin=mysql_native_password --max_allowed_packet=2G archive-web: image: registry.cn-hangzhou.aliyuncs.com/open-tools/engineering-archive:2.3 container_name: archive-web restart: always ports: - "8080:80" environment: DB_HOST: archive-mysql DB_PORT: 3306 DB_USER: root DB_PASSWORD: 123456 DB_NAME: archive TZ: Asia/Shanghai MAX_UPLOAD_SIZE: 2G volumes: - ./file:/var/www/html/upload depends_on: - archive-mysql ```

3. 执行启动命令：docker compose up -d，等待3分钟左右服务启动完成。

第二步：系统初始化配置

服务启动后访问地址：http://你的服务器IP:8080（本地部署访问http://localhost:8080），默认超级管理员账号：admin，默认密码：123456，首次登录请强制修改密码。

2.1 配置档案分类规则

按工程全生命周期配置分类，操作路径：左侧菜单「系统配置」→「档案分类」→「新增分类」，推荐配置如下：

前期准备类：必填字段配置为项目名称、建设单位、备案编号、文件有效期
施工过程类：必填字段配置为标段、施工单位、报验时间、监理单位、部位编号
竣工验收类：必填字段配置为验收时间、验收单位、验收结论、备案编号
运维阶段类：必填字段配置为维保单位、故障时间、处理结果、维保周期

从零搭建轻量工程档案管理系统 1小时落地即可投入正式使用

所有分类均支持自定义扩展字段，可根据项目实际需求添加。

2.2 配置角色权限

操作路径：左侧菜单「系统配置」→「角色管理」→「新增角色」，按需创建对应角色并分配权限：

施工员：仅勾选「档案上传、我的档案查询、驳回修改」权限，仅可操作本人上传的档案
监理：仅勾选「档案审核、全量档案查询、档案导出」权限，可审核所有待审核档案
项目管理员：勾选全部权限，可配置系统规则、管理所有用户和档案

创建完成后在「用户管理」模块新增对应账号，分配对应角色即可。

第三步：核心功能实操

3.1 档案上传归档

施工员账号登录后，左侧菜单点击「档案上传」，选择对应分类，填写所有必填字段，上传对应文件即可，支持PDF、Word、Excel、CAD、图片、视频等所有主流格式，单个文件最大支持2G，CAD文件上传后自动生成矢量预览图，无需安装专业软件即可查看。上传后档案自动进入待审核队列，不可直接归档。

3.2 档案审核流程

监理账号登录后，左侧菜单点击「待我审核」，可查看所有待审核档案的基础信息、在线预览内容，审核通过点击「确认归档」，档案自动进入档案库；不符合要求点击「驳回」，填写驳回原因后，对应施工员会收到站内信提醒，修改后可重新提交审核。

3.3 档案检索导出

有查询权限的账号可通过顶部搜索框，按档案名称、标段、上传时间、施工单位、报验时间等多维度组合检索，支持批量导出档案元数据为Excel表格，也可批量勾选档案下载原文件，检索10000条以内档案响应时间不超过2秒。

第四步：数据备份与问题排查

4.1 自动备份配置

新建backup.sh备份脚本，将以下内容复制保存：

```bash !/bin/bash BACKUP_DIR="/opt/archive_backup" DATE=$(date +%Y%m%d%H%M%S) mkdir -p $BACKUP_DIR 备份数据库 docker exec archive-mysql mysqldump -uroot -p123456 archive > $BACKUP_DIR/db_$DATE.sql 备份附件 tar -zcf $BACKUP_DIR/file_$DATE.tar.gz /opt/archive/file 删除30天前的备份 find $BACKUP_DIR -mtime +30 -name ".sql" -o -name ".tar.gz" | xargs rm -f echo "备份完成，文件路径：$BACKUP_DIR/db_$DATE.sql 和 $BACKUP_DIR/file_$DATE.tar.gz" ```

Linux环境添加定时任务，执行命令crontab -e，添加以下内容实现每天凌晨2点自动备份：0 2 /bin/bash /opt/archive/backup.sh

4.2 常见问题排查

无法访问页面：Linux执行命令firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload开放端口，Windows检查防火墙是否放行Docker端口
大文件上传失败：检查配置文件中MAX_UPLOAD_SIZE参数是否为2G，重启服务即可生效
忘记管理员密码：执行命令docker exec -it archive-mysql mysql -uroot -p123456 -e "use archive; update sys_user set password = 'e10adc3949ba59abbe56e057f20f883e' where username = 'admin';"即可重置密码为123456