科研数字档案馆本地部署实操：从环境到数据导入全步骤

一、前置准备（必备软件与工具）

所有操作需在Windows/macOS/Linux系统完成，核心工具依赖如下：

1. 必须安装的软件

• Docker Desktop 20.10+：用于容器化部署，避免环境依赖冲突。下载地址：Windows https://download.docker.com/win/stable/Docker%20Desktop%20Installer.exe；macOS https://download.docker.com/mac/stable/Docker.dmg；Linux执行：curl -fsSL https://get.docker.com | sh
• Git 2.30+：用于克隆开源项目。下载地址：https://git-scm.com/download，默认完成安装即可。

2. 克隆科研档案项目

打开命令行工具（Windows用PowerShell，mac/Linux用终端），执行以下命令：

```bash git clone https://github.com/sswahn/research-archive.git cd research-archive ```

二、容器化部署（零配置一键启动）

此步骤无需手动配置Python、数据库等环境，Docker会自动完成所有依赖部署，仅需确保Docker已正常启动。

1. 启动全部服务

在research-archive目录下执行命令，等待容器构建完成（约1-2分钟）：

```bash docker-compose up -d --build ```

验证服务状态，执行命令后所有服务需显示为“Up”状态：

```bash docker-compose ps ```

2. 初始化数据库与管理员账号

执行以下命令初始化数据库并创建后台管理员：

```bash 执行数据库迁移 docker-compose exec web python manage.py migrate 创建管理员账号，按提示输入用户名、邮箱、密码（密码需≥8位） docker-compose exec web python manage.py createsuperuser ```

三、核心功能验证（确认部署成功）

打开浏览器，输入地址 http://localhost:8000，若能看到科研数字档案馆的首页，则部署成功。点击“后台登录”，输入刚创建的管理员账号密码，进入后台管理页面。

四、科研档案数据导入实操（核心步骤）

1. 数据与附件准备

• 数据格式要求：需为JSON数组格式，每条记录必须包含：id（唯一整数）、title（档案标题）、author（作者，多个用英文逗号分隔）、abstract（摘要）、publication_date（发布日期，格式YYYY-MM-DD）、file_path（附件相对路径）。示例： ```json [ { "id": 1, "title": "分布式系统容错机制研究", "author": "王明,李华", "abstract": "本文分析了分布式系统中常见的容错算法，提出了一种改进的心跳检测机制...", "publication_date": "2024-01-15", "file_path": "/media/archives/分布式系统容错论文.pdf" } ] ```
• 附件存放：将所有PDF/Word等附件复制到项目的 media/archives 目录下，Linux/mac需执行权限命令（Windows跳过）： ```bash sudo chmod -R 755 media/archives ```

2. 执行数据导入

将上述JSON数据保存为 data.json 并放到research-archive目录根下，执行导入命令：

```bash docker-compose exec web python manage.py import_archives data.json ```

五、常见问题快速排查

1. 容器启动失败

执行 docker-compose logs web 查看日志，若提示端口占用，修改项目根目录下 docker-compose.yml 文件，将web服务的ports部分改为“8080:8000”（即本地端口改8080，避免冲突），重新执行 docker-compose up -d --build。

2. 数据导入失败

检查JSON格式：确保所有引号、逗号配对，日期格式为YYYY-MM-DD，file_path为相对项目的路径（仅写/media/archives/xxx.pdf即可）。

六、本地使用收尾

如需访问刚导入的档案，在首页搜索标题或作者即可查看详情与下载附件。若需停止服务，执行 docker-compose down；如需重启，执行 docker-compose up -d。