互联网观察——小鱼的互联网观察

在web中管理 uv 项目

作者：小鱼的互联网观察 发布时间：November 10, 2025 分类：互联网观察

在现代 Python 项目开发中，uv 已经成为一个非常高效、轻量的项目管理工具，它可以帮助开发者快速创建、管理虚拟环境、安装依赖并运行 Python 应用。对于使用宝塔面板（BT 面板）的用户来说，将 uv 项目集成到面板中进行管理，可以让项目运维更便捷、后台运行更稳定。

本文将详细介绍在 宝塔面板最新版本中，如何使用 “其它项目”功能管理 uv 项目。

一、准备工作

安装 uv

首先需要在服务器上安装 uv 工具，如果尚未安装，可以通过以下命令安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装完成后，可以通过：

uv --version

检查 uv 是否安装成功。

创建 uv 项目

以创建一个 FastAPI 项目为例：

cd /www/wwwroot

uv init fastapi_app

cd fastapi_app

uv add fastapi uvicorn

这样就完成了项目创建、虚拟环境初始化以及依赖安装。

二、在宝塔面板中添加 uv 项目

在宝塔面板的最新版本中，可以通过，网站， “其它项目” 功能来管理 uv 项目。具体步骤如下：

1. 打开宝塔面板

进入宝塔面板首页，在左侧导航找到网站， “其它项目” 功能，点击进入。

2. 添加新项目

点击 “添加其它项目” 按钮，会弹出一个表单，需要填写以下信息：

项目名称：自定义一个项目名称，如 fastapi_app

运行目录：填写 uv 项目的根目录，例如：

/www/wwwroot/fastapi_app

程序启动命令：填写 uv 的绝对路径以及运行命令，例如：

/root/.local/bin/uv run uvicorn main:app --host 0.0.0.0 --port 6677

注意：为了保证 后台能够正确运行 uv，必须使用 uv 的绝对路径，而不是依赖环境变量 PATH。

运行用户：可以选择 root 或服务器上其他有权限访问项目目录的用户。

日志路径：可以设置输出日志文件路径，便于调试和监控：

/www/wwwlogs/fastapi_app.out.log

/www/wwwlogs/fastapi_app.err.log

3. 保存并启动

填写完成后，点击 保存，然后点击 启动，宝塔面板就会通过内置的 Supervisor 自动启动 uv 项目。

三、后台管理与维护

查看状态

在“其它项目”列表中，可以查看 uv 项目的运行状态，包括：

是否正在运行

启动时间

日志文件位置

自动重启

宝塔面板使用 Supervisor 管理进程，因此项目会在异常退出时自动重启，确保服务稳定。

更新依赖

如果需要给 uv 项目添加新依赖，可以通过 SSH 或宝塔终端进入项目目录：

cd /www/wwwroot/fastapi_app

uv add <package_name>

uv sync

然后通过宝塔面板重启项目，使新依赖生效。

四、注意事项

绝对路径必填：uv 命令必须填写绝对路径，否则宝塔无法在后台找到 uv

虚拟环境依赖：使用 uv 创建的 .venv 虚拟环境，因此确保项目依赖已安装

Python 版本：在 uv 项目创建时，可以指定 Python 版本，确保与项目代码兼容

日志管理：建议将日志路径设置在 /www/wwwlogs，方便统一管理

五、总结

通过宝塔面板的 “其它项目” 功能，可以轻松管理 uv 项目，实现：

后台稳定运行

自动重启

日志集中管理

无需手动激活虚拟环境

这种方式不仅适合 FastAPI 项目，也适用于其他 Python web 框架，如 Django 或 Flask。结合 uv 的依赖管理和宝塔的后台运维功能，Python 项目在生产环境中管理起来更加便捷、安全、高效。

标签: none

互联网观察
在web中管理 uv 项目
本文地址：https://tianmeng.org/archives/526/

相关文章

• 无相关文章