Ajenti服务器管理面板安装与卸载指南

姚月梅Lane

于 2025-06-05 09:15:36 发布

阅读量373

点赞数 4

本文链接：https://blog.youkuaiyun.com/gitblog_00242/article/details/148443178

版权

Ajenti服务器管理面板安装与卸载指南

ajenti Ajenti Core and stock plugins 项目地址: https://gitcode.com/gh_mirrors/aj/ajenti

前言

Ajenti是一款功能强大的服务器管理面板，它提供了一个直观的Web界面来管理Linux服务器。与传统的命令行管理方式相比，Ajenti大大降低了服务器管理的门槛，特别适合不熟悉命令行的用户或需要快速管理多台服务器的场景。

系统要求

在开始安装前，请确保您的系统满足以下要求：

官方支持的操作系统：

Debian 9及以上版本
Ubuntu Bionic(18.04)及以上版本
RHEL 8及以上版本

注意：其他基于Linux的系统可能也能运行，但需要使用手动安装方法，且不保证完全兼容。

安装方法选择

Ajenti提供了三种安装方式，用户可根据自身需求选择：

虚拟环境自动安装（推荐）：适用于新版Debian/Ubuntu系统
系统级自动安装：适用于其他支持的系统
手动安装：适用于高级用户或有特殊需求的场景

虚拟环境自动安装（推荐）

这是目前最推荐的安装方式，特别是在新版Debian(12+)和Ubuntu(24.04+)系统上，可以避免"externally managed environment"的pip错误。

执行以下命令即可完成安装：

curl https://raw.githubusercontent.com/ajenti/ajenti/master/scripts/install-venv.sh | sudo bash -s -

常见问题解决：

登录后空白页面问题：尝试升级gipc和gevent模块：
```
/opt/ajenti/bin/python3 -m pip install gipc gevent -U
```

HTTPS证书缺失问题：运行以下命令生成证书：

/opt/ajenti/bin/python3 /opt/ajenti/bin/ajenti-ssl-gen $(hostname)

系统级自动安装

这种方式会将Ajenti安装在系统级别，适用于除新版Debian/Ubuntu外的其他操作系统。

执行命令：

curl https://raw.githubusercontent.com/ajenti/ajenti/master/scripts/install.sh | sudo bash -s -

手动安装指南

1. 安装系统依赖

Debian/Ubuntu系统：

sudo add-apt-repository universe  # Ubuntu需要启用Universe仓库
sudo apt-get install build-essential python3-pip python3-dev python3-lxml libssl-dev python3-dbus python3-augeas python3-apt ntpdate

RHEL系统：

sudo dnf install epel-release  # 启用EPEL仓库
sudo dnf install -y gcc python3-devel python3-pip python3-pillow python3-augeas python3-dbus chrony openssl-devel redhat-lsb-core

2. 升级pip工具

sudo pip3 install setuptools pip wheel -U

3. 安装Ajenti核心

最小化安装（仅核心功能）：

sudo pip3 install ajenti-panel ajenti.plugin.core ajenti.plugin.dashboard ajenti.plugin.settings ajenti.plugin.plugins

完整安装（包含所有插件）：

sudo pip3 install ajenti-panel ajenti.plugin.ace ajenti.plugin.augeas ajenti.plugin.auth-users ajenti.plugin.core ajenti.plugin.dashboard ajenti.plugin.datetime ajenti.plugin.filemanager ajenti.plugin.filesystem ajenti.plugin.network ajenti.plugin.notepad ajenti.plugin.packages ajenti.plugin.passwd ajenti.plugin.plugins ajenti.plugin.power ajenti.plugin.services ajenti.plugin.settings ajenti.plugin.terminal

卸载Ajenti

Ajenti由多个Python模块组成，卸载时需要移除相关服务、Python模块和配置文件。

1. 停止并移除服务

Systemd系统：

sudo systemctl stop ajenti.service
sudo systemctl disable ajenti.service
sudo systemctl daemon-reload
sudo rm -f /lib/systemd/system/ajenti.service

SysVinit系统：

/etc/init.d/ajenti stop
rm -f /etc/init/ajenti.conf

2. 移除Python模块

首先列出所有Ajenti相关模块：

sudo pip3 list | grep aj

然后卸载所有列出的模块（根据实际列出的模块调整命令）：

sudo pip3 uninstall -y aj ajenti-panel ajenti.plugin.ace ajenti.plugin.auth-users ajenti.plugin.core ajenti.plugin.dashboard ajenti.plugin.filesystem ajenti.plugin.passwd ajenti.plugin.plugins ajenti.plugin.session-list ajenti.plugin.settings