适合舟山中小企事业单位的本地档案管理系统搭建实操指南

一、前置准备工作

1.1 基础环境要求

部署最低配置要求：2核CPU/4G内存/500G可用硬盘，操作系统选择CentOS 7.9，需要提前开放8080端口，执行以下命令完成端口配置：

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

如果是Windows本地测试，直接安装Docker Desktop即可，直接下载地址：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe，按引导下一步安装即可。

1.2 安装Docker与Docker Compose

CentOS服务器直接复制以下命令一键安装，不需要额外操作：

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

安装完成后输入docker-compose --version，输出版本号即为安装成功。

二、项目配置与部署

2.1 创建部署配置文件

新建部署目录并进入，执行以下命令创建配置文件：

``` mkdir -p ~/zhoushan-archive && cd ~/zhoushan-archive vi docker-compose.yml ```

按i进入编辑模式，直接复制以下完整内容，粘贴后按ESC，输入:wq保存退出：

``` version: '3' services: archive-db: image: mysql:5.7 container_name: archive-mysql environment: MYSQL_ROOT_PASSWORD: zhoushan_archive_2024 MYSQL_DATABASE: archive_db volumes: - ./mysql-data:/var/lib/mysql restart: always networks: - archive-net archive-app: image: registry.cn-hangzhou.aliyuncs.com/open-arch/zhoushan-archive:v1.0.0 container_name: zhoushan-archive-app ports: - "8080:8080" environment: DB_HOST: archive-db DB_PORT: 3306 DB_NAME: archive_db DB_USER: root DB_PWD: zhoushan_archive_2024 depends_on: - archive-db restart: always networks: - archive-net networks: archive-net: driver: bridge ```

如果需要修改数据库密码，需要同步修改两处密码，保持一致即可。

2.2 一键启动服务

在当前部署目录执行以下命令启动服务：

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

执行完成后等待2-3分钟，让系统完成数据库初始化，输入docker-compose ps，两个服务状态均为Up即为启动成功。

三、系统初始化与舟山本地规范适配

3.1 首次登录修改密码

打开浏览器输入地址：http://你的服务器IP:8080，输入默认管理员账号admin，密码123456登录，登录后点击右上角头像→修改密码，设置新密码保存即可。

3.2 导入舟山标准档案分类模板

系统已经预制符合舟山《机关档案分类编号规则》的分类模板，导入步骤：

• 点击左侧菜单栏档案管理→档案分类
• 点击页面右上角导入模板按钮
• 弹出框中选择「舟山机关档案标准分类模板」，点击确定
• 等待10秒即可完成导入，不需要手动调整分类结构

3.3 配置电子档案存储

存储扫描件等电子档案，按以下步骤配置：

• 点击左侧菜单栏系统设置→存储设置
• 选择本地存储，填写存储路径/opt/archive/files
• 点击保存即可，使用云存储可直接选择对应类型填写密钥，不配置不影响基础功能使用

四、日常核心操作流程

4.1 档案入库操作

1. 点击左侧档案管理→新增档案
2. 选择已导入的舟山标准分类，系统自动带出对应编号规则
3. 填写档案基本信息，上传电子扫描件，点击保存
4. 保存后点击「提交审核」，管理员审核通过后正式入库

4.2 档案查询与借阅

• 首页检索框支持按文号、题名、年度、保管期限多维度检索，输入关键词点击搜索即可
• 需要借阅实体档案，点击档案详情页的「申请借阅」，填写借阅时间提交
• 管理员审核通过后即可取档，还书后系统自动更新档案状态

4.3 定期数据备份

为保障档案数据安全，建议每周备份一次，步骤：

• 点击左侧系统设置→数据备份
• 点击「新建备份」，系统自动打包数据库和档案文件
• 备份完成后点击下载，将备份包保存到异地存储即可

五、常见问题排查

问题1：启动后无法访问系统

解决：首先检查服务器安全组是否开放8080端口，再执行docker-compose ps查看服务状态，如果服务是Exit状态，执行docker-compose logs archive-app查看日志，多数为密码不匹配，修改配置后重启即可。

问题2：导入分类模板后不显示

解决：按F5刷新页面，清除浏览器缓存后重新进入即可正常显示。

问题3：磁盘空间不足

解决：进入存储设置修改存储路径到新挂载的大硬盘，将原有文件迁移到新路径后重启服务即可，不需要修改数据库配置。