ArangoDB Docker 镜像文档

镜像概述和主要用途

ArangoDB 是一个可扩展的图数据库系统，旨在从连接数据中更快地获取价值。它原生支持图存储、集成搜索引擎和 JSON 文档，通过单一查询语言实现多模型数据管理。ArangoDB 可在本地环境、云环境中运行，也可作为托管云服务 ArangoGraph Insights Platform 提供。

官方网站: arangodb.com

!logo

核心功能和特性

原生图存储（Native Graph）

同时存储数据和关系，即使在多级别连接和深度查询场景下也能提供更快的查询性能，支持传统关系型和文档数据库无法实现的深度洞察。

文档存储（Document Store）

图中的每个节点都是 JSON 文档，具有灵活性、可扩展性，可轻松从现有文档数据库导入数据。

ArangoSearch

原生集成的跨平台索引、文本搜索和排序引擎，针对信息检索优化，兼顾速度和内存效率。

相关文档

• 学*** ArangoDB
• 官方文档

支持的标签和架构

支持的标签及对应 Dockerfile 链接

• 3.12, 3.12.5.2, latest

支持的架构

• amd64 (详情)
• arm64v8 (详情)

使用场景和适用范围

ArangoDB 适用于需要处理连接数据、实现高效图查询及多模型数据管理的场景，包括：

• 社交网络分析：用户关系、互动行为建模与查询
• 推荐系统：基于用户兴趣和关系的个性化推荐
• 知识图谱：实体关系存储与复杂关联查询
• 欺诈检测：识别异常交易模式和关联欺诈行为
• 日志与文本分析：结合文档存储和全文搜索的日志数据处理
• 物联网数据管理：设备关系与状态数据的灵活存储和查询

详细使用方法和配置说明

启动 ArangoDB 实例

基本启动命令

运行以下命令启动一个 ArangoDB 实例：

docker run -d -p 8529:8529 -e ARANGO_RANDOM_ROOT_PASSWORD=1 --name arangodb-instance amd64/arangodb

指定架构

Docker 默认根据主机 CPU 选择匹配的镜像架构。如需手动指定，可通过 --platform 参数：

• x86-64 架构：linux/amd64
• ARM 架构（如 Apple 芯片，需无 AVX 指令集模拟）：linux/arm64/v8

示例（ARM 架构）：

docker run -d -p 8529:8529 -e ARANGO_RANDOM_ROOT_PASSWORD=1 --name arangodb-instance --platform linux/arm64/v8 amd64/arangodb

初始化服务器语言

首次启动时需指定服务器语言，支持两种方式：

1. 环境变量 LANG
   通过 -e 参数设置，例如瑞典语：

   docker run -d -p 8529:8529 -e ARANGO_RANDOM_ROOT_PASSWORD=1 -e LANG=sv --name arangodb-instance amd64/arangodb
   

2. 挂载配置文件
   创建包含 icu-language = sv（瑞典语）的 arangod.conf 文件，挂载到容器默认配置路径：

   docker run -d -p 8529:8529 -e ARANGO_RANDOM_ROOT_PASSWORD=1 -v /本地路径/arangod.conf:/etc/arangodb3/arangod.conf --name arangodb-instance amd64/arangodb
   

默认语言：ArangoDB v3.11 及更早版本默认 en_US，v3.12 及以上默认 en_US_POSIX。

暴露端口到外部

ArangoDB 默认监听端口 8529，镜像已包含 EXPOSE 8529。通过 -p 8529:8529 将端口暴露到主机：

docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 -p 8529:8529 -d amd64/arangodb

选择认证方式

通过环境变量（-e）指定认证方式，支持以下三种：

1. 随机生成 root 密码

docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 amd64/arangodb

密码会打印到标准输出，可通过 docker logs <容器名> 查看。

2. 禁用认证（仅测试用）

docker run -e ARANGO_NO_AUTH=1 amd64/arangodb

警告：生产环境禁用认证会暴露所有数据，确保 ArangoDB 不直接暴露在公网！

3. 指定自定义 root 密码

docker run -e ARANGO_ROOT_PASSWORD=your_password amd64/arangodb

注意：以上认证方式仅适用于单服务器部署。集群环境需在系统启动后通过空密码 root 用户手动配置用户。

命令行选项

传递参数给 ArangoDB 服务器

在 docker run 命令末尾追加参数，例如查看帮助：

docker run -e ARANGO_RANDOM_ROOT_PASSWORD=1 amd64/arangodb --help

运行其他工具（如 ArangoShell）

直接指定工具名称作为命令：

docker run -it amd64/arangodb arangosh --server.database myDB

在运行中的容器内执行命令

1. 获取容器 ID/名称：

   docker ps
   

2. 通过 docker exec 执行命令（如 ArangoShell）：

   docker exec -it <容器名/ID> arangosh
   

资源使用限制

通过环境变量限制内存和 CPU 使用：

内存限制

ARANGODB_OVERRIDE_DETECTED_TOTAL_MEMORY：覆盖系统自动检测的总内存，支持单位 G（2^30）、M（2^20）、K（2^10）。
示例（限制为 64GB）：

docker run -e ARANGODB_OVERRIDE_DETECTED_TOTAL_MEMORY=64G amd64/arangodb

CPU 核心限制

ARANGODB_OVERRIDE_DETECTED_NUMBER_OF_CORES：覆盖系统自动检测的 CPU 核心数。
示例（限制为 4 核）：

docker run -e ARANGODB_OVERRIDE_DETECTED_NUMBER_OF_CORES=4 amd64/arangodb

持久化数据

存储引擎选择

• RocksDB：v3.4 及以上默认，基于 RocksDB 的存储引擎（v3.7 及以上唯一支持）。
• MMFiles：传统存储引擎（v3.7 及以上不可用）。

通过环境变量 ARANGO_STORAGE_ENGINE 指定（如 mmfiles 或 rocksdb）：

docker run -e ARANGO_STORAGE_ENGINE=rocksdb amd64/arangodb

数据存储路径

容器内默认卷路径：

• 数据库目录：/var/lib/arangodb3
• 应用扩展目录：/var/lib/arangodb3-apps

查看所有卷：

docker inspect --format "{{ .Config.Volumes }}" amd64/arangodb

持久化方法

1. 使用主机目录挂载

将容器卷映射到主机目录（示例路径 /tmp/arangodb，生产环境需替换为持久路径）：

mkdir /tmp/arangodb
docker run -d -p 8529:8529 -e ARANGO_RANDOM_ROOT_PASSWORD=1 \
  -v /tmp/arangodb:/var/lib/arangodb3 \
  amd64/arangodb

2. 使用数据容器

创建专用数据容器：

docker create --name arangodb-persist amd64/arangodb true

使用数据容器启动 ArangoDB：

docker run -d -p 8529:8529 -e ARANGO_RANDOM_ROOT_PASSWORD=1 \
  --volumes-from arangodb-persist \
  amd64/arangodb

轻量级数据容器可使用 busybox 或 alpine，需显式指定卷路径：

docker run -d --name arangodb-persist -v /var/lib/arangodb3 busybox true

作为基础镜像使用

• CMD 格式：需使用 exec 形式包装 CMD，确保入口脚本正常执行引导逻辑。
• 初始化脚本：在 /docker-entrypoint-initdb.d/ 目录中放置初始化文件：
  • *.sh：Bash 脚本，会自动执行。
  • *.js：ArangoShell 脚本，可通过 ARANGOSH_ARGS 环境变量指定额外参数。
  • dumps/：存放 arangodump 生成的备份，启动时自动通过 arangorestore 恢复。

许可证信息

ArangoDB 社区版许可

• 受 ArangoDB 社区许可证 约束，生产环境数据集大小限制为 100GB，禁止用于商业目的（仅允许内部业务用途）。
• 禁止分发、嵌入其他产品或与 ArangoDB 企业版结合使用。

源代码许可（BUSL-1.1）

• 社区版源代码采用 Business Source License 1.1 (BUSL-1.1)：
  • 允许复制、修改、再分发、非商业使用及非生产环境商业使用。
  • 自特定版本首次公开分发起满四年后，许可证自动转换为 Apache 2.0。
• v3.11 及更早版本采用 Apache 2.0 许可证。

第三方软件许可

ArangoDB 包含第三方软件，其许可信息见 LICENSES-OTHER-COMPONENTS.md。

镜像使用责任

使用本镜像需确保符合所有包含软件的许可条款，详细许可信息可参考 repo-info 仓库的 arangodb 目录。

维护者：ArangoDB
问题反馈：GitHub Issues
获取帮助：Docker Community Slack、Server Fault、Unix & Linux、Stack Overflow