芜湖本地化档案管理系统部署配置与日常运维全流程实操指南

一、前置准备

1. 硬件&环境要求

• 服务器：2核4G配置，CentOS7.9及以上操作系统，500G以上独立数据盘（存储电子档案附件），芜湖本地单位优先接入政务内网，无需公网带宽
• 软件依赖：docker 20.10+、docker-compose 2.15+

2. 依赖安装命令

直接复制以下命令在服务器终端运行，全程无需手动干预：

``` 安装docker curl -fsSL https://get.docker.com | bash systemctl start docker systemctl enable docker 安装docker-compose curl -L "https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose 验证安装，输出版本号即为成功 docker -v docker-compose -v ```

二、系统部署步骤

1. 数据盘挂载

必须将档案数据存储在独立数据盘，避免系统盘故障导致档案丢失，复制以下命令执行：

``` 初始化数据盘（默认数据盘盘符为/dev/vdb，可通过fdisk -l确认） fdisk /dev/vdb 依次输入n、p、三次回车、w完成分区 mkfs.ext4 /dev/vdb1 创建存储目录并挂载 mkdir -p /data/archives echo '/dev/vdb1 /data/archives ext4 defaults 0 0' >> /etc/fstab mount -a 验证挂载，输出/dev/vdb1挂载信息即为成功 df -h | grep archives ```

2. 安装包下载&配置

• 下载适配芜湖规范的安装包：wget https://github.com/OpenArchivesTeam/wuhu-archives/releases/download/v1.2.0/wuhu-archives-package.tar.gz
• 解压安装包：tar zxvf wuhu-archives-package.tar.gz && cd wuhu-archives-package
• 编辑配置文件，以下是完整可直接复制的docker-compose.yml内容，无需修改即可使用：

``` version: '3' services: mysql: image: mysql:8.0 container_name: archives-mysql restart: always environment: MYSQL_ROOT_PASSWORD: Wuhu_Archives@2024 MYSQL_DATABASE: archives volumes: - /data/archives/mysql:/var/lib/mysql command: --default-authentication-plugin=mysql_native_password app: image: registry.cn-hangzhou.aliyuncs.com/open-archives/wuhu-system:v1.2.0 container_name: archives-app restart: always ports: - "8080:80" volumes: - /data/archives/upload:/var/www/html/public/upload depends_on: - mysql ```

3. 启动&验证

• 启动服务：docker-compose up -d
• 运行docker ps，看到archives-mysql、archives-app两个容器状态为Up即为启动成功
• 访问http://服务器IP:8080，默认管理员账号：admin，默认密码：Wuhu@2024，登录成功即部署完成

三、芜湖本地化规范适配

必须完成以下配置，才能符合芜湖市档案馆2023版《电子档案归档与移交规范》要求：

1. 分类规则配置

• 登录后台，进入【系统设置-档案分类】，点击导入模板，模板下载地址：https://wuhu-da.gov.cn/upload/2023/12/wuhu-archives-category-template.xlsx
• 导入完成后必须勾选「适配芜湖档案移交校验规则」选项，保存后生效

2. 上传规则配置

• 进入【系统设置-上传配置】，设置允许上传格式为pdf、ofd、jpg、tiff，单文件上限设为1G
• 开启「OFD自动转换」功能，所有上传的非OFD格式文档会自动转换为符合档案馆要求的OFD格式

3. 移交通道配置

• 进入【系统设置-政务对接】，填入芜湖政务内网档案移交接口地址：http://10.23.1.12/api/transfer
• 联系芜湖市档案馆申领单位专属移交密钥，填入后点击「测试连通性」，提示成功即可

四、日常核心操作流程

1. 档案归档操作

• 登录账号，点击【新建档案】，选择对应分类（导入的芜湖标准分类）
• 必须填写全宗号、年度、保管期限三个必填项：全宗号为单位4位数字编码，保管期限只能选永久/30年/10年
• 上传档案附件，系统自动完成OFD转换、元数据校验，提交后经管理员审核通过即完成归档

2. 档案查询调阅

• 普通用户仅可查询权限范围内的非涉密档案，调阅涉密档案需提交调阅申请，管理员审批通过后可查看
• 所有查询、调阅、下载操作自动留痕，日志不可删除，符合《档案法》溯源要求

3. 档案移交至档案馆

• 每年12月整理当年需移交的档案，点击【批量移交】，系统自动按照芜湖档案馆规则校验所有档案的元数据、格式
• 校验不通过的项会明确标注错误原因，修改后重新校验，全部通过后点击提交，数据直接推送至芜湖档案馆系统，可实时查看移交状态

五、常见问题排查

• 部署后无法访问：首先运行firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload开放服务器端口，云服务器需同步在安全组开放8080端口
• 附件上传失败：运行chown -R 1001:1001 /data/archives修改存储目录权限，之后运行docker-compose restart重启服务即可
• 移交档案馆失败：先运行ping 10.23.1.12验证政务内网连通性，再检查移交密钥是否填写正确，以及未通过校验的档案项是否全部修改
• 忘记管理员密码：运行docker exec -it archives-app bash进入容器，再运行php artisan reset:password按照提示设置新密码即可