Ubuntu WSL环境安装Aerospike后启动失败、连接报错问题咨询

问题根因 #

• aql连接失败是因为Aerospike服务未正常运行
• systemctl报错是默认WSL版本未启用systemd init系统
• service命令识别不到服务是因为仅解压了Aerospike安装包，未执行安装脚本将服务注册到系统中

分步解决步骤 #

第一步：完成Aerospike服务安装 #

你当前仅解压了tgz安装包，未完成系统级安装，先进入解压后的目录执行官方安装脚本：

cd /aerospike-server-community-5.7.0.8-ubuntu20.04
sudo ./asinstall

执行完成后Aerospike的配置文件、服务注册脚本都会被部署到系统对应路径，service命令即可正常识别服务。

第二步：启动Aerospike服务（二选一即可） #

方案1：前台临时启动（适合快速测试）

不需要修改WSL配置，直接运行Aerospike二进制文件启动服务：

sudo asd --config-file /etc/aerospike/aerospike.conf

启动后保持当前终端不关闭，新开一个WSL终端执行aql即可正常连接。

方案2：启用WSL systemd支持（适合长期使用）

如果需要用systemctl/service后台管理服务，先开启WSL的systemd支持：

1. 编辑WSL全局配置文件：

sudo nano /etc/wsl.conf

2. 写入以下配置内容：

[boot]
systemd=true

3. 保存退出后，在Windows的CMD/PowerShell执行命令重启WSL：

wsl --shutdown

4. 重新打开Ubuntu WSL，即可正常使用systemctl管理服务：

# 启动服务
sudo systemctl start aerospike
# 可选：设置开机自启
sudo systemctl enable aerospike

第三步：验证功能 #

服务启动成功后执行aql，能正常进入Aerospike交互命令行即为配置成功。

额外使用要求 #

• 确保WSL内部防火墙和Windows防火墙没有拦截Aerospike默认端口：3000、3001、3002、3003
• 如果需要从Windows系统访问WSL内的Aerospike，需要修改/etc/aerospike/aerospike.conf，将service配置段的address参数改为0.0.0.0，重启服务后生效

内容的提问来源于stack exchange，提问作者Nupur