文山壮族苗族自治州档案管理系统本地部署实操全指南

前置环境准备

仅需安装Docker和Docker Compose，复制以下命令直接执行即可，无需额外配置依赖：

1. 更新系统软件源（Ubuntu系统）

``` sudo apt update ```

2. 安装Docker及Docker Compose

``` sudo apt install docker.io docker-compose -y ```

3. 启动Docker服务并设置开机自启

``` sudo systemctl enable --now docker ```

4. 验证安装是否成功

``` docker --version docker-compose --version ```

若输出对应版本号，说明环境准备完成。

获取系统部署文件

直接克隆官方公开的部署代码仓库，无需手动下载压缩包：

``` git clone https://gitee.com/opensource-solutions/wenshan-arch-system.git cd wenshan-arch-system ```

执行完成后，当前目录会生成部署所需的全部配置文件。

核心配置调整（必须操作）

1. 数据库密码修改

打开目录下的docker-compose.yml文件，找到数据库配置段，修改两处密码，两处密码需保持一致：

``` services: db: image: mysql:8.0 restart: always environment: MYSQL_ROOT_PASSWORD: 自定义数据库密码（长度≥8位，含字母数字） MYSQL_DATABASE: arch_db MYSQL_USER: arch_admin MYSQL_PASSWORD: 与上方密码完全一致 ports: - "3306:3306" volumes: - arch_db_data:/var/lib/mysql ```

2. 本地访问端口调整（可选）

若8080端口被占用，可修改web服务的端口映射，例如改为9090：

``` web: image: wenshan-arch:v1.2 restart: always ports: - "9090:8080" 左侧9090为本地访问端口，右侧8080为容器内部端口，请勿修改右侧 depends_on: - db ```

启动档案管理系统

在当前wenshan-arch-system目录下执行以下命令，启动全部服务：

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

等待1-2分钟后，执行命令查看容器运行状态：

``` docker-compose ps ```

若输出结果中，db和web两个容器的状态均为Up，说明系统启动成功。

系统初始配置

1. 访问系统页面

打开任意浏览器，输入地址：http://localhost:8080（若修改了端口则对应端口，如9090），进入登录引导页。

2. 设置超级管理员账户

按页面提示，输入管理员姓名、账号（默认推荐admin）、密码，密码长度≥8位，需包含字母和数字，提交后完成系统初始化，即可进入档案管理后台。

日常维护操作

1. 查看系统运行日志

``` docker-compose logs -f web ```

执行后会实时输出系统后台日志，便于排查问题。

2. 停止系统服务

在项目目录下执行：

``` docker-compose down ```

3. 更新系统到最新版本

先停止服务，再拉取最新镜像重启：

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