住建部门数字档案馆系统本地部署与基础配置实操指南

前置部署环境准备

实操前需准备符合要求的运行环境，以下步骤适用于Ubuntu 20.04/22.04 LTS系统，其他Linux发行版可对应调整命令。

1. 基础软件安装

安装Docker及Docker Compose，用于快速搭建容器化运行环境，执行以下完整命令：

``` sudo apt update sudo apt install docker.io docker-compose -y sudo systemctl enable --now docker sudo usermod -aG docker $USER newgrp docker ```

命令执行后需重新登录用户使docker组权限生效，避免后续操作需root权限。

2. 系统资源预留

需为系统预留至少2核CPU、4GB内存、20GB磁盘空间，资源不足会导致服务初始化失败：

资源不足会导致数据库及Web服务启动异常，需提前通过free -m、df -h命令确认配置达标。

核心部署步骤

1. 项目配置文件拉取

从官方代码仓库拉取部署配置模板，执行以下命令：

``` git clone https://github.com/OpenEcoTech/construction-digital-archive.git cd construction-digital-archive ```

若无Git工具，先执行sudo apt install git完成安装后再执行上述命令。

2. 核心配置文件修改

打开项目内的docker-compose.yml文件，用nano或vim编辑，替换为以下完整可运行配置：

```yaml version: '3.8' services: archive-db: image: postgres:14 environment: POSTGRES_USER: admin POSTGRES_PASSWORD: CDArchive@2024! POSTGRES_DB: construction_archive volumes: - db_data:/var/lib/postgresql/data ports: - "5432:5432" archive-web: image: openecotech/construction-archive:v1.0 depends_on: - archive-db environment: DB_HOST: archive-db DB_PORT: 5432 DB_USER: admin DB_PASSWORD: CDArchive@2024! SYSTEM_PORT: 8080 ports: - "8080:8080" volumes: db_data: ```

务必将POSTGRES_PASSWORD和DB_PASSWORD修改为不少于8位的字母+数字+特殊字符组合，禁止使用默认密码。

3. 服务启动与验证

在项目目录下执行后台启动命令，等待30秒后验证服务状态：

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

若服务状态显示为Up则正常，若为Exited，执行docker logs archive-web查看错误日志定位问题；在浏览器访问http://localhost:8080，输入默认账号admin、初始密码123456即可登录，首次登录强制要求修改密码，新密码需包含大小写字母和数字。

基础功能实操

1. 档案分类配置

登录后进入【系统设置】-【档案分类管理】，点击【新增分类】，按住建部门标准填写：

• 分类名称：工程规划许可档案
• 分类编码：JG-001
• 排序值：1

保存后继续添加施工许可档案（编码SG-001）等必要分类，分类编码需符合住建档案管理的统一编码规则，避免后续检索混乱。

2. 单条档案录入测试

进入【档案管理】-【新增档案】，选择已创建的工程规划许可档案分类，填写以下字段：

• 档案编号：JG-2024-001（需唯一）
• 工程名称：XX花园小区1-3号楼规划许可
• 建设单位：XX置业有限公司
• 开工/竣工日期：填写对应时间

点击【上传附件】，选择本地PDF格式文件（大小≤50MB），点击保存完成录入，禁止上传加密PDF文件，否则系统无法解析附件内容。

常见问题排查

1. 端口占用问题

访问8080端口无响应时，执行命令查看占用进程：sudo lsof -i:8080，找到PID后执行sudo kill -9 PID释放，再执行docker-compose restart重启服务。

2. 数据库连接失败

执行docker-compose logs archive-db查看日志，若显示密码错误，需重新修改docker-compose.yml中的数据库密码，执行docker-compose down -v && docker-compose up -d重启服务（此命令会删除旧数据库数据，需先执行docker exec archive-db pg_dump -U admin construction_archive > backup.sql备份数据）。

3. 档案上传失败

若提示文件过大，用在线压缩工具将PDF压缩至50MB以内；若提示格式错误，用pdftk工具转换为标准PDF，执行命令：pdftk input.pdf output output.pdf。

完成上述步骤后，即可正常使用住建部门数字档案馆系统的基础功能，如需升级，执行docker-compose pull && docker-compose up -d即可，升级前务必备份数据库。