ArangoDB安装与配置 #

一、安装方式概览 #

平台 安装方式 推荐度
Docker 官方镜像 ⭐⭐⭐⭐⭐
Linux 包管理器 ⭐⭐⭐⭐
macOS Homebrew ⭐⭐⭐⭐
Windows 安装包 ⭐⭐⭐

二、Docker安装（推荐） #

2.1 快速启动 #

bash 
docker run -d \
  --name arangodb \
  -p 8529:8529 \
  -e ARANGO_ROOT_PASSWORD=openSesame \
  arangodb/arangodb:3.12

2.2 数据持久化 #

bash 
docker run -d \
  --name arangodb \
  -p 8529:8529 \
  -e ARANGO_ROOT_PASSWORD=openSesame \
  -v $(pwd)/arangodb-data:/var/lib/arangodb3 \
  -v $(pwd)/arangodb-apps:/var/lib/arangodb3-apps \
  arangodb/arangodb:3.12

2.3 Docker Compose配置 #

yaml 
version: '3.8'

services:
  arangodb:
    image: arangodb/arangodb:3.12
    container_name: arangodb
    environment:
      - ARANGO_ROOT_PASSWORD=openSesame
    ports:
      - "8529:8529"
    volumes:
      - ./data:/var/lib/arangodb3
      - ./apps:/var/lib/arangodb3-apps
    restart: unless-stopped

启动服务：

bash 
docker-compose up -d

三、Linux安装 #

3.1 Ubuntu/Debian #

bash 
curl -OL https://download.arangodb.com/arangodb312/DEBIAN/Release.key
sudo apt-key add - < Release.key
echo 'deb https://download.arangodb.com/arangodb312/DEBIAN/ ./' | sudo tee /etc/apt/sources.list.d/arangodb.list
sudo apt-get update
sudo apt-get install arangodb3

3.2 CentOS/RHEL #

bash 
curl -OL https://download.arangodb.com/arangodb312/RPM/arangodb.repo
sudo mv arangodb.repo /etc/yum.repos.d/
sudo yum install arangodb3

3.3 启动服务 #

bash 
sudo systemctl start arangodb3
sudo systemctl enable arangodb3
sudo systemctl status arangodb3

四、macOS安装 #

4.1 Homebrew安装 #

bash 
brew install arangodb

4.2 启动服务 #

bash 
brew services start arangodb

4.3 手动启动 #

bash 
/usr/local/opt/arangodb/sbin/arangod

五、Windows安装 #

5.1 下载安装包 #

  1. 访问官网下载页面：https://www.arangodb.com/download
  2. 选择Windows版本下载
  3. 运行安装程序

5.2 安装步骤 #

text 
1. 双击安装包启动安装向导
2. 选择安装目录（默认：C:\Program Files\ArangoDB）
3. 设置root用户密码
4. 选择要安装的组件
5. 配置服务端口（默认：8529）
6. 完成安装

5.3 服务管理 #

powershell 
net start ArangoDB
net stop ArangoDB

六、配置文件 #

6.1 配置文件位置 #

系统 配置文件路径
Linux /etc/arangodb3/arangod.conf
macOS /usr/local/etc/arangodb3/arangod.conf
Windows C:\Program Files\ArangoDB\etc\arangodb3\arangod.conf
Docker /etc/arangodb3/arangod.conf

6.2 常用配置项 #

conf 
[server]
endpoint = tcp://0.0.0.0:8529
authentication = true

[database]
directory = /var/lib/arangodb3

[log]
level = info

[foxx]
queues = true

[javascript]
startup-directory = /usr/share/arangodb3/js

6.3 内存配置 #

conf 
[cache]
size = 25%

[rocksdb]
cache-size = 1073741824

6.4 集群配置 #

conf 
[cluster]
my-address = tcp://192.168.1.100:8529
my-local-info = node1
agency-endpoint = tcp://192.168.1.100:8529
agency-size = 3

七、连接数据库 #

7.1 Web界面（ArangoDB Web UI） #

访问地址：http://localhost:8529

text 
默认用户名：root
默认密码：安装时设置的密码
默认数据库：_system

7.2 命令行工具（arangosh） #

bash 
arangosh --server.username root --server.password openSesame

连接参数：

bash 
arangosh \
  --server.endpoint tcp://192.168.1.100:8529 \
  --server.username root \
  --server.password openSesame \
  --server.database mydb

7.3 常用连接参数 #

参数 说明 默认值
–server.endpoint 服务器地址 tcp://127.0.0.1:8529
–server.username 用户名 root
–server.password 密码 空
–server.database 数据库名 _system

八、验证安装 #

8.1 检查版本 #

bash 
arangod --version

输出示例：

text 
3.12.0 [linux]

8.2 测试连接 #

bash 
arangosh --server.username root --server.password openSesame \
  --javascript.execute-string "print(db._version())"

8.3 创建测试数据 #

aql 
db._create("test");
db.test.save({ name: "test", value: 123 });
db.test.toArray();
db._drop("test");

九、安全配置 #

9.1 修改root密码 #

javascript 
require("@arangodb/users").update("root", "newPassword");

9.2 创建新用户 #

javascript 
require("@arangodb/users").save("newuser", "password", true);

9.3 授权数据库访问 #

javascript 
require("@arangodb/users").grantDatabase("newuser", "mydb", "rw");

9.4 启用SSL #

conf 
[ssl]
keyfile = /path/to/server.pem

十、常见问题 #

10.1 端口被占用 #

bash 
lsof -i :8529
kill -9 <PID>

10.2 权限问题 #

bash 
sudo chown -R arangodb:arangodb /var/lib/arangodb3

10.3 内存不足 #

调整配置文件中的缓存大小：

conf 
[cache]
size = 10%

10.4 连接被拒绝 #

检查防火墙设置：

bash 
sudo ufw allow 8529/tcp

十一、卸载 #

11.1 Linux #

bash 
sudo apt-get remove arangodb3
sudo rm -rf /var/lib/arangodb3

11.2 macOS #

bash 
brew uninstall arangodb
rm -rf /usr/local/var/lib/arangodb3

11.3 Docker #

bash 
docker stop arangodb
docker rm arangodb
docker rmi arangodb/arangodb:3.12

十二、总结 #

安装要点：

  1. 推荐Docker：最简单、最干净的安装方式
  2. 数据持久化：确保数据不会丢失
  3. 安全配置：设置强密码，限制访问
  4. 资源规划：根据数据量配置内存

下一步，让我们学习AQL基础语法！

最后更新：2026-03-27