数字档案馆系统钢铁版本地部署实操全流程指南

前置准备

需准备1台运行Linux系统的服务器（推荐Ubuntu 20.04+或CentOS 7+），硬件配置要求：内存≥4G，硬盘≥20G，且服务器可访问公网。Ubuntu系统先执行以下命令安装Docker及Docker Compose：

``` sudo apt update && sudo apt install docker.io docker-compose -y sudo systemctl enable --now docker docker --version && docker-compose --version ```

执行后若输出Docker及Docker Compose版本号，说明安装成功。

步骤1：创建工作目录并获取核心文件

创建系统部署专属目录并进入目录：

``` mkdir -p /opt/steel-archive && cd /opt/steel-archive ```

拉取官方docker-compose部署文件：

``` wget -O docker-compose.yml https://gitee.com/archive-steel/steel-archive/raw/v1.2.0/deploy/docker-compose.yml ```

创建配置子目录并拉取数据库初始化文件：

``` mkdir config && wget -O config/init.sql https://gitee.com/archive-steel/steel-archive/raw/v1.2.0/deploy/config/init.sql ```

步骤2：修改核心配置

2.1 配置数据库连接

使用以下完整配置覆盖docker-compose.yml内容（内置MySQL数据库，无需单独安装），确保配置准确：

``` version: '3.8' services: mysql: image: mysql:8.0.33 container_name: steel-archive-mysql environment: MYSQL_ROOT_PASSWORD: SteelArchive@2024 MYSQL_DATABASE: steel_archive MYSQL_USER: archive_user MYSQL_PASSWORD: Archive@Steel2024 volumes: - mysql_data:/var/lib/mysql - ./config/init.sql:/docker-entrypoint-initdb.d/init.sql ports: - "3306:3306" restart: unless-stopped steel-archive: image: registry.cn-hangzhou.aliyuncs.com/archive-steel/steel-archive:v1.2.0 container_name: steel-archive depends_on: - mysql ports: - "8080:8080" volumes: - ./data:/opt/archive/data - ./logs:/opt/archive/logs environment: SPRING_PROFILES_ACTIVE: prod SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/steel_archive?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai SPRING_DATASOURCE_USERNAME: archive_user SPRING_DATASOURCE_PASSWORD: Archive@Steel2024 restart: unless-stopped volumes: mysql_data: ```

将以下内容写入config/init.sql（内置管理员账号密码，无需修改）：

``` -- 数字档案馆系统钢铁版数据库初始化脚本 CREATE DATABASE IF NOT EXISTS steel_archive DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE steel_archive; CREATE TABLE IF NOT EXISTS `archive_user` ( `id` bigint NOT NULL AUTO_INCREMENT, `username` varchar(50) NOT NULL, `password` varchar(100) NOT NULL, `role` varchar(20) NOT NULL DEFAULT 'user', PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; INSERT INTO `archive_user` (`username`, `password`, `role`) VALUES ('admin', '$2a$10$Z8X7Y6W5V4U3T2S1R0Q9P8O7N6M5L4K3J2I1H0G9F8E7D6C5B4A3', 'admin'); ```

2.2 调整端口（可选）

若8080端口被占用，修改docker-compose.yml中steel-archive服务的ports节点，将"8080:8080"改为"9090:8080"，对应后续访问地址为http://服务器IP:9090。

步骤3：启动并验证系统

在/opt/steel-archive目录执行启动命令：

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

等待2分钟（数据库初始化及镜像启动需时间），查看容器状态：

``` docker ps -a ```

若输出中steel-archive和steel-archive-mysql的STATUS均为Up，则启动成功；若状态为Exited，执行`docker logs steel-archive`查看错误日志，常见问题为端口冲突或配置密码错误。

步骤4：初始登录与功能验证

打开本地浏览器，输入服务器IP加自定义端口（如http://192.168.1.100:8080），进入登录页，输入用户名admin，密码123456，点击登录。登录成功后，进入系统管理页面，可查看档案目录、上传测试文件，确认系统功能正常运行。

必做注意事项

1. 服务器防火墙需开放对应端口：云服务器需在安全组规则中开放8080（或自定义端口）及3306（需远程访问数据库时）； 2. 系统数据默认存储在/opt/steel-archive/data及Docker volume mysql_data中，禁止删除，否则会丢失所有档案； 3. 升级系统版本前，需备份/opt/steel-archive/data目录，执行`docker-compose pull`更新镜像后重启； 4. 若启动时内存不足，关闭服务器其他应用，确保Docker可分配≥4G内存。