天津数字档案馆系统自建本地测试环境搭建实操全流程

前置准备

本指南适配的是天津政务资源体系的简化版开源测试基础资源(注:政务正式版需采购授权),先梳理硬件要求、环境依赖的软件清单:

  • 硬件要求:Windows 10/11 64位专业版及以上、内存≥8G(推荐16G)、硬盘剩余≥50G SSD
  • 核心软件:Docker Desktop for Windows(简化版)、Navicat Premium 16(数据库连接,试用版即可)

第一步:配置Docker Desktop环境

1.1 下载并安装Docker Desktop

访问Docker官方下载地址:https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe,下载完成后:

  • 双击安装包,勾选“Use WSL 2 instead of Hyper-V”(如果是Windows家庭版只能选WSL 2,必须确认WSL 2已提前开启)
  • 等待安装完成,重启电脑

1.2 启动并配置Docker镜像源

重启后双击Docker Desktop图标启动,任务栏右下角出现鲸鱼图标且变绿即为成功。接下来加速镜像下载:

  • 点击任务栏右下角鲸鱼图标→Settings→Docker Engine
  • 将原有配置文件替换为以下完整可复制的内容:
```json { "builder": { "gc": { "defaultKeepStorage": "20GB", "enabled": true } }, "registry-mirrors": [ "https://docker.mirrors.ustc.edu.cn", "https://hub-mirror.c.163.com" ], "experimental": false } ```
  • 点击“Apply & Restart”等待重启完成

第二步:拉取并运行天津数字档案馆简化版测试容器

该简化版测试容器整合了MySQL 8.0、Redis 7.0、简化版档案系统(不含涉密模块)、Nginx 1.24反向代理四个服务,一键启动无需单独配置。

2.1 拉取测试容器镜像

打开Windows PowerShell(管理员身份运行,右键点击左下角Windows图标→Windows PowerShell (管理员)),输入以下完整可复制的命令并回车:

```bash docker pull registry.cn-hangzhou.aliyuncs.com/tianjin-dag/test-archive:v1.0 ```

等待镜像拉取完成(鲸鱼图标右侧会显示进度条),约需3-10分钟,取决于网络速度。

2.2 一键启动所有服务容器

继续在PowerShell中输入以下完整可复制的命令并回车:

```bash docker run -d -p 8080:80 -p 3307:3306 -p 6380:6379 --name tianjin-dag-test --restart always registry.cn-hangzhou.aliyuncs.com/tianjin-dag/test-archive:v1.0 ```
  • 参数说明:-d后台运行,-p 8080:80把宿主机8080端口映射到容器80端口(简化版档案系统访问端口),-p 3307:3306映射数据库端口避免冲突,-p 6380:6379映射Redis端口,--name指定容器名称方便后续操作,--restart always设置容器开机自启

2.3 验证服务是否正常启动

继续在PowerShell中输入以下命令并回车:

```bash docker ps ```

如果出现状态为“Up X seconds/minutes”、名称为“tianjin-dag-test”的一行记录,则说明服务启动成功;如果没有出现,输入`docker logs tianjin-dag-test`查看错误日志排查问题。

第三步:初始化并登录天津数字档案馆简化版系统

3.1 连接数据库导入初始数据

天津数字档案馆系统自建本地测试环境搭建实操全流程

打开Navicat Premium 16:

  • 点击左上角“连接”→“MySQL”
  • 填写以下完整可复制的连接参数:

连接名:天津数字档案馆测试库
主机:localhost
端口:3307
用户名:root
密码:123456
数据库:test_tj_dag

  • 点击“测试连接”,弹出“连接成功”提示后点击“确定”→“确定”
  • 双击打开“天津数字档案馆测试库”,点击“查询”→“新建查询”,复制粘贴以下初始用户授权SQL并点击“运行”:
```sql USE `test_tj_dag`; -- 重置管理员密码为123456(初始可能是随机的,需要重置) UPDATE `sys_user` SET `password` = '$2a$10$N.zmdr9k7uOCQb376NoUnuTJ8iAt6Z5EHsM8lE9lBOsl7iKTVKIUi' WHERE `user_name` = 'admin'; -- 确保管理员角色有全部权限 UPDATE `sys_role` SET `permissions` = '::' WHERE `role_code` = 'admin'; ```
  • 看到“查询执行成功,影响2行”提示后关闭Navicat即可

3.2 登录简化版档案系统

打开Chrome/Edge浏览器(推荐Chrome 110及以上版本),在地址栏输入以下完整可复制的地址并回车:

``` http://localhost:8080/tj-dag ```

进入登录页面后,填写以下完整可复制的登录信息:

  • 用户名:admin
  • 密码:123456
  • 验证码:输入页面显示的4位数字

点击“登录”即可进入简化版档案系统的首页。

第四步:基础功能快速上手(验证环境完全可用)

本步骤验证核心的档案录入、查询、导出功能:

4.1 录入一份测试文书档案

  • 点击首页左侧菜单栏的“档案管理”→“文书档案”→“新增档案”
  • 填写以下必填的基础测试数据(其他字段可选填):

全宗号:TJ001
年度:2024
保管期限:永久
件号:1
文号:津档测〔2024〕1号
责任者:天津数字档案馆测试组
题名:2024年测试文书档案
文件日期:2024-05-20
页数:3

  • 点击“上传附件”,选择任意3张本地图片作为附件上传
  • 点击“保存并提交”,弹出“操作成功”提示即可

4.2 查询并导出测试文书档案

  • 点击左侧菜单栏的“档案管理”→“文书档案”→“档案查询”
  • 在“题名”搜索框输入“测试文书档案”,点击“搜索”
  • 勾选刚才录入的那份档案,点击“导出”→“导出PDF”
  • 选择保存位置,点击“保存”,打开PDF文件查看内容是否完整

常见问题排查

5.1 Docker Desktop无法启动

右键点击左下角Windows图标→“设置”→“应用”→“可选功能”→“更多Windows功能”,勾选“适用于Linux的Windows子系统”和“虚拟机平台”,点击“确定”,等待安装完成后重启电脑再试。

5.2 访问系统出现404错误

检查PowerShell中输入的系统访问地址是否正确(注意是http不是https,且tj-dag前面有斜杠),如果正确,输入`docker restart tianjin-dag-test`重启容器再试。

5.3 数据库连接失败

检查Navicat Premium 16的连接参数是否正确(尤其是端口是否为3307),如果正确,检查Docker容器是否在运行(输入`docker ps`查看)。

AI咨询
热线电话

028-85154420

15388110056

全国售前咨询电话

扫码咨询
安答联动微信公众号二维码

微信扫码关注安答联动

申请试用
热线电话
申请试用

安答联动档案管理系统