数字档案馆系统网络版本地部署零门槛纯干货实操分步指南

前置环境准备

仅需2个工具，全程无复杂配置，新手10分钟完成环境搭建：

• Docker Desktop，Windows下载地址：https://desktop.docker.com/win/stable/amd64/Docker%20Desktop%20Installer.exe；macOS下载地址：https://desktop.docker.com/mac/stable/amd64/Docker.dmg，Windows安装时务必勾选「Use WSL 2 instead of Hyper-V」，否则后续部署会失败
• Docker Compose，Docker Desktop已内置，无需单独安装，打开命令行即可验证

验证环境：打开对应命令行（Windows用PowerShell，macOS用终端），执行以下命令：docker --version && docker-compose --version，输出类似「Docker version 25.0.3, build 4debf41」「docker-compose version 1.29.2, build 5becea4c」即为环境达标

部署文件准备

在电脑任意位置创建名为digital-archives的文件夹，进入文件夹后新建2个无后缀名文件，直接复制以下完整内容：

• .env（环境变量配置）： ``` 核心配置项，请勿修改注释外内容 DB_HOST=db DB_PORT=5432 DB_NAME=archives_db DB_USER=archives_admin DB_PASS=Archives2024@Safe WEB_PORT=8080 ```
• docker-compose.yml（服务编排文件）： ``` version: '3.8' services: web: image: registry.cn-hangzhou.aliyuncs.com/opensource/digital-archives:v2.3.1 ports: - "${WEB_PORT}:80" depends_on: - db environment: - DB_HOST=${DB_HOST} - DB_PORT=${DB_PORT} - DB_NAME=${DB_NAME} - DB_USER=${DB_USER} - DB_PASS=${DB_PASS} restart: always db: image: postgres:14-alpine environment: - POSTGRES_DB=${DB_NAME} - POSTGRES_USER=${DB_USER} - POSTGRES_PASSWORD=${DB_PASS} volumes: - postgres_data:/var/lib/postgresql/data restart: always volumes: postgres_data: ```

执行部署核心命令

回到digital-archives文件夹，在文件夹内打开命令行（Windows可在文件夹地址栏输入「cmd」回车，macOS右键文件夹→服务终端→新建终端），依次执行3条命令，全程等待自动完成：

• 命令1：拉取系统及数据库镜像（仅首次执行，需1-5分钟，取决于网速）：docker-compose pull
• 命令2：启动所有服务（后台运行，无需保留命令窗口）：docker-compose up -d
• 命令3：初始化系统数据库（仅首次部署执行，后续无需操作）：docker-compose exec web python manage.py init_system

验证部署状态：执行docker-compose ps，若web和db的「State」列均显示「Up」，则部署成功，否则需排查日志

系统首次登录与基础设置

1. 打开任意浏览器，输入地址：http://localhost:8080（若修改.env中WEB_PORT则使用对应端口，如改8081则为http://localhost:8081）

2. 首次登录账号密码：admin / Admin@2024!2024（系统默认密码，务必立即修改），登录后点击右上角头像→「账号设置」→修改管理员密码

3. 基础配置：点击左侧菜单「系统设置→基础参数」，填写档案馆名称、负责人姓名、联系电话，点击「保存」即可，无需其他配置

常见问题快速修复

1. 端口被占用（启动时提示「port is already allocated」）：执行命令查看占用进程，Windows用netstat -ano | findstr :8080，macOS用lsof -i:8080，找到进程PID后，Windows在任务管理器结束对应进程，macOS执行kill -9 PID，重新执行docker-compose up -d

2. 数据库连接失败（日志显示「connection refused」）：检查.env中DB_PASS是否与docker-compose.yml内的数据库密码一致，若修改过，执行docker-compose down -v（注意：此命令会删除所有测试数据，生产环境请勿执行），重新执行部署核心命令

3. 镜像拉取失败：替换镜像地址为国内加速地址，修改docker-compose.yml中web服务的image为「docker.mirrors.ustc.edu.cn/opensource/digital-archives:v2.3.1」，重新执行拉取命令