ArchivesSpace Docker镜像文档

一、镜像概述和主要用途

ArchivesSpace 是一款由档案管理员为档案管理场景开发的开源档案信息管理应用程序，旨在帮助档案机构、文化遗产组织及图书馆等机构系统化管理档案、手稿和数字对象，并通过 Web 界面提供安全可控的访问能力。该镜像封装了 ArchivesSpace 应用的完整运行环境，简化部署流程，支持快速搭建档案信息管理系统。

二、核心功能和特性

核心功能

• 档案全生命周期管理：支持档案从采集、著录、整理、存储到销毁的全流程管理。
• 元数据管理：兼容档案领域主流元数据标准（如 Dublin Core、EAD、DACS 等），支持自定义元数据字段。
• Web 访问与检索：提供用户友好的 Web 界面，支持多条件检索、筛选及档案资源预览。
• 数字对象管理：支持数字档案的存储、关联及访问控制，确保数字资源长期可访问。

特性

• 开源免费：基于 Educational Community License 2.0 开源协议，可自由下载、使用和二次开发。
• 社区支持：由全球档案机构、开发者及用户组成的社区持续维护，提供技术文档和问题解答。
• 可扩展性：支持通过插件扩展功能，适配不同机构的定制化需求。
• 数据安全：内置用户权限管理机制，支持角色分配及操作审计，保障档案数据安全。

三、使用场景和适用范围

适用场景

• 档案机构：档案馆、档案管理部门用于管理纸质档案、电子档案的数字化成果。
• 文化遗产机构：博物馆、纪念馆等管理历史文献、手稿、实物档案的数字化资源。
• 图书馆特藏部：大学图书馆、公共图书馆管理特藏资源（如古籍、善本、私人手稿）。
• 研究机构：科研单位管理项目档案、研究数据及成果资料。

适用范围

• 中小型档案机构（单节点部署）或大型机构（集群扩展部署）。
• 需实现档案资源在线检索与共享的场景。
• 需满足档案管理规范化、标准化的组织。

四、使用方法和配置说明

前置要求

• 已安装 Docker 19.03+ 及 Docker Compose 2.0+。
• 服务器建议配置：2 CPU 核心、4GB 内存、50GB 可用磁盘空间（视档案数据量调整）。

1. 获取镜像

从 Docker Hub 拉取最新版本镜像：

docker pull archivesspace/archivesspace:latest

2. 基本部署（单容器模式）

2.1 启动容器

通过 docker run 命令快速启动，需映射端口并挂载数据卷持久化数据：

docker run -d \
  --name archivesspace \
  -p 8080:8080 \  # Web 访问端口
  -p 8089:8089 \  # API 端口（可选）
  -v /path/to/local/data:/archivesspace/data \  # 持久化数据目录
  -e DB_HOST=db.example.com \  # 数据库主机地址
  -e DB_NAME=archivesspace \   # 数据库名称
  -e DB_USER=as_user \         # 数据库用户名
  -e DB_PASSWORD=secure_pass \ # 数据库密码
  archivesspace/archivesspace:latest

2.2 访问应用

容器启动后，通过 http://<服务器IP>:8080 访问 Web 界面，默认管理员账户：

• 用户名：admin
• 密码：admin（首次登录需修改）

3. 高级部署（Docker Compose 模式）

推荐使用 Docker Compose 管理应用及依赖服务（如 PostgreSQL 数据库），配置示例如下：

3.1 创建 docker-compose.yml

version: '3.8'

services:
  archivesspace:
    image: archivesspace/archivesspace:latest
    container_name: archivesspace_app
    ports:
      - "8080:8080"  # Web 界面端口
      - "8089:8089"  # API 端口
    volumes:
      - ./data:/archivesspace/data  # 应用数据持久化
      - ./config:/archivesspace/config  # 自定义配置文件（可选）
    environment:
      - DB_HOST=postgres  # 数据库服务名（与下方 postgres 服务对应）
      - DB_PORT=5432      # 数据库端口
      - DB_NAME=archivesspace
      - DB_USER=as_user
      - DB_PASSWORD=secure_pass
      - LOG_LEVEL=info    # 日志级别（debug/info/warn/error）
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:13-alpine
    container_name: archivesspace_db
    ports:
      - "5432:5432"
    volumes:
      - ./pgdata:/var/lib/postgresql/data  # 数据库数据持久化
    environment:
      - POSTGRES_DB=archivesspace
      - POSTGRES_USER=as_user
      - POSTGRES_PASSWORD=secure_pass
    restart: unless-stopped

3.2 启动服务

在 docker-compose.yml 所在目录执行：

docker-compose up -d

3.3 验证部署

• 访问 http://<服务器IP>:8080，输入默认账户 admin/admin 登录。
• 检查日志确认服务正常启动：

  docker-compose logs -f archivesspace
  

4. 配置参数说明

环境变量（核心配置）

数据持久化

• 应用数据：挂载 /archivesspace/data 目录，存储档案文件、索引及缓存。
• 配置文件：如需自定义配置（如 config.rb），可挂载 /archivesspace/config 目录覆盖默认配置。

五、许可证

本镜像基于 Educational Community License, version 2.0 开源协议发布，详见项目 COPYING 文件。

六、问题反馈

如遇部署或使用问题，可通过以下方式反馈：

• Bug 报告：How to Report a Bug
• 功能请求：How to Request a New Feature
• 社区支持：通过 ArchivesSpace 社区论坛或邮件列表（***）获取帮助。