# pve-pci-fixer

**Repository Path**: JeffStudio/pve-pci-fixer

## Basic Information

- **Project Name**: pve-pci-fixer
- **Description**: No description available
- **Primary Language**: Rust
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PvePciFixer 🚀

[English](./README_EN.md) | 中文说明

**作者：一坨肉 (yiTuoRou)**

这是一个为 PVE (Proxmox VE) 用户设计的自动化工具，专门解决由于增加/减少硬件（如 OCulink 设备、外置显卡、NVMe 硬盘）导致的 PCI 地址（BDF）变动，从而引起虚拟机无法启动或直通失效的问题。

### 核心功能
- ✅ **自动追踪**：基于设备名称关键字识别硬件，彻底告变 BDF 地址漂移困扰。
- ✅ **Web 界面**：响应式管理后台，傻瓜式点选虚拟机与硬件，一键完成绑定。
- ✅ **开机自愈**：集成 Systemd 服务，宿主机开机瞬间自动对齐所有 VM 配置。
- ✅ **规范化补全**：自动处理 `0000:` 前缀，严格遵循 Proxmox PCI 分配规范。
- ✅ **轻量安全**：Rust 编写，单文件运行，不修改系统底层，仅修正 `.conf` 文本。

### 快速安装 (推荐)
在 PVE 终端执行以下命令，即可全自动完成下载、安装、配置服务及开机自启：
```bash
 curl -sSL https://gitee.com/JeffStudio/pve-pci-fixer/raw/master/install.sh | bash