堵赫然
2025-10-22 16:00:09
一、安装 Miniconda
1. 下载 Miniconda 安装脚本
x86_64 架构:- cd ~
- wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
复制代码 ARM 架构(如树莓派或 Apple Silicon 的 Linux 虚拟机):
- wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh
复制代码 2. 运行安装脚本
- bash Miniconda3-latest-Linux-x86_64.sh
复制代码
- 按回车阅读许可协议(可按 q 跳过)。
- 输入 yes 接受协议。
- 安装路径默认为 ~/miniconda3,直接回车即可。
- 是否初始化 conda?输入 yes(这样会自动配置 PATH)。
3. 重新加载 shell 配置
如果你用的是 zsh,则 source ~/.zshrc
验证安装:- conda --version
- python --version
复制代码 4. 配置清华镜像(加速下载)
清华镜像站提供了 Conda 和 pip 的国内加速源。
- 添加 Conda 清华镜像(推荐使用 .condarc 配置文件)
运行以下命令生成配置文件:- conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
- conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
- conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
- conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/ # 可选
- # 设置搜索时显示通道地址
- conda config --set show_channel_urls yes
复制代码注意:不要添加 defaults 通道的清华镜像,因为清华已将 main 和 free 分开。
- (可选)禁用默认的 Anaconda 通道(避免回源)
- conda config --remove channels defaults
复制代码- conda config --show channels
复制代码 你应该看到类似:- channels:
- - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/pytorch/
- - https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/
- - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
- - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
复制代码 二、安装 Xinference
1. 创建并激活 conda 环境
- conda create -n xinference python=3.11 -y
- conda activate xinference
复制代码重点:Python最新版本推荐3.11,不然会有各种报错
- 如果后续用 pip,也可以配置 pip 清华源:
- pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
复制代码 2. 安装 Xinference
首先安装以下依赖非常重要!!(最容易报错,提前解决):- # 从 conda-forge 安装 pynini(自动解决 OpenFST 依赖)
- conda install -c conda-forge pynini
复制代码 可选(通常不需要,可以跳过):先用 conda 安装部分依赖:- # 安装 PyTorch(根据你的 CUDA 版本选择)
- conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia
- # 安装其他可能的依赖(可选)
- conda install -c conda-forge sentencepiece protobuf
复制代码 使用 pip 安装最新版:- pip install "xinference[all]"
复制代码[all] 表示安装所有可选依赖(包括 GPU 支持、多模态模型等)。如果你只需要基础功能,可以只运行 pip install xinference。
可以加上镜像加速,比如:pip install "xinference[all]" -i https://pypi.doubanio.com/simple
3. 验证安装
如果输出帮助信息,说明安装成功。
三、设置 Xinference 开机自启动
1. 创建 systemd 服务文件
- sudo vim /etc/systemd/system/xinference.service
复制代码 粘贴以下内容(请根据你的用户名和路径修改):- [Unit]
- Description=Xinference Service
- After=network.target
- [Service]
- Type=simple
- User=你的实际用户名
- Group=你的实际用户名
- WorkingDirectory=/home/你的实际用户名
- ExecStart=/bin/bash -c 'source /home/你的实际用户名/miniconda3/etc/profile.d/conda.sh && conda activate xin_env && xinference-local --host 0.0.0.0 --port 9997'
- Restart=always
- RestartSec=10
- [Install]
- WantedBy=multi-user.target
复制代码说明:
- --host 0.0.0.0 允许外部访问(如需仅本地访问,改为 127.0.0.1)。
- --port 9997 是默认端口,可按需修改。
- 确保路径 /home/你的实际用户名/miniconda3/envs/xinference/bin/xinference-local 存在。可通过 which xinference-local 查看实际路径。
2. 重载 systemd 配置
- sudo systemctl daemon-reexec
- sudo systemctl daemon-reload
复制代码 3. 启用并启动服务
- sudo systemctl enable xinference.service # 开机自启
- sudo systemctl start xinference.service # 立即启动
复制代码 4. 检查服务状态
- sudo systemctl status xinference.service
复制代码 如果看到 active (running),说明服务已正常运行。
5. 查看日志(排错用)
- journalctl -u xinference.service -f
复制代码 四、访问 Xinference Web UI
默认情况下,Xinference 会启动一个 Web 管理界面。
在浏览器中访问:例如:http://192.168.1.100:9997
五、可选:配置防火墙(如启用)
如果你使用的是 ufw:如果是云服务器(如 AWS、阿里云),记得在安全组中开放 9997 端口。
六、常见问题
Q1: 启动失败,提示找不到命令?
- 检查 ExecStart 路径是否正确,使用 which xinference-local 确认。
- 确保 conda 环境已正确创建并安装了 xinference。
Q2: 如何停止服务?
- sudo systemctl stop xinference.service
复制代码 Q3: 如何更新 Xinference?
- conda activate xinference
- pip install --upgrade xinference
- sudo systemctl restart xinference.service
复制代码 Q4: 报错信息:
- error: command 'g++' failed: No such file or directory
- ...
- error: command 'gcc' failed: No such file or directory
复制代码 这两个包(pyworld 和 cdifflib)都包含 C/C++ 扩展,需要本地编译。
解决方法:
Ubuntu/Debian:
- sudo apt update && sudo apt install build-essential
复制代码 CentOS/RHEL/Fedora:
- CentOS/RHEL:
- sudo yum groupinstall "Development Tools"
复制代码 - Fedora:
- sudo dnf groupinstall "Development Tools"
复制代码 使用的是 Conda 环境 也可以尝试安装编译器:
- conda install -c conda-forge gcc gxx_linux-64
复制代码注意:有些 Conda 环境仍依赖系统级编译器,建议优先用系统包管理器安装 build-essential。
总结
- 安装 Miniconda → 提供 Python 环境管理。
- 创建 conda 环境并安装 Xinference。
- 使用 systemd 创建开机自启服务。
- 访问 Web UI 管理模型。
按照以上步骤,你就可以在 Linux 上稳定运行 Xinference 并实现自动启动。
提示:部署具体模型,可通过 Web UI 或命令行加载。
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |
|
|
|
|
|
相关推荐
|
|
|