ArchivesSpace Docker镜像文档

1. 镜像概述和主要用途

ArchivesSpace是一款由档案管理员专为档案管理设计的开源档案信息管理应用。该应用旨在帮助档案机构、文化遗产机构及图书馆等组织高效管理档案、手稿和数字对象，并通过Web界面提供便捷的访问服务。作为社区支持的软件，其开发和维护由用户、开发者及管理员共同参与，致力于满足档案管理领域的专业需求。

2. 核心功能和特性

2.1 核心功能

• 多类型档案管理：支持对传统档案、手稿、数字对象（如电子文件、图像等）的全生命周期管理，包括著录、编目、保管和处置。
• Web访问接口：提供基于Web的用户界面，支持档案资源的查询、浏览和获取，满足机构内外部用户的访问需求。
• 数据标准化支持：兼容档案管理领域的常见标准（如EAD、DACS等），确保数据规范性和互操作性。

2.2 主要特性

• 开源架构：基于开源协议发布，支持用户根据需求自定义扩展和二次开发。
• 社区驱动：由全球档案领域用户和开发者共同维护，持续迭代优化功能。
• 跨平台兼容：可部署于各类服务器环境，支持与现有系统集成。

3. 使用场景和适用范围

3.1 适用机构

• 档案馆、博物馆、图书馆等文化遗产机构
• 高校及科研机构的特藏部门
• 政府机关或企业的档案管理部门
• 任何需要系统化管理历史档案、手稿或数字资源的组织

3.2 典型场景

• 构建机构内部档案管理系统，实现档案编目与检索
• 向公众或授权用户提供档案资源的在线访问服务
• 管理数字档案的存储、备份和长期保存

4. 使用方法和配置说明

4.1 前提条件

• 已安装Docker Engine（20.10+）及Docker Compose（2.0+）
• 可用的数据库服务（推荐PostgreSQL，需提前创建数据库实例）
• 服务器资源：至少2GB内存，20GB可用磁盘空间

4.2 Docker部署示例

4.2.1 直接使用docker run部署

docker run -d \
  --name archivesspace \
  -p 8080:8080 \  # Web应用端口
  -p 8089:8089 \  #后端API端口
  -e DB_HOST=postgres-host \
  -e DB_PORT=5432 \
  -e DB_NAME=archivesspace \
  -e DB_USER=as_user \
  -e DB_PASSWORD=secure_password \
  -v /path/to/local/data:/archivesspace/data \  # 数据持久化
  archivesspace/archivesspace:latest

4.2.2 使用Docker Compose部署

创建docker-compose.yml文件：

version: '3.8'
services:
  archivesspace:
    image: archivesspace/archivesspace:latest
    container_name: archivesspace
    ports:
      - "8080:8080"  # 前端Web界面
      - "8089:8089"  # API服务端口
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=archivesspace
      - DB_USER=as_user
      - DB_PASSWORD=secure_password
      - APPLICATION_MODE=production  # 运行模式：production/development
    volumes:
      - archivesspace_data:/archivesspace/data
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:14-alpine
    container_name: archivesspace_db
    environment:
      - POSTGRES_DB=archivesspace
      - POSTGRES_USER=as_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  archivesspace_data:
  postgres_data:

启动服务：

docker-compose up -d

4.3 配置参数说明

4.3.1 核心环境变量

4.3.2 数据持久化

通过挂载Docker卷或本地目录到容器内/archivesspace/data路径，确保档案数据、配置文件及日志持久化存储。

5. 许可证信息

ArchivesSpace基于Educational Community License, version 2.0开源协议发布，允许免费下载、使用和二次开发，详情参见项目根目录下的COPYING文件。

6. 参考资源

• 官方网站：archivesspace.org
• 技术文档：docs.archivesspace.org
• API文档：archivesspace.github.io/archivesspace/api
• 用户帮助中心：ArchivesSpace Help Center（会员专享）
• 问题反馈：Issue Tracker