网站首页/ 信息中心/ 档案百科/

民国档案数字化管理：开源工具搭建与实操指南

发布时间：2026年09月16日 09:35:30 浏览量：0

一、系统环境与核心组件准备

本方案基于开源技术栈，确保零成本部署。系统由数据存储、业务处理、前端展示三层构成。

1.1 基础运行环境部署

使用Docker容器化部署，确保环境一致性。首先安装Docker引擎：

 Ubuntu/Debian系统
sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker
创建项目目录结构
mkdir -p ~/archive_management/{data,config,backup}
cd ~/archive_management

1.2 核心服务配置文件

创建docker-compose.yml文件，定义所有服务：

version: '3.8'
services:
postgres:
image: postgres:15-alpine
environment:
POSTGRES_DB: archive_db
POSTGRES_USER: archive_admin
POSTGRES_PASSWORD: YourSecurePassword123!
volumes:
- ./data/postgres:/var/lib/postgresql/data
- ./config/init.sql:/docker-entrypoint-initdb.d/init.sql
ports:
- "5432:5432"
minio:
image: minio/minio:latest
command: server /data --console-address ":9001"
environment:
MINIO_ROOT_USER: minioadmin
MINIO_ROOT_PASSWORD: minioadmin123
volumes:
- ./data/minio:/data
ports:
- "9000:9000"
- "9001:9001"
backend:
build: ./backend
depends_on:
- postgres
- minio
environment:
DATABASE_URL: postgresql://archive_admin:YourSecurePassword123!@postgres:5432/archive_db
MINIO_ENDPOINT: minio:9000
ports:
- "8080:8080"
frontend:
build: ./frontend
depends_on:
- backend
ports:
- "3000:3000"

二、数据库设计与初始化

2.1 档案数据表结构设计

创建config/init.sql文件，定义核心数据表：

-- 档案分类表
CREATE TABLE archive_categories (
id SERIAL PRIMARY KEY,
category_code VARCHAR(20) UNIQUE NOT NULL,
category_name VARCHAR(100) NOT NULL,
parent_id INTEGER REFERENCES archive_categories(id),
description TEXT,
sort_order INTEGER DEFAULT 0,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
-- 档案主表
CREATE TABLE archives (
id SERIAL PRIMARY KEY,
archive_number VARCHAR(50) UNIQUE NOT NULL,
title VARCHAR(500) NOT NULL,
category_id INTEGER REFERENCES archive_categories(id),
year INTEGER NOT NULL CHECK (year BETWEEN 1912 AND 1949),
storage_location VARCHAR(200),
confidentiality_level VARCHAR(20) CHECK (confidentiality_level IN ('公开', '内部', '秘密', '机密')),
physical_status VARCHAR(20) CHECK (physical_status IN ('完好', '破损', '严重破损', '待修复')),
digitization_status BOOLEAN DEFAULT FALSE,
digitization_date DATE,
remarks TEXT,
created_by VARCHAR(50),
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
-- 档案文件关联表
CREATE TABLE archive_files (
id SERIAL PRIMARY KEY,
archive_id INTEGER REFERENCES archives(id) ON DELETE CASCADE,
file_name VARCHAR(255) NOT NULL,
file_path VARCHAR(500) NOT NULL,
file_size BIGINT,
mime_type VARCHAR(100),
page_count INTEGER,
upload_time TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
uploader VARCHAR(50)
);
-- 创建索引优化查询性能
CREATE INDEX idx_archives_number ON archives(archive_number);
CREATE INDEX idx_archives_category ON archives(category_id);
CREATE INDEX idx_archives_year ON archives(year);
CREATE INDEX idx_files_archive ON archive_files(archive_id);

2.2 初始化基础数据

在init.sql文件末尾添加初始化数据：

-- 插入民国档案标准分类
INSERT INTO archive_categories (category_code, category_name, sort_order) VALUES
('ZG', '政治', 1),
('JJ', '经济', 2),
('WS', '外交', 3),
('JY', '教育', 4),
('WH', '文化', 5),
('JS', '军事', 6);
-- 插入示例档案记录
INSERT INTO archives (archive_number, title, category_id, year, confidentiality_level, physical_status) VALUES
('MG-1912-001', '中华民国临时约法', 1, 1912, '公开', '完好'),
('MG-1927-045', '国民政府财政报告', 2, 1927, '内部', '完好'),
('MG-1937-128', '抗日战争军事部署图', 6, 1937, '机密', '破损');

三、后端服务开发与配置

3.1 创建后端项目结构

在backend目录下创建项目：

民国档案数字化管理：开源工具搭建与实操指南

mkdir -p backend/{src,config,routes,models}
cd backend
npm init -y
npm install express pg multer minio cors dotenv

3.2 核心配置文件

创建backend/config/database.js：

const { Pool } = require('pg');
require('dotenv').config();
const pool = new Pool({
host: process.env.DB_HOST || 'localhost',
port: process.env.DB_PORT || 5432,
database: process.env.DB_NAME || 'archive_db',
user: process.env.DB_USER || 'archive_admin',
password: process.env.DB_PASSWORD || 'YourSecurePassword123!',
max: 20,
idleTimeoutMillis: 30000,
connectionTimeoutMillis: 2000,
});
module.exports = pool;

3.3 档案上传接口实现

创建backend/routes/upload.js：

const express = require('express');
const multer = require('multer');
const Minio = require('minio');
const pool = require('../config/database');
const router = express.Router();
// MinIO客户端配置
const minioClient = new Minio.Client({
endPoint: process.env.MINIO_ENDPOINT || 'localhost',
port: parseInt(process.env.MINIO_PORT) || 9000,
useSSL: false,
accessKey: process.env.MINIO_ACCESS_KEY || 'minioadmin',
secretKey: process.env.MINIO_SECRET_KEY || 'minioadmin123'
});
// 创建存储桶（如果不存在）
const bucketName = 'archives';
minioClient.bucketExists(bucketName, (err, exists) => {
if (!exists) {
minioClient.makeBucket(bucketName, 'us-east-1', (err) => {
if (err) console.error('创建存储桶失败:', err);
});
}
});
// 配置Multer处理文件上传
const storage = multer.memoryStorage();
const upload = multer({
storage: storage,
limits: { fileSize: 100  1024  1024 }, // 限制100MB
fileFilter: (req, file, cb) => {
const allowedTypes = ['image/jpeg', 'image/png', 'image/tiff', 'application/pdf'];
if (allowedTypes.includes(file.mimetype)) {
cb(null, true);
} else {
cb(new Error('不支持的文件类型，仅支持JPEG、PNG、TIFF、PDF格式'));
}
}
});
// 档案文件上传接口
router.post('/archive/:id/upload', upload.array('files', 10), async (req, res) => {
try {
const archiveId = req.params.id;
const files = req.files;
// 验证档案是否存在
const archiveResult = await pool.query(
'SELECT id FROM archives WHERE id = $1',
[archiveId]
);
if (archiveResult.rows.length === 0) {
return res.status(404).json({ error: '档案不存在' });
}
const uploadedFiles = [];
// 逐个上传文件到MinIO
for (const file of files) {
const fileName = `${Date.now()}_${file.originalname}`;
const filePath = `${archiveId}/${fileName}`;
await minioClient.putObject(
bucketName,
filePath,
file.buffer,
file.size,
{ 'Content-Type': file.mimetype }
);
// 记录文件信息到数据库
const fileResult = await pool.query(
`INSERT INTO archive_files
(archive_id, file_name, file_path, file_size, mime_type)
VALUES ($1, $2, $3, $4, $5)
RETURNING id`,
[archiveId, file.originalname, filePath, file.size, file.mimetype]
);
uploadedFiles.push({
id: fileResult.rows[0].id,
name: file.originalname,
size: file.size,
type: file.mimetype
});
}
// 更新档案数字化状态
await pool.query(
'UPDATE archives SET digitization_status = true, digitization_date = CURRENT_DATE WHERE id = $1',
[archiveId]
);
res.json({
success: true,
message: `成功上传${uploadedFiles.length}个文件`,
files: uploadedFiles
});
} catch (error) {
console.error('上传失败:', error);
res.status(500).json({ error: '文件上传失败' });
}
});
module.exports = router;

四、前端界面开发

4.1 档案列表页面

创建frontend/src/ArchiveList.vue：

五、系统部署与运维

5.1 一键启动所有服务

在项目根目录执行：

 构建并启动所有容器
docker-compose up -d --build
查看服务状态
docker-compose ps
查看服务日志
docker-compose logs -f backend

5.2 数据备份脚本

创建backup/backup.sh自动化备份脚本：

!/bin/bash
BACKUP_DIR="/home/archive_management/backup"
DATE=$(date +%Y%m%d_%H%M%S)
备份数据库
docker-compose exec postgres pg_dump -U archive_admin archive_db > \
$BACKUP_DIR/db_backup_$DATE.sql
备份MinIO数据
docker-compose exec minio mc mirror /data $BACKUP_DIR/minio_backup_$DATE/
压缩备份文件
cd $BACKUP_DIR
tar -czf archive_backup_$DATE.tar.gz db_backup_$DATE.sql minio_backup_$DATE/
清理临时文件
rm -rf db_backup_$DATE.sql minio_backup_$DATE
保留最近30天的备份
find $BACKUP_DIR -name "archive_backup_.tar.gz" -mtime +30 -delete
echo "备份完成: $BACKUP_DIR/archive_backup_$DATE.tar.gz"

设置定时备份（每天凌晨2点执行）：

 编辑crontab
crontab -e
添加以下行
0 2    /home/archive_management/backup/backup.sh >> /var/log/archive_backup.log 2>&1

5.3 系统监控配置

创建监控脚本monitor.sh：

!/bin/bash
检查服务状态
SERVICES=("postgres" "minio" "backend" "frontend")
for service in "${SERVICES[@]}"; do
if docker-compose ps | grep -q "$service.Up"; then
echo "$service: 运行正常"
else
echo "$service: 服务异常"
自动重启异常服务
docker-compose restart $service
fi
done
检查磁盘空间
DISK_USAGE=$(df -h /home | awk 'NR==2 {print $5}' | sed 's/%//')
if [ $DISK_USAGE -gt 90 ]; then
echo "警告：磁盘使用率超过90%"
fi

六、使用流程说明

6.1 首次使用配置

修改默认密码：编辑docker-compose.yml，将POSTGRES_PASSWORD和MINIO_ROOT_PASSWORD改为强密码
访问MinIO管理界面：浏览器打开http://服务器IP:9001，使用minioadmin/minioadmin123登录
创建访问密钥：在MinIO控制台的Access Keys页面创建新的Access Key和Secret Key
更新后端配置：将新密钥更新到backend/config/database.js的MINIO配置中

6.2 档案录入操作步骤

访问系统首页http://服务器IP:3000
点击"新增档案"按钮，填写档案基本信息
- 档案编号格式：MG-年份-序号（如MG-1937-001）
- 年份必须为1912-1949之间的整数
- 密级根据档案实际保密要求选择
保存档案信息后，系统自动跳转到档案详情页

上一篇：档案制度建设公司哪家专家多？过来人给你扒一扒

下一篇：档案制度建设委员会如何助力单位档案管理体系合规化落地？

搞定档案制度建设认证从0到1不走弯路的实操避坑指南

搞定档案制度建设认证从0到1不走弯路的实操避坑指南

家人们谁懂啊，去年我刚帮公司把档案制度建设认证这个硬骨头啃下来，最开始我以为这玩意儿就是给资料堆盖个章的面子工程，真跑完全程才知道，这简直是给你家堆了好几年的“资料大别墅”办不动产证加消防验收，过了之...

2026年09月16日 09:35:30

金昌档案管理系统怎么选？本地政企实操避坑干货全指南

金昌档案管理系统怎么选？本地政企实操避坑干货全指南

宝子们我可太有发言权了！去年我们金昌本地街道办要做档案数字化升级，领导把这活甩给我的时候，我还以为就是把旧纸扫成电子版存硬盘就行，结果差点把我半条命搭进去，前前后后踩了4个大坑，换了3套工具，最后才摸...

2026年09月16日 09:35:30

档案管理系统应用专业档案培训师能力提升标准化培训

档案管理系统应用专业档案培训师能力提升标准化培训

培训核心定位与培养目标

2026年09月16日 09:35:30

中学档案管理系统：数字化校园建设的核心支撑

中学档案管理系统：数字化校园建设的核心支撑

系统架构与技术原理

2026年09月16日 09:35:30

档案服务外包工作规定专项培训的标准化实施指南

档案服务外包工作规定专项培训的标准化实施指南

档案服务外包工作规定培训的底层逻辑与政策依据

2026年09月16日 09:35:30

档案制度建设没头绪？人员保障经验分享，全是实战干货

档案制度建设没头绪？人员保障经验分享，全是实战干货

这事儿吧，说到底还是得看人

2026年09月16日 09:35:30

微信咨询

电话联系

QQ客服

微信咨询一对一服务

服务热线： 028-8744 4417

QQ客服： 2305721818