南充数字档案馆系统本地部署、数据导入及日常运维实操全指南

一、前置准备

1. 硬件与系统要求

最低配置：4核8G内存、500G SSD存储，操作系统优先选CentOS7.9或Ubuntu22.04，无需额外购买商用服务。

2. 安装包获取

官方稳定版安装包直接下载：http://daj.nanchong.gov.cn/soft/nds_v2.4.1.zip，该版本已适配南充市全区县档案编码规则，无需二次调整编码规则。

二、系统部署实操步骤

1. 基础环境配置

执行以下命令安装Docker及Docker-Compose环境，所有命令可直接复制运行：

CentOS系统执行：

``` 更新系统源 yum update -y 安装Docker curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun 启动Docker并设置开机自启 systemctl start docker && systemctl enable docker 安装Docker-Compose curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ```

Ubuntu系统执行：

``` 更新系统源 apt update && apt upgrade -y 安装Docker curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun 启动Docker并设置开机自启 systemctl start docker && systemctl enable docker 安装Docker-Compose curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ```

2. 系统安装与配置

依次执行以下命令完成安装：

``` 下载安装包 wget http://daj.nanchong.gov.cn/soft/nds_v2.4.1.zip 解压安装包 unzip nds_v2.4.1.zip 进入安装目录 cd nds_v2.4.1 ```

创建存储目录并授权，此步不能省略，否则会出现文件上传失败问题：

``` mkdir -p /data/nds/archive_files /data/nds/backup /data/nds/logs chmod -R 777 /data/nds/ ```

修改根目录下的.env配置文件，完整配置内容可直接复制替换：

``` 系统基础配置 SERVER_PORT=8080 DB_ROOT_PASSWORD=nds@2024_nc DB_NAME=nds_archive 南充地区行政编码，固定为511300无需修改 REGION_CODE=511300 文件存储路径，和上面创建的路径保持一致 FILE_STORAGE_PATH=/data/nds/archive_files 访问地址，本地测试填http://localhost:8080，公网部署填对应域名 DOMAIN=http://localhost:8080 ```

启动系统：

``` docker-compose up -d ```

3. 部署验证

执行命令curl http://localhost:8080/api/health，返回{"code":200,"msg":"success","data":"ok"}即为部署成功。默认管理员账号：admin，默认密码：Nc@daj2024，登录后请第一时间修改密码。

三、档案数据批量导入实操

1. 数据格式预处理

导入文件必须为UTF-8无BOM格式的CSV文件，必填字段如下，可直接复制作为表头：

``` 档案编号,全宗号,目录号,案卷号,题名,责任者,成文日期,保管期限,密级,文件路径 511300_001_001_0001,001,001,0001,南充市2023年档案工作会议纪要,南充市档案局,2023-12-01,30年,内部,/upload/2023/12/01/001.pdf ```

格式校验规则（不符合会直接导入失败）：

• 成文日期必须为YYYY-MM-DD格式
• 密级仅支持填写：公开、内部、秘密、机密、绝密
• 保管期限仅支持填写：10年、30年、永久
• 档案编号前缀必须为511300，和南充行政编码匹配

2. 导入操作步骤

1. 登录系统后台，进入【数据管理】-【批量导入】模块
2. 上传预处理完成的CSV文件，电子文件提前上传到/data/nds/archive_files/upload对应目录
3. 勾选【南充地区档案规则校验】选项，点击【预校验】，预校验无报错后点击【正式导入】
4. 导入完成后进入【档案检索】模块，搜索对应档案题名验证导入结果

四、日常运维核心操作

1. 数据自动备份配置

手动备份数据库执行命令：

``` docker exec nds_db mysqldump -u root -p'nds@2024_nc' nds_archive > /data/nds/backup/archive_$(date +%Y%m%d).sql ```

设置定时自动备份，执行crontab -e，添加以下内容，即可实现每天凌晨2点自动备份：

``` 0 2 docker exec nds_db mysqldump -u root -p'nds@2024_nc' nds_archive > /data/nds/backup/archive_$(date +\%Y\%m\%d).sql ```

电子文件备份直接打包/data/nds/archive_files目录即可。

2. 权限配置

给区县用户开通查询权限：进入【系统管理】-【用户管理】，新建用户，角色选择【普通查询员】，归属全宗对应规则：顺庆区001、高坪区002、嘉陵区003、阆中市004、南部县005、西充县006、营山县007、蓬安县008、仪陇县009。

3. 日志排查

系统运行日志存储路径为/data/nds/logs/，导入失败日志查看import_error.log，接口报错日志查看info.log，实时容器日志执行命令docker logs -f nds_web查看。

五、常见问题排查

• 问题：部署后无法访问8080端口
  解决：检查防火墙是否开放端口，CentOS执行firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --reload，Ubuntu执行ufw allow 8080/tcp
• 问题：CSV导入提示格式错误
  解决：检查CSV是否为UTF-8无BOM格式，无合并单元格，所有必填字段不为空，字段值符合格式规则
• 问题：电子文件预览失败
  解决：检查文件路径和CSV填写的路径是否一致，文件权限是否为755，执行docker exec -it nds_web systemctl start openoffice重启预览组件