fanhuadesenlinnn/PVE-Tools-9
1
0
Fork 0
mirror of https://hubproxy.babadafafafafa.cn/https://github.com/Mapleawaa/PVE-Tools-9.git synced 2026-09-20 08:03:35 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: update README files

Browse Source
This commit is contained in:
Maple
2026-07-28 15:00:21 +08:00
parent 14a3c4b355
commit dc55838c88
3 changed files with 31 additions and 186 deletions
Download Patch File Download Diff File Expand all files Collapse all files

79
README-JP.md
View File

@@ -1,79 +0,0 @@
# PVE Tools Pro
<div align="center">
Proxmox VE 9.x 向けのワンストップ運用スクリプトです。VM ライフサイクル管理、ホストネットワーク / ファイアウォール / IPv6、GPU / PCI パススルー、日常保守、サードパーティー連携をまとめて扱えます。
[Docs](https://pve.u3u.icu) | [更新履歴](https://pve.u3u.icu/update) | [FAQ](https://pve.u3u.icu/faq) | [中文](./README.md) | [English](./README_EN.md)
</div>
> [!CAUTION]
> **お知らせ：ただ飯に文句をつけるな**
>
> 本项目は完全無料のオープンソースであり、個人の情熱だけで維持されています。Issue を立てる前や質問する前に、ドキュメント、画面上の注意書き、既存の Issue を必ずお読みください。
> 再現手順やログなどの有効な情報がないフィードバックは直接クローズされます。オープンソースはあなたの召使いではありません。敬意は相互のものです。
>
> **お知らせ（2026-07）：Shell 版はメンテナンスを再開しました。v8.8.8 での更新終了と Go 版への移行計画は撤回されています。経緯は[こちら](https://pve.u3u.icu/blog/why-go-version-is-not-updating/)をご覧ください。**
## 概要
PVE Tools Pro は Proxmox VE 9.x 向けの対話型 Bash ツールです。PVE の標準コマンドを置き換えるのではなく、頻繁に使う運用タスクをまとめ、確認ポイントとリスク警告を強化することを目的としています。
主な機能：
- VM ライフサイクル運用：バックアップ、リストア、設定のエクスポート / インポート、テンプレート、クローン、Cloud-Init、ディスク管理、スナップショット、起動順、クラスタ内移行。
- ホストネットワークとファイアウォール：bridge、Bond、VLAN、IPv4 / IPv6 / SLAAC / DHCP、PVE Firewall、Security Group、IPv6 ヘルパー、診断ツール。
- GPU / PCI パススルー：Intel iGPU、NVIDIA、AMD dGPU、AMD iGPU、RDM、NVMe、コントローラーパススルー。
- 日常保守：ミラー切替、システム更新、PVE 8 -> 9 アップグレード、カーネル管理、GRUB バックアップ、メール通知。
## クイックスタート
```bash
bash <(curl -sSL https://pve.u3u.icu/PVE-Tools.sh)
```
## 注意事項
- このスクリプトはホストネットワーク、ファイアウォール、GRUB、カーネルモジュール、VM 設定に実際の変更を加えます。
- バックアップ / リストア、テンプレート / クローン / Cloud-Init、ディスク、スナップショット、移行は高リスク操作です。必ず検証済みバックアップを用意してください。
- ネットワークやファイアウォールの誤設定は SSH / WebUI 切断を引き起こす可能性があります。
- AMD iGPU パススルーではユーザー自身が ROM / vBIOS を準備する必要があります。
## 公式サイト入口
- ドキュメント: https://pve.u3u.icu
- 機能一覧: https://pve.u3u.icu/features
- 更新履歴: https://pve.u3u.icu/update
- FAQ: https://pve.u3u.icu/faq
- ホストネットワーク / ファイアウォール / IPv6 ガイド: https://pve.u3u.icu/advanced/host-network-firewall-ipv6
- VM バックアップ / 移行 / Cloud-Init ガイド: https://pve.u3u.icu/advanced/vm-backup-migration-cloudinit
## Sponsor
プロジェクトの継続的な保守と改善を支援したい場合はこちらです。
- Sponsor ページ: https://pve.u3u.icu/sponsor
- Afdian: https://afdian.com/a/cyrenenight
## Pay For Services
個別のリモートサポート、緊急復旧、パススルー調整、ネットワーク構築、完全な PVE セットアップが必要な場合はこちらを参照してください。
- 有償サポート: https://pve.u3u.icu/pay
## 他の言語
- 中文: [README.md](./README.md)
- English: [README_EN.md](./README_EN.md)
## 免責事項
このプロジェクトは Proxmox VE ホスト / ゲストに対して実際の変更を加える運用ツールです。検証済みバックアップ、メンテナンス時間、ロールバック計画なしで高リスク操作を実行した場合、管理プレーンの喪失、サービス停止、不可逆なデータ破損を招く可能性があります。データ損失、復旧費用、第三者データ復旧費用は実運用者の責任となります。
ULA 全文: https://pve.u3u.icu/ula
このページでは、スクリプトの適用範囲、リスク境界、利用者が負う操作責任、そしてネットワーク断、設定ミス、データ損傷、サービス停止、復旧費用に関する免責内容を案内しています。バックアップ / リストア、移行、Cloud-Init、ディスク変更、GPU パススルー、ホストネットワークやファイアウォール変更の前に確認してください。
## License
GPL-3.0. See [LICENSE](LICENSE).

58
README.md
View File

@@ -1,8 +1,8 @@
# PVE Tools Pro(原 PVE-Tools-9)
# PVE Tools Pro (原 PVE-Tools-9)
<div align="center">
[官网 / Docs](https://pve.u3u.icu) | [更新日志](https://pve.u3u.icu/update) | [FAQ](https://pve.u3u.icu/faq) | [English](./README_EN.md) | [日本語](./README-JP.md)
[官网 / Docs](https://pve.u3u.icu) | [更新日志](https://pve.u3u.icu/update) | [FAQ](https://pve.u3u.icu/faq)
[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0.html)
[![Shell Script](https://img.shields.io/badge/Shell-Script-4EAA25?logo=gnu-bash&logoColor=white)](https://www.gnu.org/software/bash/)
@@ -13,28 +13,6 @@
</div>
>[!CAUTION]
> **Shell版本恢复更新公告**
>
> 经过一个比较混乱的调整，我决定恢复更新 Shell 版本。
>
> 该版本将继续维护，后续会根据用户反馈和需求进行更新。
>
> 如果想了解为何辗转两次，可以在这里了解详细: [为什么Go版本憋不出来?](https://pve.u3u.icu/blog/why-go-version-is-not-updating/)
<!-- > [!CAUTION]
> **Shell版本停更公告**
>
> 感谢大家一直以来对 PVE-Tools-9 的支持。随着项目功能的不断增加，目前的 Shell 脚本代码量已突破 13000 行。
>
> 受限于 Shell 语言本身的特性，继续在此基础上增加新功能或进行大规模修改，已经变得难以维护且容易引发不可预知的 Bug。
>
> 因此，我决定暂缓当前 Shell 版本的新功能开发（但不会EOL），仅做极其重大的致命 Bug 修复。该仓库将保持原样，不会删库，大家依然可以正常使用现有功能。
>
> `main` 分支（Shell 版本）发布 v8.8.8 后将停止更新，后续正式版本推出后将切到主main分支。
> 我目前已经开启了底层基于 Go 语言 的全新版本重构计划，后续维护将迁移至 Go 重构版本（[beta-go](https://github.com/PVE-Tools/PVE-Tools-9/tree/beta-go) 分支），Go 版本将继续免费开源,新版本将带来更好的稳定性、更友好的交互以及更严谨的环境校验，敬请期待。 -->
## 快速开始
### 使用前请先注意
@@ -68,6 +46,18 @@ wget https://raw.githubusercontent.com/PVE-Tools/PVE-Tools-9/main/PVE-Tools.sh
chmod +x PVE-Tools.sh
sudo ./PVE-Tools.sh
```
---
>[!CAUTION]
> **Shell 版本恢复更新公告**
>
> 经过一段比较混乱的调整期，我决定恢复更新 Shell 版本。该版本将继续维护，后续会根据用户反馈和需求进行更新。
>
> 如果想了解为何辗转两次，可以在这里了解详细：[为什么 Go 版本憋不出来？](https://pve.u3u.icu/blog/why-go-version-is-not-updating/)
---
## 项目定位
PVE Tools Pro 是一个面向 Proxmox VE 9.x 的交互式 Bash 工具。
@@ -81,6 +71,8 @@ PVE Tools Pro 是一个面向 Proxmox VE 9.x 的交互式 Bash 工具。
| 系统维护 | 换源、系统更新、PVE 8 → 9 升级、内核管理、GRUB 备份恢复、邮件通知、温控与基于 NUT 的 UPS 辅助能力 |
| 第三方生态 | FastPVE、Modules、Community Scripts |
---
## 官网入口
- 官方文档：https://pve.u3u.icu
@@ -91,9 +83,13 @@ PVE Tools Pro 是一个面向 Proxmox VE 9.x 的交互式 Bash 工具。
- 宿主机网络 / 防火墙 / IPv6 专题：https://pve.u3u.icu/advanced/host-network-firewall-ipv6
- VM 备份 / 迁移 / Cloud-Init 专题：https://pve.u3u.icu/advanced/vm-backup-migration-cloudinit
## Sponsor
---
如果这个项目帮你节省了时间、避开了误操作，或者单纯想支持后续维护与继续更新，可以通过以下页面赞助：
## 支持项目
### 无偿赞助
如果这个项目帮你节省了时间、避开了误操作，或者单纯想支持后续维护与继续更新，可以通过以下渠道赞助：
- Sponsor 页面：https://pve.u3u.icu/sponsor
- 爱发电：https://afdian.com/a/cyrenenight
@@ -101,7 +97,7 @@ PVE Tools Pro 是一个面向 Proxmox VE 9.x 的交互式 Bash 工具。
赞助是对项目本身的支持，不等同于一对一技术服务。
## Pay For Services
### 付费技术支持
如果你需要一对一远程协助、紧急救砖、网络配置、直通问题排查或完整代配，可以直接查看官方付费支持说明：
@@ -109,11 +105,15 @@ PVE Tools Pro 是一个面向 Proxmox VE 9.x 的交互式 Bash 工具。
这里购买的是时间与交付结果，不是单纯赞助。
---
## 其它语言
- English: [README_EN.md](./README_EN.md)
- 日本語: [README-JP.md](./README-JP.md)
---
## 免责声明
这是一个会真实调用 PVE 原生命令并修改宿主机 / VM 配置的运维工具。如果你在没有经过验证的备份、没有维护窗口、没有明确回滚方案的前提下执行高风险动作，可能导致管理面失联、业务中断、配置损坏或不可逆的数据损失。所有数据损失、恢复成本与第三方恢复费用均由实际操作人自行承担。
@@ -122,6 +122,8 @@ PVE Tools Pro 是一个面向 Proxmox VE 9.x 的交互式 Bash 工具。
该页面主要说明脚本的适用范围、风险边界、用户自担的操作责任，以及对网络中断、配置错误、数据损坏、业务不可用和衍生恢复成本的免责声明。
执行备份恢复、迁移、Cloud-Init、磁盘调整、GPU 直通、宿主机网络或防火墙变更前，建议先完整阅读。
---
## Community
- 官网：https://pve.u3u.icu
@@ -130,6 +132,8 @@ PVE Tools Pro 是一个面向 Proxmox VE 9.x 的交互式 Bash 工具。
- Telegram 群：https://t.me/pvetools233
- Sponsor：https://pve.u3u.icu/sponsor
---
## License
GPL-3.0. See [LICENSE](LICENSE).

80
README_EN.md
View File

@@ -1,80 +0,0 @@
# PVE Tools Pro
<div align="center">
An all-in-one operations script for Proxmox VE 9.x, covering VM lifecycle workflows, host networking / firewall / IPv6, GPU / PCI passthrough, day-to-day maintenance, and third-party integrations.
[Docs](https://pve.u3u.icu) | [Changelog](https://pve.u3u.icu/update) | [FAQ](https://pve.u3u.icu/faq) | [中文](./README.md) | [日本語](./README-JP.md)
</div>
> [!CAUTION]
> **Announcement: Don't bite the hand that feeds you.**
>
> This project is free and open source, maintained solely by personal passion. Before opening an issue or asking a question, please make sure you have read the documentation, on-screen notices, and existing issues thoroughly.
> Feedback without reproduction steps, logs, or other useful information will be closed directly. Open source does not make anyone your servant. Respect is a two-way street.
>
> **Update (2026-07): the Shell version has resumed active maintenance. The earlier plan to freeze `main` after v8.8.8 and migrate to a Go rewrite has been withdrawn — see [why the Go version stalled](https://pve.u3u.icu/blog/why-go-version-is-not-updating/).**
## Overview
PVE Tools Pro is an interactive Bash toolkit for Proxmox VE 9.x. It does not try to replace native PVE commands. Instead, it wraps high-frequency and error-prone operational workflows with clearer menus, stronger validation, and more explicit risk warnings.
Key capabilities:
- VM lifecycle workflows: backup, restore, config export / import, templates, cloning, Cloud-Init, disk management, snapshots, startup order, guest networking, and in-cluster migration.
- Host networking and firewall: bridge, Bond, VLAN, IPv4 / IPv6 / SLAAC / DHCP, PVE firewall, security groups, IPv6 helper, and network diagnostics.
- GPU / PCI passthrough: Intel iGPU virtualization and passthrough, NVIDIA GPU management, AMD dGPU passthrough, AMD iGPU passthrough, RDM, NVMe, and controller passthrough.
- System maintenance: mirror switching, updates, PVE 8 -> 9 upgrade, kernel management, GRUB backup / restore, mail notifications, and hardware monitoring helpers.
## Quick Start
```bash
bash <(curl -sSL https://pve.u3u.icu/PVE-Tools.sh)
```
## Safety Notes
- The script performs real changes to host networking, firewall rules, GRUB, module loading, VM config, and data-plane objects.
- Backup / restore, template / clone / Cloud-Init, disk, snapshot, and migration workflows are high-risk operations. Always verify backups first.
- Misconfigured host networking or firewall rules may immediately break SSH, WebUI, or production traffic.
- AMD iGPU passthrough usually requires a user-supplied ROM / vBIOS. The script validates and writes `romfile`, but does not extract the ROM for you.
## Website Links
- Documentation: https://pve.u3u.icu
- Features: https://pve.u3u.icu/features
- Changelog: https://pve.u3u.icu/update
- FAQ: https://pve.u3u.icu/faq
- Host network / firewall / IPv6 guide: https://pve.u3u.icu/advanced/host-network-firewall-ipv6
- VM backup / migration / Cloud-Init guide: https://pve.u3u.icu/advanced/vm-backup-migration-cloudinit
## Sponsor
If this project saves you time or helps you avoid costly mistakes, you can support ongoing maintenance here:
- Sponsor page: https://pve.u3u.icu/sponsor
- Afdian: https://afdian.com/a/cyrenenight
## Pay For Services
If you need one-on-one remote support, emergency recovery, passthrough troubleshooting, network work, or a full PVE setup, check the paid support page:
- Paid support: https://pve.u3u.icu/pay
## Other Languages
- 中文: [README.md](./README.md)
- 日本語: [README-JP.md](./README-JP.md)
## Disclaimer
This project is a real operations tool for Proxmox VE hosts and guests. If you run high-risk actions without validated backups, a maintenance window, and a rollback plan, you may cause management-plane loss, guest outage, or irreversible data damage. All data loss, recovery cost, and third-party recovery expenses remain the responsibility of the operator.
Full ULA page: https://pve.u3u.icu/ula
The ULA outlines the intended scope of the script, its risk boundaries, the operator's responsibilities, and the disclaimer for network interruption, configuration mistakes, data damage, service unavailability, and related recovery costs. Read it before running backup or restore, migration, Cloud-Init, disk changes, GPU passthrough, host networking, or firewall operations.
## License
GPL-3.0. See [LICENSE](LICENSE).