从零开始部署实施开源档案管理系统 全步骤零门槛可直接落地

一、前期环境准备

1.1 基础配置要求

部署最低要求：CPU 2核、内存4G、剩余硬盘空间50G，操作系统选择CentOS 7.x/8.x，云服务器或本地服务器均可。

1.2 安装Docker与Docker-Compose

直接复制以下命令依次执行，完成基础依赖安装，不需要手动配置环境：

``` 安装Docker yum update -y yum install -y yum-utils device-mapper-persistent-data lvm2 yum-config-manager --add-repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io systemctl start docker systemctl enable docker 安装Docker-Compose curl -L "https://github.com/docker/compose/releases/download/v2.18.1/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.1 创建本地存储目录

依次执行以下命令创建工作目录并进入：

``` mkdir -p /opt/archive-system/{db,data} cd /opt/archive-system ```

2.2 编写服务配置文件

执行vi docker-compose.yml，创建配置文件，粘贴以下完整内容，不需要修改任何参数可直接使用：

``` version: '3' services: mysql: image: mysql:5.7 container_name: archive-mysql environment: MYSQL_ROOT_PASSWORD: archive_2024@root MYSQL_DATABASE: archive_db MYSQL_USER: archive_user MYSQL_PASSWORD: archive_2024@user volumes: - ./db:/var/lib/mysql restart: always networks: - archive-net archive-system: image: registry.cn-hangzhou.aliyuncs.com/opensource-me/archive-manager:latest container_name: archive-system ports: - "8080:8080" environment: DB_HOST: mysql DB_PORT: 3306 DB_NAME: archive_db DB_USER: archive_user DB_PASS: archive_2024@user volumes: - ./data:/upload depends_on: - mysql restart: always networks: - archive-net networks: archive-net: ```

保存退出后，执行启动命令：docker-compose up -d。等待2-3分钟后执行docker-compose ps，两个服务状态均为Up即为启动成功。

三、初始化系统配置

3.1 配置网络访问权限

首先在服务器防火墙开放8080端口，执行以下命令：

``` firewall-cmd --add-port=8080/tcp --permanent firewall-cmd --reload ```

如果使用云服务器，必须额外到厂商控制台的安全组规则中，开放8080端口，否则无法访问。

3.2 首次登录与密码修改

在浏览器输入地址：http://你的服务器IP:8080，使用默认管理员账号登录：

• 账号：admin
• 密码：123456

登录后第一时间进入【个人中心】修改默认密码，避免非法入侵。

3.3 基础信息配置

按顺序完成以下基础配置，即可投入使用：

• 进入【系统设置】-【机构管理】，添加本单位的多级部门架构
• 进入【用户管理】，创建所有使用人员账号，分配对应角色：超级管理员/档案管理员/普通用户
• 进入【档案分类设置】，按照单位实际分类规则（如文书档案、项目档案、人事档案）创建多级分类目录
• 进入【存储设置】，确认存储路径已绑定本地目录，不需要额外修改

四、上线前准备与测试

4.1 存量档案批量导入

如果有存量电子档案需要迁移，按以下步骤操作：

• 将存量档案按分类整理，文件名统一为档号-档案名称.后缀，打包为ZIP压缩包
• 进入系统【档案管理】-【批量导入】，上传压缩包，系统会自动分类并创建全文检索索引

4.2 核心功能验证

上线前必须完成以下三项测试，确保功能正常：

• 普通用户能否正常检索、下载对应权限的档案
• 档案管理员能否正常完成档案上架、借阅审批、销毁流程
• 系统能否正常预览PDF、Word、Excel、图片等常用格式文件

五、日常维护要点

• 自动数据备份：

  添加定时任务每天自动备份数据库，执行crontab -e添加以下规则，每天凌晨2点自动备份到指定目录： 0 2 /usr/bin/docker exec archive-mysql mysqldump -uroot -p'archive_2024@root' archive_db > /opt/backup/archive-$(date +\%Y\%m\%d).sql，存储目录每周打包备份到外接存储即可。

• 版本升级：

  需要升级系统时，进入/opt/archive-system目录，执行docker-compose pull && docker-compose up -d即可完成升级，不会丢失原有数据。

• 端口修改：

  如果需要修改访问端口，打开docker-compose.yml，把"8080:8080"改为"自定义端口:8080"，保存后执行docker-compose up -d重启，同时更新防火墙端口规则即可。