企业本地部署数字档案馆系统企业版从零开始实操落地指南

一、前置环境准备

本文基于开源可商用的数字档案馆系统企业版制作，所有命令可直接复制执行，零门槛部署。

1.1 基础环境要求

• 硬件：企业服务器最低配置为2核4G，500G以上可用存储空间，档案量10万份以上建议升级为4核8G
• 系统：选用稳定版Ubuntu 22.04 LTS，兼容性最好

1.2 安装依赖工具

直接执行以下命令一键安装Docker和Docker Compose，无需手动编译：

``` sudo apt update && sudo apt install -y docker.io docker-compose-plugin sudo systemctl enable --now docker ```

1.3 下载部署包

直接执行以下命令下载官方稳定版企业部署包，解压后进入工作目录：

``` wget https://github.com/obstudio/digital-archive-enterprise/releases/download/v1.2.0/da-enterprise-deploy.zip unzip da-enterprise-deploy.zip && cd da-enterprise-deploy ```

二、核心配置修改

本次部署仅需要修改3个参数，无需改动其他内容，打开目录下的docker-compose.yml文件，直接替换为以下完整内容，修改标注的参数即可：

``` version: '3.8' services: db: image: mysql:8.0 container_name: da-archive-db environment: MYSQL_ROOT_PASSWORD: 自定义数据库密码 MYSQL_DATABASE: da_archive MYSQL_USER: da_user MYSQL_PASSWORD: 自定义数据库密码(和上面保持一致) volumes: - ./data/db:/var/lib/mysql restart: always networks: - da-network app: image: digitalarchive/enterprise:v1.2.0 container_name: da-archive-app ports: - "自定义宿主机端口:8080" 例如 "8080:8080" environment: DB_HOST: db DB_NAME: da_archive DB_USER: da_user DB_PWD: 自定义数据库密码(和上面保持一致) ARCHIVE_STORAGE_PATH: /app/data/archive volumes: - ./data/archive:/app/data/archive depends_on: - db restart: always networks: - da-network networks: da-network: driver: bridge ```

2.1 预赋存储权限(避免卡壳)

直接执行以下命令给存储目录赋权，90%的部署失败都是因为跳过这一步：

``` sudo chmod -R 777 ./data/db ./data/archive ```

三、一键启动与初始化登录

执行以下命令启动服务，容器会自动拉取镜像启动，全程无需人工干预：

``` docker compose up -d ```

启动后等待1-2分钟，待系统初始化完成，打开浏览器访问地址：http://你的服务器IP:自定义端口

初始管理员账号信息：
账号：admin
密码：admin123456
第一次登录必须强制修改密码，修改后即可进入后台

四、企业版核心功能配置实操

4.1 配置企业档案分类体系

1. 登录后台后，点击左侧菜单栏「档案管理」→「分类设置」
2. 点击「新增一级分类」，按照企业实际需求添加分类，常用分类为：文书档案、合同档案、项目档案、人事档案、财务档案
3. 每添加一个分类填写唯一分类编码，添加完成后点击「保存排序」即可，分类编码必须唯一，重复会无法保存

4.2 配置部门与人员权限

企业版内置三种预设角色，无需自定义即可直接使用：超级管理员(全权限)、档案管理员(仅档案管理权限)、普通查询用户(仅查询授权档案)

1. 点击左侧「系统设置」→「组织管理」，点击「新增部门」，输入企业部门名称保存
2. 进入「用户管理」，点击「新增用户」，输入用户名、手机号，分配对应部门和角色
3. 如果需要限制单个用户的可见档案范围，在用户编辑页勾选允许查看的分类即可保存生效

4.3 档案入库实操

支持单份上传和批量导入两种模式：

• 单份上传：点击「档案管理」→「档案入库」，选择对应分类，填写档案名称、编号、成文日期等元数据，上传档案附件，点击保存即可完成入库
• 批量导入：点击「档案入库」页下方「下载导入模板」，按照模板要求填写所有档案的元数据，将所有档案文件和填好的模板打包为zip压缩包，点击「上传批量包」，系统会自动完成入库，单次批量导入最多支持500份，超过请分批次上传，避免超时

五、常见问题排查

• 无法访问后台：检查服务器防火墙是否开放自定义端口，Ubuntu开放端口命令：sudo ufw allow 你的端口号/tcp
• 启动后提示数据库连接失败：检查docker-compose.yml中所有位置的数据库密码是否一致，不一致会导致连接失败
• 上传文件提示权限不足：重新执行赋权命令后重启服务即可：

  
  sudo chmod -R 777 ./data/db ./data/archive
  docker compose restart
  
  

如果需要绑定域名开启HTTPS，可添加Nginx反向代理配置，示例配置如下，之后使用certbot一键申请免费SSL证书即可：

``` server { listen 80; server_name 你的企业域名; location / { proxy_pass http://127.0.0.1:你的端口; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } ``` ``` sudo certbot --nginx -d 你的企业域名 ```