唐山企事业单位档案数字化：本地部署档案管理软件实操全指南

本文针对唐山本地需要合规留存档案的企事业单位，提供可离线部署、符合本地归档要求的档案管理软件搭建全流程，所有步骤可直接复制操作，不需要专业开发基础，零门槛就能落地。

前期准备工作

服务器环境要求

• CPU：2核及以上
• 内存：4G及以上
• 存储：1万份纸质扫描档案约占用50G空间，根据自身档案量预留空间即可
• 系统：本文全程基于Ubuntu 22.04 LTS编写，所有命令可直接复制执行

依赖工具安装

我们使用Docker一键部署，彻底避免环境依赖冲突，直接复制以下命令依次在服务器终端执行即可：

``` 更新系统软件包 sudo apt update && sudo apt upgrade -y 一键安装Docker curl -fsSL https://get.docker.com | bash 安装Docker Compose编排工具 sudo apt install docker-compose-plugin -y ```

执行完成后输入docker --version，如果输出版本号，说明依赖安装成功。

档案管理软件部署步骤

1. 创建部署目录与配置文件

先执行以下命令创建部署目录并进入：

``` mkdir -p ~/tangshan-archive && cd ~/tangshan-archive ```

然后执行以下命令创建配置文件：

``` nano docker-compose.yml ```

将以下完整配置复制进去，注意需要将两处your_db_password_123修改为你自定义的数据库密码，其他配置无需调整：

``` version: '3.8' services: archive-db: image: mysql:8.0 container_name: archive-mysql environment: MYSQL_ROOT_PASSWORD: your_db_password_123 MYSQL_DATABASE: archive_db volumes: - ./mysql-data:/var/lib/mysql restart: always networks: - archive-net archive-app: image: zhangweijiezh/jspm-archive:latest container_name: archive-manager ports: - "8080:8080" environment: DB_HOST: archive-db DB_USER: root DB_PASSWORD: your_db_password_123 DB_NAME: archive_db volumes: - ./archive-files:/opt/upload depends_on: - archive-db restart: always networks: - archive-net networks: archive-net: ```

修改完成后，按Ctrl+O回车保存，再按Ctrl+X退出编辑器。

2. 启动服务

在当前部署目录执行以下命令，一键拉取镜像并启动服务：

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

等待3-5分钟完成启动，执行以下命令查看服务状态：

``` sudo docker compose ps ```

如果两个服务的STATUS列显示为Up，说明服务启动成功。

3. 开放访问端口

Ubuntu默认自带ufw防火墙，执行以下命令开放8080访问端口：

``` sudo ufw allow 8080/tcp sudo ufw reload ```

注意：如果你使用阿里云、腾讯云等云服务器，还需要在云服务商控制台的安全组规则中，添加入站规则开放8080端口，这一步极易遗漏，会导致无法访问。

系统初始化配置

服务启动完成后，在浏览器输入http://你的服务器IP地址:8080即可进入登录页面，默认管理员账号信息如下：

• 账号：admin
• 密码：123456

1. 修改默认管理员密码

登录后第一步必须修改默认密码，操作路径：点击右上角头像 → 修改密码，输入原密码后设置新的强密码保存即可，避免非法访问。

2. 配置档案分类

按照唐山本地企事业单位通用档案分类标准（文书档案、科技档案、会计档案、人事档案、项目档案等），操作路径：左侧菜单栏 → 档案管理 → 档案分类 → 新增分类，可根据自身需求添加无限层级的子分类。

3. 归档档案数据

支持两种归档方式，适配不同场景：

• 单份新增归档：点击左侧菜单栏「档案著录」，填写档案名称、编号、责任人、归档日期等必填信息，上传电子扫描件或原件，点击保存即可完成归档
• 批量导入归档：适合存量档案数字化后批量导入，先下载系统提供的标准Excel模板，按照模板格式填写所有档案信息，再上传填好的Excel和打包好的电子文件压缩包，即可一键完成批量归档

日常运维常用操作

1. 无法访问问题排查

• 检查服务器防火墙和云安全组是否开放8080端口
• 执行sudo docker compose ps查看服务状态，若服务异常，执行sudo docker compose logs查看错误日志定位问题

2. 数据备份操作

所有档案数据和配置信息都存储在部署目录的mysql-data（数据库信息）和archive-files（档案原件）两个文件夹中，执行以下命令即可一键打包备份：

``` cd ~/tangshan-archive tar -zcvf archive-backup-$(date +%Y%m%d).tar.gz mysql-data archive-files ```

备份完成后将生成的压缩包下载到本地或异地存储即可，恢复时直接解压到部署目录重新启动服务即可。

3. 合规适配说明

本部署方案所有数据都存储在本地自有服务器中，系统自动留存所有档案的操作修改日志，满足唐山本地档案验收对档案不可篡改、可溯源的要求，无需额外二次开发。