需先安装miniconda构建隔离python环境,再创建superset专用环境并安装apache-superset,最后初始化数据库、创建管理员账户并启动服务。

在统信UOS系统中部署Superset可视化平台,需先构建Python隔离环境再安装核心服务,避免与系统Python冲突导致后续升级失败或权限异常。
安装Miniconda并配置基础环境
统信UOS桌面版默认不带conda工具链,必须手动安装Miniconda以创建独立Python环境。直接使用系统Python pip install superset会导致依赖混乱和权限错误。
下载Miniconda3安装脚本到/home目录:
curl -o /home/miniconda.sh https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
赋予执行权限并静默安装到/opt/miniconda3:
chmod +x /home/miniconda.sh && sudo bash /home/miniconda.sh -b -p /opt/miniconda3
初始化conda并禁用base自动激活——这一步【必须执行】,否则每次终端启动都会污染全局PATH,干扰UOS系统工具调用:
sudo /opt/miniconda3/bin/conda init bash && conda config --set auto_activate_base false
重启终端或执行source ~/.bashrc使配置生效。
创建Superset专用Python环境
Superset官方要求Python 3.8–3.11,UOS自带Python 3.9可直接复用,但为避免与系统包冲突,仍需新建隔离环境。
方法一:使用conda创建3.9环境
conda create -n superset python=3.9 -y
方法二:若conda不可用,改用venv(需先确认python3-venv已安装):
sudo apt install python3-venv -y && python3 -m venv /opt/superset-env
Miniconda py314_26.5.3-2 Linux x86_64 安装脚本,来自 Anaconda 官方 Miniconda 下载目录,适合服务器、工作站和容器环境配置轻量 Conda 与 Python。
激活环境:
conda activate superset
安装Superset及其系统依赖
UOS基于Debian,需提前安装编译类依赖,否则cryptography等关键包会编译失败:
sudo apt update && sudo apt install -y build-essential libssl-dev libffi-dev python3-dev libsasl2-dev libldap2-dev
升级pip并安装Superset:
pip install --upgrade pip && pip install apache-superset
初始化数据库并创建管理员账户——该操作会生成本地SQLite元数据文件,【路径不可写入/tmp目录】,否则服务启动时因权限拒绝而崩溃:
export SUPERSET_HOME=/opt/superset-data && superset db upgrade && fabmanager create-admin --app superset
启动Superset服务
第一步:初始化角色与权限体系
superset init
第二步:启动Web服务,默认监听localhost:8088
superset run -p 8088 --with-threads --reload --debugger
第三步:在浏览器中访问http://127.0.0.1:8088,使用上一步创建的用户名密码登录。










