数字档案馆系统终身授权申请、部署与验证全流程实操指南

本文适用于国内主流开源数字档案馆系统的终身授权落地，所有步骤可直接复制执行，无需额外调整。

一、前置准备（操作前必须完成）

1.1 硬件与环境要求

• 服务器：x86架构4核8G以上配置，1T SSD以上存储空间，内网部署无需公网IP，对外提供服务需开放8080端口
• 系统版本：CentOS 7.9 或 Ubuntu 22.04（其他版本未做兼容测试，不推荐使用）
• 依赖环境：Docker 20.10+、Docker Compose 2.15+（Docker部署方式）；Java 11、MySQL 8.0（二进制部署方式）

1.2 申请材料准备

• 单位组织机构代码证扫描件（加盖电子公章）
• 服务器主网卡MAC地址：Linux服务器执行命令ip addr show eth0 | grep ether | awk '{print $2}'获取，Windows服务器执行ipconfig /all查看物理地址 提交的MAC地址必须为服务器主网卡物理地址，禁止填写虚拟网卡/子网卡MAC，绑定后无法修改
• 100字以内的系统使用场景说明（仅用于审核，无特殊格式要求）

二、终身授权申请流程

1. 打开官方终身授权申请入口：https://app.dangantong.com/apply/permanent，按页面提示填写单位信息、上传材料、填入提前获取的MAC地址，提交申请
2. 审核周期为1个工作日，审核通过后预留邮箱会收到2个附件：授权文件license.dat、校验公钥pub.key，禁止修改两个文件的任何内容（包括空格、换行符），否则会导致授权校验失败
3. 将收到的两个文件保存到本地，不要上传至公网网盘或泄露给第三方，避免授权被封禁

三、授权部署与系统配置

可选择Docker部署或二进制部署两种方式，二选一即可。

3.1 Docker部署（推荐，无需单独安装依赖）

1. 拉取官方稳定版系统镜像： ```bash docker pull registry.cn-hangzhou.aliyuncs.com/dangantong/archive-system:v2.3.1 ```
2. 创建系统挂载目录： ```bash mkdir -p /opt/archive/{license,data,logs} ```
3. 将收到的license.dat和pub.key上传到/opt/archive/license目录，执行权限配置： ```bash chmod 755 /opt/archive/license && chmod 644 /opt/archive/license/ ```
4. 在/opt/archive目录下创建docker-compose.yml文件，复制以下完整配置： ```yaml version: '3' services: archive-system: image: registry.cn-hangzhou.aliyuncs.com/dangantong/archive-system:v2.3.1 container_name: archive-system ports: - "8080:8080" volumes: - /opt/archive/license:/app/license - /opt/archive/data:/app/data - /opt/archive/logs:/app/logs environment: - TZ=Asia/Shanghai - LICENSE_PATH=/app/license/license.dat - PUB_KEY_PATH=/app/license/pub.key restart: always ```
5. 启动系统容器： ```bash docker compose up -d ``` 等待30秒后访问http://你的服务器IP:8080即可进入系统登录页，默认管理员账号：admin，默认密码：Archive@2024，登录后请立即修改密码。

3.2 二进制部署（适合需要自定义底层配置的场景）

1. 下载官方二进制安装包： ```bash wget https://dangantong.com/download/archive-system-v2.3.1.tar.gz ```
2. 解压安装包到指定目录： ```bash tar -zxvf archive-system-v2.3.1.tar.gz -C /opt/ ```
3. 将license.dat和pub.key上传到/opt/archive-system/license目录，执行权限配置： ```bash chmod 644 /opt/archive-system/license/ ```
4. 修改配置文件/opt/archive-system/config/application.yml，复制以下完整配置，仅需替换MySQL密码为你自己的数据库密码： ```yaml server: port: 8080 spring: datasource: url: jdbc:mysql://127.0.0.1:3306/archive_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: 替换为你的MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver license: path: /opt/archive-system/license/license.dat pub-key: /opt/archive-system/license/pub.key file: storage-path: /opt/archive-system/data/ ```
5. 导入数据库初始化脚本： ```bash mysql -u root -p你的MySQL密码 < /opt/archive-system/sql/archive_db.sql ```
6. 后台启动系统： ```bash nohup java -jar /opt/archive-system/archive-system.jar > /opt/archive-system/logs/start.log 2>&1 & ``` 等待30秒后访问http://你的服务器IP:8080即可登录，默认账号密码和Docker部署一致。

四、授权有效性验证

4.1 前台验证

登录系统后，点击右上角【系统设置】-【授权信息】，若显示授权类型为“终身授权”、到期时间为“永久有效”、绑定MAC地址与你提交的地址一致，即代表授权部署成功。

4.2 后台验证

在服务器执行以下命令校验授权合法性： ```bash curl http://127.0.0.1:8080/api/license/info ``` 返回结果中expireTime字段值为-1、code字段值为200，即代表终身授权生效。

五、常见故障排查

5.1 授权校验失败

• 首先核对服务器MAC地址是否与提交的一致，若更换了主网卡需重新提交申请
• 执行md5sum /opt/archive/license/license.dat，对比返回值与邮件中给出的MD5值是否一致，不一致说明文件被损坏，需重新下载附件
• 检查授权文件权限是否为644，若权限不足会导致系统无法读取文件

5.2 系统启动失败

• Docker部署执行docker logs archive-system、二进制部署查看/opt/archive-system/logs/start.log排查报错
• 常见报错原因：8080端口被占用，修改配置文件中的端口即可；MySQL连接失败，核对数据库地址、账号密码是否正确

5.3 授权到期误报

若系统弹出授权到期提示，首先执行date命令检查服务器时间是否准确，时间误差超过24小时会触发校验报错，执行ntpdate ntp.aliyun.com同步时间后重启系统即可恢复。