南宁数字档案馆系统本地部署与基础功能配置实操指南

一、前置准备

1.1 硬件要求

最低配置满足即可运行：CPU为4核及以上，内存≥8G，可用存储≥100G（存储档案扫描件可根据需求扩容），如果是单位多用户同时使用，升级为8核16G即可。

1.2 软件环境准备

• 系统：Ubuntu 22.04 LTS，直接下载地址：https://releases.ubuntu.com/jammy/ubuntu-22.04.4-desktop-amd64.iso
• 依赖环境：Docker 24+、Docker Compose 2.20+，Ubuntu系统安装直接复制执行以下命令： ``` sudo apt update && sudo apt install docker.io docker-compose-plugin -y ```

二、一键部署实操步骤

2.1 创建项目目录

连接服务器或者打开本地终端，依次执行以下命令，创建部署目录并进入： ``` mkdir nanning-nda && cd nanning-nda ```

2.2 编写核心配置文件

在当前目录新建文件命名为docker-compose.yml，直接复制以下完整内容，无需自行修改结构，仅需根据自身需求调整对应参数： ``` version: '3.8' services: nda-mysql: image: mysql:8.0 container_name: nda-mysql environment: MYSQL_ROOT_PASSWORD: nda_2024@nn MYSQL_DATABASE: nanning_da volumes: - ./data/mysql:/var/lib/mysql restart: unless-stopped networks: - nda-net nda-web: image: ghcr.io/nanning-open/nda-web:v1.2 container_name: nda-web ports: - "8080:8080" environment: DB_HOST: nda-mysql DB_USER: root DB_PASSWORD: nda_2024@nn DB_NAME: nanning_da ENABLE_NN_GOV: "false" 需要对接南宁政务共享平台改为true NN_GOV_KEY: "" 填入政务网分配的对接密钥 NN_GOV_ORG_CODE: "" 填入政务网分配的机构编码 volumes: - ./data/files:/app/files depends_on: - nda-mysql restart: unless-stopped networks: - nda-net networks: nda-net: driver: bridge ``` 重点说明：如果需要对接南宁市级档案共享平台，必须将ENABLE_NN_GOV的值改为"true"，再填入对应分配的参数，否则对接功能无法启用。

2.3 启动并验证部署

在当前目录执行以下命令启动服务： ``` docker compose up -d ``` 启动完成后，打开浏览器访问http://你的服务器IP:8080，如果能正常打开登录页，说明部署成功。默认管理员账号：admin，默认密码：123456，第一次登录必须修改密码后才能使用。

三、基础档案入库实操

3.1 配置基础信息

1. 登录后台后，点击左侧菜单栏系统配置 → 组织架构，点击「新增」，填入本单位全称、统一社会信用代码，保存即可。
2. 点击左侧菜单栏档案配置 → 门类管理，点击「导入南宁标准模板」，系统会一键导入南宁档案局要求的文书、科技、人事、会计等标准档案门类，无需手动创建，10秒即可完成配置。

3.2 批量上传档案

1. 点击左侧菜单栏档案管理 → 批量上传，选择需要上传的档案门类。
2. 点击「下载标准著录模板」，按照模板要求填写档号、题名、责任者、日期等著录信息，保存Excel文件。
3. 将所有扫描好的档案PDF文件重命名为「档号.pdf」，确保文件名和Excel中填写的档号完全一致，不能包含空格、特殊字符。
4. 先上传填好的Excel著录模板，再批量上传所有PDF文件，点击「开始匹配」，系统会自动完成著录信息和原文的关联绑定，1000份档案10分钟内即可完成上传。

3.3 开放审核

按照南宁档案局要求，满30年的档案需要完成开放审核才能对外查询。操作步骤：点击左侧菜单栏审核管理 → 开放审核，勾选需要审核的档案，选择「开放」或「不开放」，提交即可完成审核流程。

四、对接南宁政务共享平台实操

1. 提前向南宁市档案局申请对接权限，获取分配的机构编码、对接密钥、接口地址。
2. 进入系统系统配置 → 对接配置 → 南宁政务对接，依次填入获取到的三个参数，点击「测试连接」，提示「连接成功」即为配置正确。
3. 回到档案管理页面，勾选需要上报的已开放档案，点击批量上报，系统会自动完成著录信息和原文的加密上报，上报完成后会提示成功，若失败会给出具体错误原因，按照提示修改后重新上报即可。

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

5.1 数据备份

系统默认开启每日自动备份，手动备份操作：点击系统维护 → 数据备份，点击「立即备份」即可，备份文件存储在配置的./data/backup目录，建议每周将备份文件拷贝到外接存储设备，防止数据丢失。

5.2 常见问题解决

• 无法打开登录页：执行命令docker compose ps查看服务状态，如果web服务显示停止，执行docker compose restart nda-web即可重启恢复。
• 批量匹配失败：90%以上的原因是PDF文件名和著录模板中的档号不一致，检查修改文件名后重新匹配即可。
• 对接政务平台失败：检查服务器是否已经接入南宁政务外网，参数填写是否有多余空格，修改后重新测试连接即可。

完成以上所有步骤后，即可正常使用符合南宁档案局规范要求的数字档案馆系统，满足单位内部档案管理和市级共享上报的所有需求。