墨穗app.notebase.cn
控制台
内容库
动态
管理
账户
U
用户
--
在线
v1.0.165 · 墨穗笔记
笔记

Notebase墨穗
静水流深,落墨成穗。

0笔记
0工具
30推荐

分类导航

按主题直达

编辑精选

站内用户贡献 · 真实笔记

最新收录

每日更新
继续浏览全部内容 →

笔记

0
加载中...

工具

0

此页用于记录用户反馈问题后的每一次改进

关于

笔记用法

“写笔记”支持四种格式——Word 文档、Excel 表格、Markdown、纯文本,起稿或二次编辑时都能随时切换,同一篇笔记想用哪种形态来记,都由你说了算。

md、txt、csv、json 这类纯文本则原样载入,不做多余加工。拿一张现成的表倒进来、改几笔、再导出去,等于白用一台免费的格式转换器。

要带走就在右上角点“下载”,可导出 PDF、Word、Markdown、Excel、TXT 等格式;列表卡片“⋯”菜单里,也有同样的下载入口。

工具用法

在“工具”页点“+ 上传工具”即可发布:填好名称与链接,再用 Markdown 把使用方法写清楚——能解决什么问题、怎么装、怎么用,比堆介绍实在。

要分发安装包就一并上传压缩包(ZIP、RAR、7Z、TAR.GZ,最大 35MB),别人在详情页一键下载;只放链接不带附件也可以。

工具按大家的收藏热度排序,好用的自然会被顶上来。发布后可在详情页或卡片菜单里编辑、下架。

隐藏笔记

写笔记时勾上“隐藏”,这篇就只存在于你自己的账号里:不进列表、不进搜索、不上首页精选,也不会出现在任何公开的页面,链接发给别人同样打不开。

适合放密码、草稿、日记这类只给自己看的内容;想公开,去“发布”打开它,把“隐藏”的勾去掉再保存,之后编辑会默认保持原状态,不会悄悄变回公开。

不想公开、只想临时给人看:点“分享”生成一条带密码和有效期的链接,到期自动失效,你也能随时撤销。

数据安全

你的内容会同时保存在多个副本上,系统定期做备份与完整性校验,再配合异地容灾机制:就算某台机器出问题,数据也不会丢,可以长期放心存放;特别重要的资料,仍建议你另外再留一份备份。

技术

全站跑在容器化、模块化的现代架构上,更新、部署、回滚都很快,扩展性和稳定性都按长期运营的标准来设计(Built for reliability, designed to scale)。

理念

这个网站最早只是一个人的笔记仓库,后来慢慢长成现在的知识中枢。设计上很克制——没有广告、没有追踪、没有推荐算法,只是干干净净地存放一些东西;既然做好了,就公开出来,万一有人用得上呢。

原则

不做大而全,不做平台梦,保持简单、保持克制、保持好奇。所有内容都由用户贡献、由用户维护:不会突然冒出付费墙,不会在角落塞广告位,也不会把你的数据卖给第三方。

更多

产品会持续迭代,站内日志页记录着每一次改动,改了什么都有迹可循;想了解这个站是怎么一步步走到今天的,翻翻日志就能看到来龙去脉。

举报

如果在这里看到涉嫌违规的内容,点对应卡片右侧的“举报”按钮就能提交,我们会尽快核实处理;也谢谢你花一点时间,一起把这里维护干净。

趋势

// 点击导航加载发现
归档
// 归档为空
最近浏览
// 暂无浏览记录
发布
// 加载中...
用户发布
// 加载中...
用户管理
// 加载中...
访问统计
// 加载中...
内容审核
// 加载中...
个人信息
// 加载中...
返回首页

PBS 备份恢复整批失败?先查 PBS 密码里有没有中文或特殊字符

2026-09-02系统运维

PVE 配了 Proxmox Backup Server(PBS)做备份,结果某天起 VM 备份整批失败,日志报错千奇百怪:有的是 PBS_PASSWORD contains bad characters,有的是 invalid utf-8 sequence,有的是 VM 备份时 QMP 命令直接超时 got timeout。如果所有 VM 一起挂、而 LXC 还能备份成功(只是带告警),先别怀疑网络和存储——查查你的 PBS 密码里有没有中文、emoji 这类多字节字符。

为什么密码会造成整批失败

PVE 在给 PBS 做备份/恢复时,要把存储里存的密码以环境变量(PBS_PASSWORD)和 QEMU 参数的形式传出去。PBS 的密码文件按 UTF-8 存、按 Perl 内部字符串读,一旦密码里含多字节 UTF-8 字符(中文、日文、emoji、特殊符号),传给环境变量或写进 QMP 时就编码错乱,于是:

  • 备份时:PBS_PASSWORD contains bad characters
  • 恢复时:restore failed: invalid utf-8 sequence of 1 bytes from index 0
  • 无盘 VM 备份时:密码解析失败,QMP 客户端读不到足够字符,直接超时

这个 bug 由 Proxmox 官方在邮件列表确认并出补丁修复(把 PBS_PASSWORD 环境变量和 QMP JSON 都按 UTF-8 显式重新编码)。先升级 PVE / pve-storage 到含补丁的版本是最干净的解法。

临时规避(不想升级 / 应急)

  • 把 PBS 的密码改成纯 ASCII(字母 + 数字 + 常规符号),最直接。
  • 或者改用 API Token 而不是账号密码——Token 本身是纯 ASCII 的,天然绕开这个编码问题。

另一个容易混淆的失败:QMP backup 命令超时

还有一种"整批失败"不是密码问题:日志里报

ERROR: VM 113 qmp command 'backup' failed - got timeout

而 PBS 那边的服务日志(journalctl -u proxmox-backup-proxy -f)干干净净,像请求根本没到 PBS。这种 QMP 超时类的案例,官方建议排查方向是:

  1. 升级 PBS 到最新小版本(3.4.x 的已知 bug 可能已修)。
  2. 新建一个"无盘 VM"试备份,缩小问题范围。
  3. 加一条用 IP 而不是主机名访问 PBS 的存储条目,对照测试。

有人实测 IP/主机名没差别、无盘 VM 照样超时——那就还得继续追 PVE/PBS 的版本组合问题,甚至要考虑是不是 VM 启动阶段太慢导致 QMP 通道超时。注意区分:报 bad characters / invalid utf-8 的是密码编码问题,报 qmp ... got timeout 的优先查版本和通道,两条线别混。

顺带的判断提示

  • LXC 全成功但带 "Wide character in setenv ... PBSPlugin.pm" 这类告警 + VM 全失败:这套组合非常指向密码/UTF-8 编码那一族问题,别当成玄学。

怎么把"就是密码在作怪"坐实

PBS 存储的密码是明文写在 /etc/pve/storage.cfg 里的,先翻这一节看有没有非 ASCII 字符:

grep -A6 '^pbs:' /etc/pve/storage.cfg
python3 -c "import re,sys; [print(i,repr(l.rstrip())) for i,l in enumerate(open('/etc/pve/storage.cfg'),1) if re.search(r'[^\x00-\x7f]',l)]"

第二段脚本会把含中文/emoji/特殊符号的行连同行号打出来,命中 password 行基本就坐实了。换密码不用手改文件,pvesm 一条命令就能写回去:

pvesm set backups --password 'MyAsciiPw-2026'

改完先只挑一台小 VM 试备份,全绿再放开整批:vzdump 113 --storage backups --mode snapshot。注意 storage.cfg 会被 pmxcfs 同步到集群每个节点,手改的话所有节点要一致,用 pvesm 写就不用担心这点。

为什么 LXC 只告警、VM 却整批死

容器备份和文件恢复是宿主机直接 fork proxmox-backup-client,密码走环境变量 PBS_PASSWORD;Perl 在非 UTF-8 locale 下碰到多字节字符,最多打一条 Wide character in setenv 的警告,一般不致命。VM 备份不是这条路:密码要作为字符串塞进 QMP 的 backup 命令、交给 qemu 进程去连 PBS,qemu 那边按 UTF-8 严格解析,字符串一非法整个备份任务就 abort。同一套密码,LXC 带警告能过、VM 必挂,是两条代码路径对编码的容忍度不一样,不是玄学。

用 API Token 替代密码的具体姿势

不想动共享密码就建 token:PBS 网页 → 用户 → API Token → 添加,把返回的 root@pam!backup!xxxx 整串记下来(只显示一次)。PVE 存储配置里 username 填 root@pam!backup(用户@域!token名 格式),password 栏粘贴那串 secret。token 本身是纯 ASCII,绕开编码问题的同时还能按 datastore/权限收窄,之后要吊销也单独吊销,比公用密码干净。

参考出处:
https://lore.proxmox.com/pve-devel/20251001104729.70314-2-f.ebner@proxmox.com/t/
https://forum.proxmox.com/threads/172871/

相似推荐
PVE 快照把盘占满、删还删不掉?先解锁再腾空间,别硬删PVE 装 Windows 卡在"找不到硬盘"?那多半是没带 VirtIO 驱动定期跑 sha256 校验,防资料静默损坏PVE 想让数据库先启动、应用后启动?开机自启顺序这样排才靠得住PVE 网页登录后白屏/打不开,服务全正常却没日志?按这几个方向逐个试每月把 VPS 登录记录过一遍:last、lastlog 加 /etc/passwd 查陌生登录
编写使用方法
Markdown 格式 · Ctrl+Enter 确定
0 字新建笔记
欢迎回来
登录你的墨穗笔记账户
忘记密码?
还没有账户?立即注册
创建账户
注册你的专属墨穗笔记
已有账户?去登录
找回密码
输入注册邮箱获取验证码
返回登录
请输入图片中的验证码以继续注册
加载中...
取消
新建收藏
手动添加你喜欢的内容
取消
编辑头像与昵称
上传新头像或修改你的显示昵称
支持 JPG/PNG,最大 2MB
取消

问题反馈

隐私提醒

取消
编辑工具
受控分享
为这篇笔记生成限时 / 带密码的临时链接
关闭