仓储企业数字档案馆系统零门槛本地部署实操全流程指南

前期环境准备

本次搭建基于开源可商用的档案管理系统，通过Docker容器化部署，全程无需手动编译，零代码基础也可完成。准备一台2核4G、100G以上硬盘的云服务器，系统选择Ubuntu 22.04，通过SSH连接服务器后执行以下命令安装依赖：

• 更新系统源：sudo apt update && sudo apt upgrade -y
• 安装Docker：curl -fsSL https://get.docker.com | bash -
• 安装Docker Compose：sudo apt install docker-compose-plugin -y

系统初始化部署

创建项目配置目录

执行以下命令一键创建所需目录，所有数据都会保存在该目录，不会丢失：

``` mkdir -p ~/digital-archive/{mysql,uploads} cd ~/digital-archive ```

编写完整配置文件

执行命令vi docker-compose.yml创建配置文件，直接复制粘贴以下完整内容，无需修改即可使用：

``` version: '3.8' services: mysql: image: mysql:8.0 container_name: archive-mysql environment: MYSQL_ROOT_PASSWORD: archive123456 MYSQL_DATABASE: warehouse_archive MYSQL_USER: archive_user MYSQL_PASSWORD: archive_pass123 volumes: - ./mysql:/var/lib/mysql restart: always networks: - archive_net archive-app: image: lnhcode/my-archive:latest container_name: archive-app ports: - "80:80" environment: DB_HOST: mysql DB_PORT: 3306 DB_DATABASE: warehouse_archive DB_USERNAME: archive_user DB_PASSWORD: archive_pass123 ADMIN_INIT_USER: admin ADMIN_INIT_PASS: admin123456 volumes: - ./uploads:/var/www/html/uploads restart: always depends_on: - mysql networks: - archive_net networks: archive_net: ```

默认管理员账号为admin，密码为admin123456，部署完成后可自行修改。

启动并验证系统

在当前目录执行启动命令：

``` docker compose up -d ```

等待2-3分钟拉取镜像并启动，执行docker compose ps查看状态，两个服务都显示UP则说明启动成功。此时在浏览器输入服务器IP，即可打开系统登录页。

适配仓储企业业务配置

配置档案分类

仓储企业档案分类有明确的业务属性，按照以下步骤配置：

1. 登录后台后，点击左侧菜单档案管理 > 档案分类
2. 点击右上角新增分类，添加以下预设一级分类，可根据自身业务调整：
   • 一级分类：仓储合同档案，编号01
   • 一级分类：出入库单据档案，编号02
   • 一级分类：客户资质档案，编号03
   • 一级分类：仓储设备档案，编号04
   • 一级分类：财务结算档案，编号05
3. 每个一级分类下可新增子分类，比如出入库单据档案下添加「入库单」「出库单」「调拨单」子分类
4. 点击保存即可完成分类配置

配置仓储专属自定义字段

仓储档案需要额外存储业务信息，通过自定义字段功能实现：

1. 点击左侧菜单系统设置 > 字段管理
2. 点击新增字段组，名称填写「仓储档案扩展字段」，绑定所有一级档案分类
3. 依次添加以下常用字段：
   • 客户编号：字段类型选「单行文本」，开启可检索
   • 仓储区位：字段类型选「下拉框」，选项填写「A区,B区,C区,D区」，设置为必填
   • 档案到期日期：字段类型选「日期」，开启可检索
   • 存放仓位：字段类型选「单行文本」
4. 点击保存完成配置，后续录入档案时即可自动带出这些字段。

权限配置与档案录入

分角色权限配置

仓储企业不同岗位只能查看对应档案，配置步骤：

1. 点击左侧菜单权限管理 > 角色管理
2. 新增角色，比如「业务专员」「档案管理员」「财务人员」
3. 给每个角色勾选可访问的档案分类，比如财务仅开放财务结算档案权限
4. 进入权限管理 > 用户管理，新增员工账号并绑定对应角色即可。

档案录入

• 单份录入：点击档案管理 > 档案录入，选择分类、填写字段、上传原文件，保存即可，支持PDF、Word、图片、压缩包等所有格式
• 批量录入：点击导入Excel，下载系统预设模板，填写档案信息后上传，附件可打包上传自动关联，适合批量录入历史档案。

日常维护操作

日常仅需两个核心维护操作，全部可一键执行：

• 手动备份数据库：执行命令docker exec archive-mysql mysqldump -uroot -parchive123456 warehouse_archive > ~/digital-archive/backup_$(date +%Y%m%d).sql，可添加到crontab实现每天自动备份
• 重启服务：进入项目目录执行docker compose restart即可

部署完成后第一时间进入系统设置 > 个人信息修改默认管理员密码，即可正式投入使用。