成都数字档案馆系统本地轻量级标准测试环境完整搭建指南

前置准备清单

所有操作基于Windows 10/11 64位系统，先确认满足以下条件：

• 已安装Docker Desktop（Windows版）：下载地址 https://www.docker.com/products/docker-desktop/，安装后需启用WSL2
• 已注册并开通Docker Hub账号：无需付费，用于拉取官方及社区兼容DEMO镜像
• 电脑空闲内存≥4GB，空闲磁盘≥20GB

第一步：启动Docker并配置国内镜像源

重点说明：官方镜像拉取速度极慢，必须配置国内阿里云或腾讯云镜像加速。

操作步骤

1. 双击桌面Docker Desktop图标启动，等待右下角托盘Docker图标变为绿色稳定状态
2. 右键托盘Docker图标→Settings（设置）→Docker Engine
3. 将原配置文件中registry-mirrors数组替换为以下完整内容（保留其他默认配置）：

   {
   "builder": {
   "gc": {
   "defaultKeepStorage": "20GB",
   "enabled": true
   }
   },
   "experimental": false,
   "registry-mirrors": [
   "https://docker.mirrors.ustc.edu.cn",
   "https://hub-mirror.c.163.com"
   ]
   }

4. 点击右下角“Apply & Restart”，等待Docker再次变为绿色稳定状态

第二步：拉取并部署DEMO核心服务

本次使用国内社区适配的成都数字档案馆基础版DEMO，包含档案元数据管理、全文检索、归档流程三大核心模块。

1. 拉取配套镜像

打开Windows PowerShell（管理员权限）或CMD，依次执行以下命令：

 拉取MySQL 5.7.36（DEMO指定版本，避免兼容性问题）
docker pull mysql:5.7.36
拉取Elasticsearch 7.10.2（全文检索指定版本）
docker pull elasticsearch:7.10.2
拉取DEMO应用镜像（社区轻量版，体积约2GB）
docker pull registry.cn-hangzhou.aliyuncs.com/cd-dag-test/cd-dag-demo:v1.0.0

2. 创建Docker网络（隔离服务，避免端口冲突）

执行命令：

docker network create cd-dag-net

3. 启动MySQL服务

创建本地存储目录避免重启后数据丢失，再启动服务：

 创建本地MySQL存储目录（假设D盘根目录，可自行修改）
mkdir D:\cd-dag-data\mysql
启动MySQL容器
docker run -d \
--name cd-dag-mysql \
--network cd-dag-net \
-p 3307:3306 \
-v D:\cd-dag-data\mysql:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=CdDagTest2024@ \
-e MYSQL_DATABASE=cd_dag_db \
mysql:5.7.36 \
--character-set-server=utf8mb4 \
--collation-server=utf8mb4_unicode_ci

重要细节：端口映射用3307避免占用本地原有MySQL；密码CdDagTest2024@为DEMO预设，无需修改；字符集必须设为utf8mb4，否则会出现生僻字、emoji存储失败。

4. 启动Elasticsearch服务

同样创建本地存储目录，再配置内存、禁用安全模式（仅测试用）：

 创建本地ES存储目录
mkdir D:\cd-dag-data\es
给ES目录赋予权限（Windows WSL2环境下必须）
docker run --rm -v D:\cd-dag-data\es:/usr/share/elasticsearch/data busybox chmod 777 /usr/share/elasticsearch/data
启动ES容器
docker run -d \
--name cd-dag-es \
--network cd-dag-net \
-p 9200:9200 \
-p 9300:9300 \
-v D:\cd-dag-data\es:/usr/share/elasticsearch/data \
-e "discovery.type=single-node" \
-e "ES_JAVA_OPTS=-Xms512m -Xmx512m" \
-e "xpack.security.enabled=false" \
elasticsearch:7.10.2

验证ES是否启动成功：打开浏览器访问 http://localhost:9200，若返回包含“cluster_name”“version”的JSON数据则正常。

5. 等待MySQL和ES完全就绪后，启动DEMO应用

需先等待3-5分钟，确保MySQL完成初始化、ES正常启动，再执行：

docker run -d \
--name cd-dag-app \
--network cd-dag-net \
-p 8080:8080 \
-e MYSQL_HOST=cd-dag-mysql \
-e MYSQL_PORT=3306 \
-e MYSQL_USER=root \
-e MYSQL_PASSWORD=CdDagTest2024@ \
-e MYSQL_DB=cd_dag_db \
-e ES_HOST=cd-dag-es \
-e ES_PORT=9200 \
registry.cn-hangzhou.aliyuncs.com/cd-dag-test/cd-dag-demo:v1.0.0

第三步：初始化DEMO数据并访问系统

1. 查看DEMO应用日志确认初始化完成

打开Docker Desktop，点击左侧“Containers”，找到cd-dag-app，点击右侧“Logs”按钮，等待出现“成都数字档案馆基础版DEMO启动成功！”提示，即完成初始化（首次初始化需1-2分钟）。

2. 访问系统并登录

访问地址：http://localhost:8080/cd-dag
预设账号密码：

• 系统管理员：admin / CdDagAdmin2024@
• 档案录入员：operator / CdDagOp2024@
• 档案审核员：auditor / CdDagAud2024@

第四步：基础功能实操（验证环境有效性）

1. 档案元数据录入（操作员账号）

• 登录operator账号，点击左侧菜单“档案管理→元数据录入”
• 选择默认的“文书档案”门类，点击“新增单条”
• 填写必填项（题名、文号、责任者、成文日期、保管期限、件号），点击“保存并提交审核”

2. 档案审核（审核员账号）

• 退出operator账号，登录auditor账号
• 点击左侧菜单“档案审核→待审核”
• 勾选刚才录入的档案，点击“批量通过”

3. 全文检索（任意账号）

• 点击页面顶部搜索框，输入刚才录入的题名关键词，按回车或点击搜索
• 确认能检索到审核通过的文书档案

第五步：停止与重启DEMO环境

1. 临时停止所有服务

打开PowerShell，依次执行：

docker stop cd-dag-app
docker stop cd-dag-es
docker stop cd-dag-mysql

2. 重新启动所有服务

按依赖顺序启动（MySQL→ES→DEMO），避免启动失败：

docker start cd-dag-mysql
docker start cd-dag-es
等待3分钟后再启动DEMO
docker start cd-dag-app

3. 完全删除DEMO环境（谨慎操作）

若需释放磁盘空间或重新搭建，执行：

 停止并删除所有容器
docker rm -f cd-dag-app cd-dag-es cd-dag-mysql
删除配套网络
docker network rm cd-dag-net
删除本地存储数据（删除后无法恢复）
rmdir /s /q D:\cd-dag-data
删除镜像（可选，下次搭建需重新拉取）
docker rmi registry.cn-hangzhou.aliyuncs.com/cd-dag-test/cd-dag-demo:v1.0.0 elasticsearch:7.10.2 mysql:5.7.36

常见问题排查

• Docker Desktop启动失败：检查是否开启了Windows的“适用于Linux的Windows子系统”“虚拟机平台”功能，开启后重启电脑
• ES启动后立即退出：检查本地ES目录权限是否为777，再次执行权限赋予命令
• DEMO应用连接MySQL/ES失败：检查Docker网络是否正确关联，查看DEMO日志中的具体错误信息