Linux中如何安装和配置ArangoDB

发布时间：2022-02-16 10:20:45 作者：iii
来源：亿速云阅读：419

# Linux中如何安装和配置ArangoDB

## 目录
- [ArangoDB简介](#arangodb简介)
- [安装前的准备](#安装前的准备)
- [安装ArangoDB](#安装arangodb)
  - [方法一：使用官方仓库安装](#方法一使用官方仓库安装)
  - [方法二：通过Deb/RPM包安装](#方法二通过debrpm包安装)
  - [方法三：从源码编译安装](#方法三从源码编译安装)
- [基本配置](#基本配置)
  - [核心配置文件](#核心配置文件)
  - [网络与端口配置](#网络与端口配置)
  - [存储引擎选择](#存储引擎选择)
- [用户管理与安全](#用户管理与安全)
- [服务管理](#服务管理)
- [测试连接](#测试连接)
- [性能优化建议](#性能优化建议)
- [常见问题排查](#常见问题排查)
- [总结](#总结)

## ArangoDB简介
ArangoDB是一个开源的**原生多模型数据库**，支持文档（Document）、键值（Key-Value）和图（Graph）数据模型。其特点包括：
- 单一查询语言AQL（ArangoDB Query Language）
- 水平扩展能力
- 内置Foxx微服务框架
- 支持ACID事务

## 安装前的准备
### 系统要求
- **操作系统**：Ubuntu 20.04+/CentOS 7+/Debian 10+
- **内存**：至少4GB（生产环境建议8GB+）
- **磁盘空间**：SSD硬盘，至少10GB可用空间

### 依赖检查
```bash
# 检查glibc版本
ldd --version

# 检查系统架构
uname -m

安装ArangoDB

方法一：使用官方仓库安装

Ubuntu/Debian

# 导入GPG密钥
wget https://download.arangodb.com/arangodb37/DEBIAN/Release.key
sudo apt-key add Release.key

# 添加仓库
echo "deb https://download.arangodb.com/arangodb37/DEBIAN/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/arangodb.list

# 安装
sudo apt update
sudo apt install arangodb3

CentOS/RHEL

# 添加仓库
cat <<EOF | sudo tee /etc/yum.repos.d/arangodb.repo
[arangodb]
name=ArangoDB
baseurl=https://download.arangodb.com/arangodb37/RPM/$(rpm --eval '%{?dist:el%{dist}}%{!?dist:el7}')/
gpgcheck=1
gpgkey=https://download.arangodb.com/arangodb37/RPM/Release.key
enabled=1
EOF

# 安装
sudo yum install arangodb3-3.7.16

方法二：通过Deb/RPM包安装

从官方下载页面获取对应版本的包
手动安装： “`bash

Debian系

sudo dpkg -i arangodb3-3.7.16-1_amd64.deb

# RHEL系 sudo rpm -ivh arangodb3-3.7.16-1.x86_64.rpm


### 方法三：从源码编译安装
```bash
# 安装依赖
sudo apt install -y git cmake make g++ libssl-dev python3

# 克隆源码
git clone https://github.com/arangodb/arangodb.git
cd arangodb

# 编译
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j4

# 安装
sudo make install

基本配置

核心配置文件

主配置文件通常位于： - /etc/arangodb3/arangod.conf（服务端） - /etc/arangodb3/arangosh.conf（客户端）

网络与端口配置

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

[cluster]
disabled = true  # 单机模式关闭集群功能

存储引擎选择

[rocksdb]
enabled = true  # 推荐生产环境使用

[mmfiles]
enabled = false

用户管理与安全

初始化root密码

sudo arango-secure-installation

交互式设置root密码和其他安全选项。

创建普通用户

通过ArangoShell：

require("@arangodb/users").save("myuser", "mypassword");
require("@arangodb/users").grantDatabase("myuser", "mydb");

服务管理

启动/停止服务

# Systemd方式
sudo systemctl start arangodb3
sudo systemctl enable arangodb3

# 检查状态
sudo systemctl status arangodb3

日志查看

journalctl -u arangodb3 -f  # 实时日志
tail -f /var/log/arangodb3/arangod.log

测试连接

使用ArangoShell

arangosh --server.username root --server.password yourpassword

执行测试命令：

db._version();  // 查看版本
db._createDatabase("testdb");  // 创建测试数据库

HTTP API测试

curl -X GET --user 'root:yourpassword' \
  "http://127.0.0.1:8529/_api/version"

性能优化建议

内存配置：
```
[cache]
size = 268435456  # 256MB
```
线程池调优：
```
[server]
threads = 16
```
禁用不需要的功能：
```
[javascript]
startup-directory = ""
```

常见问题排查

端口冲突

错误现象：

E10002: Cannot bind to endpoint 'tcp://0.0.0.0:8529'

解决方案：

sudo netstat -tulnp | grep 8529
sudo kill <PID>  # 终止占用进程

认证失败

检查： 1. 确认authentication=true 2. 验证密码是否包含特殊字符（建议用引号包裹） 3. 检查/etc/arangodb3/arangod.conf权限应为640

总结

本文详细介绍了在Linux系统中安装和配置ArangoDB的三种方法，并提供了关键配置项的说明。建议生产环境中： 1. 使用官方仓库安装保证版本更新 2. 启用RocksDB存储引擎 3. 配置适当的缓存大小 4. 定期备份数据

通过合理的配置，ArangoDB可以高效处理复杂的数据关系，适用于现代应用开发场景。

注意：本文基于ArangoDB 3.7版本编写，其他版本可能略有差异。建议参考官方文档获取最新信息。 “`

这篇文章包含： 1. 多种安装方法对比 2. 关键配置项详解 3. 安全设置指导 4. 性能优化建议 5. 故障排查技巧 6. 格式化的命令和配置示例

总字数约2200字，采用Markdown格式，包含代码块、列表、标题层级等标准元素，可直接用于技术文档发布。