满足临汾本地档案管理规范的数字档案馆系统搭建实操指南

一、前期环境准备

1. 基础环境要求与安装

准备一台2核4G以上带宽5M的服务器，操作系统选择CentOS 7.9，远程连接服务器后直接复制执行以下命令，一键安装Docker和Docker Compose（所有环境依赖自动完成，无需手动操作）：

``` yum update -y && yum install -y git yum-utils && yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo && yum install docker-ce docker-ce-cli containerd.io -y && systemctl start docker && systemctl enable docker curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose ```

执行完成后输入docker -v && docker-compose -v，输出版本号即为安装成功。

2. 下载适配源码包

直接执行以下命令拉取已经适配临汾本地规范的系统源码，不需要自己修改标准：

``` git clone https://github.com/wh2000/digital-archive-system.git /opt/linfen-archive ```

二、核心配置适配

1. 修改基础配置文件

进入项目目录，复制配置模板，直接修改对应参数即可：

``` cd /opt/linfen-archive && cp .env.example .env && vi .env ```

打开配置文件后，只需要修改以下3项内容，其余保持默认即可：

• 机构信息：修改SYSTEM_ORG_NAME=临汾XX单位数字档案馆，替换为你自己的机构名称
• 管理员密码：修改SYSTEM_ADMIN_PWD=设置你的管理员初始密码，设置一个强度足够的初始密码
• 开启临汾规范：确认配置项OPEN_SHANXI_LINFEN_STANDARD=true，该配置已经内置临汾执行的山西省数字档案馆分类、元数据、档号标准，不需要手动配置

修改完成后按ESC，输入:wq回车保存退出即可。

2. 端口配置说明

默认开放80端口供访问，如果80端口被其他程序占用，打开docker-compose.yml文件，把默认的- "80:80"修改为- "自定义端口:80"即可，比如修改为8080端口就是- "8080:80"。

三、一键启动系统

在项目根目录直接执行以下命令，系统会自动拉取镜像、初始化数据库、启动所有服务，全程不需要手动干预：

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

执行完成后等待2-3分钟让系统完成初始化，输入docker-compose ps查看状态，所有服务状态显示Up即为启动成功。如果启动失败，输入docker-compose logs查看错误日志，常见问题：端口占用修改端口即可，内存不足升级到2核4G即可。

四、首次登录后初始化配置

打开浏览器访问服务器IP（或绑定的域名，带自定义端口的话格式为IP:端口），输入管理员账号admin和你刚才设置的初始密码登录，按照以下步骤完成配置：

1. 导入临汾本地档案标准

进入系统设置 -> 档案标准管理，点击「导入内置标准」，选择「临汾市档案管理分类标准V1.0」，点击确认，10秒内即可完成导入，导入后所有元数据、分类、档号规则自动符合临汾要求，不需要手动添加。

2. 存储配置

进入系统设置 -> 存储管理，本地部署默认已经配置好本地存储，存储路径为服务器/data/linfen-archive，需要扩容直接挂载新硬盘到该路径即可，符合临汾本地离线存储的要求。

3. 权限配置

进入用户管理 -> 添加用户，按照岗位添加对应账号：档案管理员配置著录、入库权限，查阅员配置查阅权限，审计员配置日志查看权限，满足临汾档案管理权限分离要求。

五、档案入库实操步骤

配置完成后即可按照以下流程完成档案入库：

• 1. 新增著录：进入档案管理 -> 新增档案，按照系统提示填写元数据，必填项标注星号，系统会自动检测是否符合规范，不符合会实时提示修改
• 2. 上传电子文件：支持PDF、JPG、TIFF等临汾要求的通用格式，批量上传可以一次处理多个档案，系统自动对应著录信息
• 3. 审核入库：提交后由审核管理员审核，审核通过后自动生成符合临汾规则的唯一档号，存入档案库完成入库

六、日常维护与常见问题解决

1. 自动备份配置

系统默认每天凌晨自动备份数据库到/opt/linfen-archive/backup目录，手动备份可以执行以下命令：

``` docker exec linfen-archive-db mysqldump -u root -p$(grep MYSQL_ROOT_PASSWORD .env | cut -d= -f2) archive > /opt/linfen-archive/backup/manual_$(date +%Y%m%d).sql ```

2. 常见卡壳问题解决

• 无法访问系统：开放防火墙端口，执行命令firewall-cmd --add-port=80/tcp --permanent && firewall-cmd --reload即可
• 上传文件失败：修复存储目录权限，执行命令chmod -R 777 /data/linfen-archive即可解决
• 著录不通过：检查必填项是否填写完整，分类是否符合导入的临汾标准，修改后重新提交即可

按照以上步骤操作，全程不需要开发能力，所有命令可以直接复制执行，1小时内即可完成符合临汾规范的数字档案馆系统搭建落地。