Proxmox VE 备份服务器(PBS)是一种与 Proxmox VE(PVE)配套的备份解决方案,专门用于备份和恢复虚拟机、容器和物理主机。

PBS支持增量备份、同时采用哈希值校验等技术保证备份数据的完整性和安全性

PBS官方备份客户端软件仅支持Debian系统

第三方软件ProxmoxBackupClientGo提供GO语言的备份客户端,可以编译到Win、Linux平台使用和proxmoxbackupclient的相同的文件夹备份功能

软件仍然是alpha级质量,可能导致数据备份丢失,包括源数据的丢失,项目作者不对任何形式的损坏或数据丢失负责

但是我用着没有什么问题(?

ProxmoxBackupClientGo目前仅支持备份文件夹到PBS服务器,不支持从备份服务器恢复

在此处提供一个翻译过的ProxmoxBackupClientGo软件

PBS_Client.exe

备份指令示例

.\PBS_Client.exe -baseurl "https://pbserverip:8007/" -certfingerprint "这里填写PBS证书指纹,可以通过PBS仪表盘右侧的显示指纹看到" -authid "pbs@pbs!backup" -secret "API密钥" -backupdir "C:\Users\备份目录" -datastore "数据存储库名"

运行ProxmoxBackupClientGo需要管理员权限(创建快照需要?

authid是API令牌,需要添加DatastoreBackup权限到API令牌和令牌所有者的用户,才能进行备份,

authid格式为 用户名@领域!API密钥名称,例pbs@pbs!backup

可以添加 -backid 参数,自定义备份的名字,不添加默认为主机名

可以将配置信息写入到ps1脚本,实现一键备份指定文件夹,同时可以使用任务计划程序定时备份

if (-NOT ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
    Start-Process powershell.exe "-NoProfile -ExecutionPolicy Bypass -File `"$PSCommandPath`"" -Verb RunAs
    exit
}

chcp 65001 | Out-Null
$OutputEncoding = [System.Text.Encoding]::UTF8
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

$env:PBS_BASEURL = "https://172.16.0.74:8007/"
$env:PBS_CERT_FINGERPRINT = "2e:32:f8:bf:f3:c1:04:ee:c5:4a:4d:76:d6:a4:b0:be:d2:ec:cd:47:d7:de:da:c9:b2:2d:04:32:2d:71:dc:0e"
$env:PBS_AUTH_ID = "pbs@pbs!backup"
$env:PBS_SECRET = "d85f14de-0000-0000-0000-00000000000000"
$env:PBS_BACKUP_DIR = "C:\Users\Suancs\Downloads"
$env:PBS_DATASTORE = "TEST"

$logTime = Get-Date -Format "yyyy-MM-dd-HH.mm.ss"
$logDir = "$PSScriptRoot\log"
if (-not (Test-Path $logDir)) {
    New-Item -ItemType Directory -Path $logDir | Out-Null
}
$logFile = "$logDir\$logTime.log"

& "$PSScriptRoot\PBS_Client.exe" `
    -baseurl $env:PBS_BASEURL `
    -certfingerprint $env:PBS_CERT_FINGERPRINT `
    -authid $env:PBS_AUTH_ID `
    -secret $env:PBS_SECRET `
    -backupdir $env:PBS_BACKUP_DIR `
    -datastore $env:PBS_DATASTORE 2>&1 | Tee-Object -FilePath $logFile

$env指定了备份参数,可以将ps1文件放在ProxmoxBackupClientGo相同目录下

运行该ps1文件,或者通过指powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Users\此处填写ps1的文件路径.ps1"

来进行备份

备份

备份示例

PS C:\Users\Suancs\Desktop\PBS CLIENT> .\PBS_Client.exe -baseurl "https://172.16.0.74:8007/" -certfingerprint "2e:32:f8:bf:f3:c1:04:ee:c5:4a:4d:76:d6:a4:b0:be:d2:ec:cd:47:d7:de:da:c9:b2:2d:04:32:2d:71:dc:0e" -authid "pbs@pbs!backup" -secret "d85f14de-0000-0000-0000-00000000000000" -backupdir "C:\Users\Suancs\Downloads" -datastore "TEST"
开始备份 C:\Users\Suancs\Downloads
正在创建 VSS 快照...快照已创建: {DF32CB5C-316F-4862-9361-BE485B7092EC}
符号链接从:  \\?\GLOBALROOT\Device\HarddiskVolumeShadowCopy147\  到:  C:\Users\Suancs\AppData\Roaming\PBSBackupGO\VSS\{DF32CB5C-316F-4862-9361-BE485B7092EC}
正在读取升级响应...
升级响应: HTTP/1.1 101 Switching Protocols
connection: upgrade
upgrade: proxmox-backup-protocol-v1
date: Fri, 20 Feb 2026 01:19:35 GMT


成功升级到 HTTP/2。
已下载之前的 DIDX: 24 B
之前的索引魔数错误 (no valid)!
已知数据块: 0!
数据块大小最小 1048576,最大 16777216
数据块大小最小 1048576,最大 16777216
写入器 ID:  1
写入器 ID:  2
新建数据块[4f560179331eaba2dd5567e095b180ed8653484a800fc1f39b41a05f4d376b2b] 5.45 MB
新建数据块[973fd029e1e16311de295fd19a837b4fcae34816c74daf27eb792d7ed19a9aef] 1.27 MB
新建数据块[522fb8619737fd78ef9ca1895a8faeafef68dcdc9c3351002961cba0e3ecd371] 1.78 MB
新建数据块[5768ac32a0383bc4a3056a98a0d64dd6519849f79076e907b41848559a629be4] 1.40 MB
新建数据块[c2d38123078f8bfb93718b17a5c4677a6ec1f8f6a3d94821ae8550fc877c60bf] 3.95 MB
新建数据块[b9b66187dbfe4fed276fcc32545183d52a5f70597c5c0a9fc7bc9f122f66fa39] 4.72 MB
新建数据块[b0aad47b89dfab2cb2ee49f892bf05239411d830f1093f3763208e94b062d8c4] 2.10 MB
新建数据块[14e38755a4a10b817661cb3c96964dbd5c837290b66f9c2059e89b62ee596591] 5.15 MB
新建数据块[06ba5039454a46f7f4142ce286f88a9babb61e2de3b317333f947be130297b39] 2.37 MB
新建数据块[3a83a028ea3cb88cf0c9582002d12cb3bd13cc8915cde76058427ea4d38a080e] 2.05 MB
新建数据块[db71ee4f0134dcde7c6a80e9f5c8ee9b0c27ee7f904a80d172a01743081a3440] 5.65 MB
新建数据块[4668cb2d60deea9061a1508d52677f9679c6d417dabd713453fc1ecf1bc70b75] 1.98 MB
新建数据块[77a05e3f3c3cb867a613ca651a387c6052e6c51108d32e12c5dfae5d67004a0d] 6.54 MB
新建数据块[91b4497458a83e4866e58f2752d6282cc6f3ae6542e651ffd2a9c6623db29883] 4.65 MB
新建数据块[50bd0189bb85a6141d3640dce71eb0a9acfcee231153b7e0c8e3df0713d9f242] 5.94 MB
新建数据块[8b4c1ad191203e0725e6139c42bdd1436340f565f509a8fbdfa9239b2cbbadc8] 1.37 MB
新建数据块[14abb327533bffca92b3ba829fc7998100ac1415ee330ab1f2b609b14cc8013e] 4.92 MB
新建数据块[df4a5242faf2dbda7e2baf9c9168467e56052c59865f6a7f11a605531d737513] 2.00 MB
新建数据块[bd8a1807f1e01f5c9994bf4001766f2bf379a2fb159695c96c4c995c4ea76d0e] 1.82 MB
新建数据块[bab74398a6c2ccab5f9eb67500149ff47da0978b2ecf26cd632fa25f8fed9c7d] 9.47 MB
新建数据块[ceac2f7174c04ac9aa1b7e4b4ed76a60ee538779aaa9d8746d6aa4767c094241] 1.70 MB
新建数据块[e1c9ec058e371e390578ea8fee4370aa7460861f7547b15fb9ba3932bbfd8e61] 1.01 MB
新建数据块[6af2e1703f47a4571b7a463c00dfa4395dc976dbc14676bdf2ad0cc15afc12e2] 3.57 MB
新建数据块[9c6dadbc30d4ca2e4231b064f7dfe60ce99625bd41c5c5c4b745f137b1022536] 3.37 MB
新建数据块[ecfb72c2cff6a622590dd8cb90c9de72c169766905f23dc4c412859e804fddbd] 1.85 MB
新建数据块[3f4990dea85f7b39a23b832f3a8460dd953fef34f990fdab6736322e6a66571e] 3.30 MB
新建数据块[ac24bddc1d5f34b26a6bef88095b6f37b54fb452aa8d6cc851e305cc457c2825] 2.80 MB
新建数据块[b3b3ee218f45690398cd4d8fdbade0e09dadd6967b18d10500d58286ad3811ff] 1.34 MB
新建数据块[7a40de7eb96f6bf4790b8a4de87839539b7e1319972fa56d0caa86ee518b8440] 7.66 MB
新建数据块[42e91e50a6fa3a4b44961ec750ae7e26c9a8e48a06a524849a04111892bb9568] 2.01 MB
新建数据块[68db3e505d0d2de6f356842be0e79e94a49895318320dd7a82ab40a98be3e6b2] 1.65 MB
新建数据块[b1323c2c37f27a009697426d32211467f93fc9664d47d4cc89243e7f2c878702] 6.21 MB
新建数据块[49f1250a889242ae41efc314ff996cb5a0d0ad04a5499d5148695a8d39870f83] 2.56 MB
新建数据块[e0858e2b99763cba8d68ccf327e3c1901d5ee7a4980b528b5640ffcb6aa8a1ef] 2.95 MB
新建数据块[5f40d6d6b799573823114a3fcd5afa498dfec6ebc2531cb9c8637ffa359dffcf] 3.93 MB
新建数据块[fc8768ddcd9375ccabafd7c5f49a6b63fe740347002745253e688c03ec4db275] 1.17 MB
新建数据块[bf6f4bfe95d5c45ea3739aa9176465c3d99b4e57b6ba35ebdb75f076241c0b4f] 1.77 MB
新建数据块[49d117d33ad442c9c49325301e6d08268ddb677215da1f50b008b814a5fe61cb] 1.78 MB
新建数据块[0a71c0a710892e5dddc9ee6859bd052e87160a0ef07b907da83ddce834bb8c7b] 1.16 MB
新建数据块[e00af63167dd767cbdc77ebff97599be5e55d9d675a392c5854cab4dab7a8ede] 1.06 MB
新建数据块[090ea30333ada486ec86b28f61679f5e9fd1225a142abf48453f76fbded51f63] 5.91 MB
新建数据块[c3f585bf54e3ae88c8f247babde859fc104dea1c7008cde8a78ed3e192d49f75] 1.45 MB
新建数据块[e5555878647fb4f8dd437397d135b38a39de46795ec058dd95b37983fbfab26f] 5.08 MB
新建数据块[82686cb4b1d239866ad8dcf95c303e2913af59244c6842e699adb06f43dfb02d] 2.91 MB
新建数据块[b40e36c51070916c3a59820a9d1aaefa5a802850579e8909723e6b8f74d95cdb] 1.21 MB
新建数据块[4ae7d3b92babb719c6c1972d78b237545afb1901fd07ee6ec25f5ca0aace31ca] 1.02 MB
新建数据块[02e565bc077a96059ea3e38da1404c1766588a01931a0d20822f6d6904ae63aa] 11.34 MB
新建数据块[cd65be6d6516d5fe48fc1c052511e93178ee779ca1746da04faa13a824c17fc1] 3.02 MB
新建数据块[72e7fad42805db4a6ca177c65ff4e204309f56a576ee5230cc8c02cc818f6335] 3.19 MB
新建数据块[0a5608861c14eab3ee82390d2acfa1436a1a55450ea2561150e1362dfc50063c] 2.64 MB
新建数据块[69a45b70b8922b490c79fc0209be9acd5656aa5c3c1b695f6a0f6c452bb8003a] 2.02 MB
新建数据块[a169604edac822602578a42d8c9115cfd5a8ad5432e15b90f457d6c34b5079c7] 3.45 MB
新建数据块[357c7378a6101d27ecfce7dfa20f993f7897ae78f7b0bc90805c1412c22147af] 1.26 MB
新建数据块[e160cd19c5ccebebaa052e73c0cf7b6aaca4a75a1afaba12070d7bd441a79401] 3.36 MB
新建数据块[a677ebaad80a0ec84ab4c4c216313215ad01d53f2530c98fa84f173d2461c925] 203.47 KB
新建数据块[2f7f07a12291379185fc8e261452f92c5a23e4ad02caa0093793723a41e48827] 84 B
发现残留快照,正在删除...
新建数据 56 块,重用 0 块
新增数据大小: 175.48 MB
复用数据大小: 0 B
备份总大小: 175.48 MB
备份耗时 22.4151091s。

备份175兆的数据使用22秒,上传速度大概是63mbps,基本占用上行限制

如果文件夹新增数据不多,则下一次备份会从客户端复用上次备份的数据,减少流量的使用

恢复

由于ProxmoxBackupClientGo不支持通过客户端恢复,所以只能在PBS管理界面下载数据

其中pxar.didx格式的文件,可以点开右侧文件夹图标查看文件内容

可以选中文件下载,或者选择文件夹下载为zip/tar.zst