水利工程移民档案管理软件 实操部署与运维全流程指南

一、环境准备与软件部署

1. 服务器基础要求

部署服务器需满足：CentOS7.9及以上64位系统，内存≥4G，CPU≥2核，硬盘≥100G；需提前安装Docker20.10+、Docker-Compose1.29+，执行以下命令完成安装：

``` 安装Docker依赖并启动服务 yum install -y yum-utils device-mapper-persistent-data lvm2 yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io systemctl start docker && systemctl enable docker 安装Docker-Compose curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ```

2. 软件包部署

从水利部官方技术支撑平台下载部署包：http://www.mwr.gov.cn/zt/gcym/archives/software/v2.1.tar.gz，上传至服务器/opt目录后执行以下命令：

``` cd /opt && tar -zxvf v2.1.tar.gz && cd cy-archives-v2.1 启动所有服务，等待约2分钟完成初始化 docker-compose up -d ```

启动后执行docker ps，需显示3个运行中容器：mysql-db、nginx、cy-archives-app。

二、系统初始配置与核心功能启用

1. 首次登录与密码修改

浏览器访问服务器公网IP:8080，默认账号：admin，默认密码：Admin@2024；首次登录需强制修改密码：点击右上角【个人中心】-【修改密码】，新密码需满足8-16位，包含大小写字母、数字、特殊字符，点击确认后生效。

2. 基础参数配置

进入【系统设置】-【基础配置】，填写以下必填项：项目名称（如：XX水库移民安置项目）、库区范围（经纬度范围）、移民总户数、移民总人数，点击保存配置，等待系统同步参数。

3. 档案分类模板生成

进入【档案管理】-【分类设置】，点击新增分类，设置一级分类为：移民安置协议、搬迁补偿凭证、户籍证明、其他材料；二级分类按实际村镇划分（如：XX镇XX村）；点击【导入模板下载】，获取标准Excel模板，模板中必填字段：档案编号（格式：YM-YYYYMMDD-001，例：YM-20240520-001）、关联移民ID（需与库区移民台账的唯一ID对应）、档案类型、存放路径。

三、日常操作与数据维护

1. 档案批量导入

进入【档案管理】-【批量导入】，选择填写完成的.xlsx模板，点击导入验证，系统自动校验数据格式；验证通过后点击确认导入，导入成功后可在【档案列表】查看所有数据；若导入失败，点击【查看错误日志】，修正模板中缺失或错误的数据后重新导入。

2. 数据备份与恢复

系统默认每日凌晨2点自动备份数据库，备份文件存于/opt/cy-archives-v2.1/backup目录；手动备份执行以下命令：

``` docker exec -it mysql-db mysqldump -uroot -p123456 cy_archives > /opt/backup/manual_backup_$(date +%Y%m%d).sql ```

数据恢复步骤：停止服务→替换备份文件→重启服务，执行命令：

``` docker-compose down 替换/opt/cy-archives-v2.1/backup/下的备份文件 docker-compose up -d ```

四、常见问题快速排查

1. 访问服务器IP:8080失败：检查服务器防火墙8080端口是否开放，执行命令：firewall-cmd --zone=public --add-port=8080/tcp --permanent && firewall-cmd --reload；

2. 档案导入失败：确认模板格式为.xlsx，无合并单元格，关联移民ID与台账一致；

3. 登录提示账号锁定：等待30分钟自动解锁，或联系管理员执行docker exec -it mysql-db mysql -uroot -p123456 -e "UPDATE cy_archives.user SET is_locked=0 WHERE username='admin';"重置锁定状态；

4. 服务启动失败：执行docker logs cy-archives-app查看日志，修正配置错误后重新启动。