民政部门数字档案馆系统本地部署与基础配置全实操指南

一、前置依赖准备

1. 硬件环境：任意可运行Docker的电脑（内存≥4G，磁盘≥50G），支持Windows/macOS/Ubuntu主流系统

2. 核心工具：Docker（用于容器化部署，避免环境兼容问题），执行以下命令完成安装：

``` curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun systemctl start docker && systemctl enable docker ```

3. 镜像源配置（解决镜像下载慢问题），编辑Docker daemon配置文件：

``` Linux用户执行 sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn", "https://aliyuncs.docker.com"] } EOF sudo systemctl daemon-reload && sudo systemctl restart docker ```

二、系统镜像拉取与容器启动

1. 拉取官方适配镜像

执行以下命令拉取民政部门专用数字档案馆官方镜像（v1.0.0稳定版）：

``` docker pull docker.io/civil-archives/official-system:v1.0.0 ```

2. 创建数据存储目录

建立独立目录存储档案数据、数据库、日志，避免容器删除丢失数据：

``` Linux/macOS用户执行 mkdir -p /opt/archive-data/{db,files,logs,backup} Windows用户直接创建目录：C:\archive-data\db、C:\archive-data\files、C:\archive-data\logs、C:\archive-data\backup ```

3. 启动容器

映射端口、挂载数据目录、配置环境变量，必须修改环境变量中的管理员密码（符合复杂度：含大小写+数字+特殊字符）：

``` docker run -d -p 8080:8080 -p 5432:5432 \ -v /opt/archive-data/db:/var/lib/postgresql \ -v /opt/archive-data/files:/app/storage/files \ -v /opt/archive-data/logs:/app/logs \ -v /opt/archive-data/backup:/app/backup \ --env DB_USER=archive_admin \ --env DB_PWD=Aa123_4567 \ --env ADMIN_PWD=Civil@2024 \ --name archive-system civil-archives/official-system:v1.0.0 ```

三、系统初始化配置

1. 后台登录

打开浏览器输入地址：http://localhost:8080，使用账号admin、密码为上述配置的ADMIN_PWD登录后台

2. 档案类型预设（核心必填步骤）

按民政部门档案管理规范，创建3类基础档案类型，操作步骤如下：

• 点击左侧菜单栏【档案管理】→【档案类型】，进入列表页
• 点击右上角【新增】，输入类型名称（如“婚姻登记档案”），勾选【启用】
• 点击【字段配置】，添加2个强制必填字段：
  • 字段名：存放年限，类型：数字，勾选【必填】
  • 字段名：密级，类型：下拉选项，选项设置为“公开/内部/秘密/机密”，勾选【必填】
• 点击【保存】，重复操作创建“低保救助档案”“退伍安置档案”

四、基础功能验证

1. 档案录入测试

点击【档案录入】，选择“婚姻登记档案”，依次输入：姓名、身份证号、登记日期、存放年限、密级，点击【上传附件】（支持PDF/JPG，单文件≤100MB），最后点击【提交】

验证：返回【档案列表】，查看新增档案是否显示完整，附件是否可在线预览

2. 日志排查（若操作失败）

执行命令查看容器实时日志，快速定位问题：

``` docker logs -f archive-system ```

五、日常运维必做步骤

1. 每日自动备份数据

配置定时备份任务（Linux用户），执行crontab -e，添加以下内容：

``` 0 2 docker exec archive-system pg_dump -U archive_admin -d archive_db > /opt/archive-data/backup/$(date +\%Y\%m\%d)_archive_backup.sql ```

2. 每月系统更新

拉取最新镜像后重启容器，替换镜像版本号：

``` docker pull docker.io/civil-archives/official-system:latest docker stop archive-system && docker rm archive-system 重新执行“二、3.启动容器”命令，替换镜像版本为latest ```

3. 权限检查

每月检查/opt/archive-data目录权限，确保容器用户可读可写，执行：

``` sudo chmod -R 755 /opt/archive-data sudo chown -R 999:999 /opt/archive-data Docker容器用户ID为999 ```