技术咨询数字档案馆系统本地部署与基础使用纯实操指南

前置环境准备

仅需Linux（CentOS 7+）或Windows 10+系统，无需复杂开发环境，依赖Docker容器实现零冲突部署，具体操作如下：

• 安装Docker（Linux系统），执行完整命令： ``` sudo yum update -y sudo yum install -y docker sudo systemctl start docker sudo systemctl enable docker sudo usermod -aG docker $USER ``` 执行完后重启终端生效，输入docker --version验证安装成功。
• Windows系统直接下载Docker Desktop（官方地址：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe），安装后启动即可，无需额外配置。

系统核心依赖部署（MySQL）

1. 创建MySQL数据卷与容器

执行完整命令，创建持久化数据的MySQL容器，避免数据丢失： ``` docker run -d -p 3306:3306 \ -v /opt/mysql/data:/var/lib/mysql \ -e MYSQL_ROOT_PASSWORD=Root@2024 \ -e MYSQL_DATABASE=archive_db \ -e MYSQL_USER=archive_user \ -e MYSQL_PASSWORD=Archive@2024 \ mysql:5.7 ``` 参数说明：-p映射端口3306，-v挂载主机目录存数据，-e配置数据库账号密码，确保与后续系统配置一致。

技术咨询数字档案馆系统部署

1. 拉取官方镜像

执行命令拉取稳定版系统镜像： ``` docker pull docker.io/techconsult/archive-system:v1.0 ```

2. 创建系统容器并挂载配置

先创建主机配置目录，再将配置文件映射到容器： ``` sudo mkdir -p /opt/archive/data ``` 在/opt/archive/data下新建config.ini文件，粘贴以下完整配置（不可省略）： ``` [database] host=localhost port=3306 user=archive_user password=Archive@2024 db_name=archive_db [system] admin_username=admin admin_password=Tech@Archive2024 upload_path=/app/upload max_file_size=10485760 ``` 创建系统容器，执行完整命令： ``` docker run -d -p 8080:8080 \ -v /opt/archive/data:/app/data \ --name archive-system \ --link mysql:mysql \ docker.io/techconsult/archive-system:v1.0 ``` 参数说明：--link关联MySQL容器，确保系统能连接数据库。

3. 初始化数据库表结构

进入系统容器执行初始化脚本： ``` docker exec archive-system php /app/init.php ``` 执行后显示“Database initialized”即为成功，无报错则继续。

系统访问与基础操作

1. 登录系统

在浏览器输入地址：http://localhost:8080，输入配置的账号admin和密码Tech@Archive2024，点击登录。

2. 新增档案实操

1. 登录后点击左侧菜单「档案管理」→「新增档案」；
2. 填写档案标题（不可为空）、内容详情；
3. 点击「上传附件」，选择不超过10MB的文件（支持PDF、Word格式）；
4. 设置档案分类（默认选“技术咨询”），点击「提交」，完成存档。

3. 档案检索实操

在首页顶部搜索框输入关键词（如“技术咨询流程”），点击「检索」，结果页会显示匹配的所有档案，点击档案标题可查看详情。

常见问题解决

• 若无法访问系统：执行docker ps查看archive-system容器是否运行，若未运行则执行docker start archive-system；
• 若数据库连接失败：检查/opt/archive/data/config.ini中数据库密码是否与MySQL容器配置的一致，修改后重启系统容器：docker restart archive-system。