普洱数字档案馆系统本地部署全流程零门槛实操指南

一、部署前准备

1. 环境安装

需提前安装Docker与Docker Compose，针对Ubuntu系统执行以下命令（CentOS请替换对应Docker安装脚本）：

• 安装Docker：sudo apt update && sudo apt install docker.io -y && sudo systemctl enable --now docker
• 安装Docker Compose：sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose

安装完成后执行docker --version和docker-compose --version，出现版本号即验证成功。

2. 创建工作目录

执行命令创建部署专属目录并进入：mkdir ~/digital-archive && cd ~/digital-archive

二、核心配置文件编写

1. 编写Docker Compose配置

在当前目录新建名为docker-compose.yml的文件，复制以下完整内容：

``` version: '3.8' services: archive-db: image: mysql:8.0 container_name: archive-mysql environment: MYSQL_ROOT_PASSWORD: Archive@2024 MYSQL_DATABASE: digital_archive MYSQL_USER: archive_admin MYSQL_PASSWORD: ArchiveUser@2024 ports: - "3306:3306" volumes: - ./mysql/data:/var/lib/mysql - ./mysql/init:/docker-entrypoint-initdb.d restart: always archive-system: image: puwen/digital-archive:latest container_name: archive-system ports: - "8080:8080" environment: DB_HOST: archive-db DB_PORT: 3306 DB_NAME: digital_archive DB_USER: archive_admin DB_PASS: ArchiveUser@2024 SYSTEM_PORT: 8080 depends_on: - archive-db volumes: - ./upload:/upload - ./config:/config restart: always ```

注意：需修改两处密码为非默认值，避免安全风险，MySQL密码与应用数据库密码需保持一致。

2. 初始化数据库脚本

创建配置目录并生成数据库初始化文件：

• 创建目录：mkdir -p ./mysql/init ./upload ./config
• 编写初始化脚本：执行vim ./mysql/init/init.sql，插入以下内容：

``` CREATE DATABASE IF NOT EXISTS digital_archive; USE digital_archive; CREATE TABLE IF NOT EXISTS users ( id INT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(255) NOT NULL, role VARCHAR(20) NOT NULL DEFAULT 'operator', create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); INSERT INTO users (username, password, role) VALUES ('admin', 'e10adc3949ba59abbe56e057f20f883e', 'admin'); ```

注意：初始管理员密码为MD5加密的123456，登录后请立即修改。

三、启动系统与验证

1. 启动全部服务

在部署目录下执行docker-compose up -d，等待2-3分钟完成镜像拉取与服务初始化。

2. 验证服务状态

执行docker ps，若显示archive-mysql和archive-system两个容器，状态均为Up，端口分别映射3306和8080，即为正常运行。

3. 登录系统

在本地或服务器浏览器输入：http://你的服务器IP:8080，默认账号：admin，默认密码：123456，登录后请立即修改管理员密码。

四、日常操作

1. 停止系统

在部署目录执行：docker-compose down，服务停止但数据库、文件等数据会永久保留。

2. 更新系统

停止后执行：docker-compose pull && docker-compose up -d，拉取官方最新镜像并重启服务，无需手动修改配置。

3. 上传档案文件

将所有档案文件直接放入部署目录下的./upload文件夹，系统会自动同步至存储路径，无需额外配置或转换格式。