/media/BACKUP/urbackup/
├── backup-client1/
│   ├── 261019-0841/        # 备份点：日期-时间（YYMMDD-HHMM）
│   │   ├── ubdata/         # 与客户端目录结构一致的完整视图
│   │   │   ├── data1.bin   # 硬链接（链接数 2+ 表示复用历史块）
│   │   │   └── ...
│   │   └── .hashes/        # 每个文件的分块哈希元数据（treehash）
│   ├── 261019-0844/
│   ├── 261019-1242/
│   └── current -> /media/BACKUP/urbackup/backup-client1/261019-1247   # 指向最新备份点
├── clients/                # 客户端镜像备份登记
└── urbackup_tmp_files/     # 传输临时文件

{ "usage": [ { "files": 12583000.0, "images": 0, "name": "backup-client1", "used": 12583000.0 } ] }

global_soft_fs_quota = 95%

# 手动触发存储清理（按目标腾出的空间大小）
urbackupsrv cleanup -a 1%
urbackupsrv cleanup -a 10G      # 支持 %/M/G/T 单位

USAGE:

   urbackupsrv cleanup  [-u <user>] -a <%|M|G|T> [--] [--version] [-h]

   -a <%|M|G|T>,  --amount <%|M|G|T>  (required)
     Amount of storage to cleanup

   Cleanup file/image backups from backup storage

urbackupsrv verify-hashes      # 校验备份存储中所有文件哈希（深度完整性检查，耗 IO）
urbackupsrv remove-unknown     # 清理存储中不属于任何备份点的孤儿文件并修复符号链接
urbackupsrv repair-database    # 元数据库损坏时的修复尝试
urbackupsrv defrag-database    # 重建元数据库（回收 SQLite 空间、消除碎片）

verify-hashes : Verify file backup hashes
remove-unknown: Remove unknown files and directories from backup storage
                and fix symbolic links in backup storage

CREATE TABLE si_users(id INTEGER PRIMARY KEY, name TEXT, password_md5 TEXT, salt TEXT,
                      report_mail TEXT, report_loglevel INTEGER, report_sendonly INTEGER,
                      pbkdf2_rounds INTEGER);

sudo urbackupsrv reset-admin-pw -a admin -p '新密码'

2026-10-19 12:39:07: Changed admin password.
2026-10-19 12:39:07: Updated admin rights.

{
  "admin": true,
  "allow_add_client": true,
  "allow_modify_clients": true,
  "remove_client": true,
  "browse_backups": "all",
  "logs": "all",
  "settings": "all"
}

sudo urbackupsrv export-auth-log > auth_log.csv

"/var/log/urbackup.log" {
        weekly
        rotate 12
        missingok
        create 640 urbackup urbackup
        compress
        postrotate
                test -e /var/run/urbackupsrv.pid && kill -HUP `cat /var/run/urbackupsrv.pid` || test -e /var/run/urbackupsrv.ready && /bin/systemctl kill -s HUP --kill-who=main urbackup-server.service
        endscript
}

Starting unscheduled incremental file backup...
Backing up "ubdata" without snapshot.
Indexing of "ubdata" done. 2 filesystem lookups 0 db lookups and 0 db updates
backup-client1: Loading file list...
backup-client1: Calculating file tree differences...
backup-client1: Calculating tree difference size...
backup-client1: Linking unchanged and loading new files...
Waiting for file transfers...
Referencing snapshot on "backup-client1" for path "ubdata" failed: FAILED
Waiting for file hashing and copying threads...
Writing new file list...
All metadata was present
Transferred 1021 bytes - Average speed: 44.384 KBit/s
(Before compression: 499 bytes ratio: 0.488737)
Time taken for backing up client backup-client1: 10s
Backup succeeded

ERROR: Creating shadowcopy of "ubdata" failed.        # 无块设备快照能力时的快照失败
ERROR: Error joining ipv6 multicast group ff12::f894:d:dd00:ef91   # 容器环境无 IPv6 组播，无害

-- ret 位掩码：0=文件与镜像备份均正常；1=文件备份超期；2=镜像备份超期；3=两者均超期
local file_backup_nok = file_interval * params.alert_file_mult - params.passed_time_lastbackup_file

--Send webhook alert via HTTP GET (params appended in URL)
function send_webhook(event, image, passed_time, alert_time)
        local btype = "file"
        if image
        then
                btype="image"
                if params.no_images
                then
                        return
                end
        elseif params.no_file_backups
        then
                return
        end

        local lastbackup_txt = "Last " .. btype .." backup was " .. pretty_time(passed_time) .. " ago"
        if passed_time==nil
        then
                lastbackup_txt = "Client has never had a " .. btype .. " backup"
        end

        request_url(params.webhook_url .. "?event=" .. event .. "&type=" .. btype
                .. "&client=" .. params.clientname
                .. "&lastbackup=" .. string.gsub(lastbackup_txt, " ", "_")
                .. "&threshold=" .. pretty_time(alert_time))
end

-- insert_alert.sql（节选）：注册脚本与参数
INSERT OR REPLACE INTO alert_scripts (id, name, script) VALUES (2, 'Webhook alert', '-- ...完整Lua脚本...');
INSERT OR REPLACE INTO alert_script_params (script_id, idx, name, label, default_value, has_translation, type)
  VALUES (2, 0, 'webhook_url', 'Webhook URL', 'http://10.89.49.1:9999/alert', 0, 'string');
-- 让客户端 id=1 使用脚本 2
INSERT OR REPLACE INTO settings (key, value, clientid) VALUES ('alert_script', '2', 1);

sqlite3 /var/urbackup/backup_server.db < insert_alert.sql

SELECT id, name, length(script) FROM alert_scripts;

1|Default|0
2|Webhook alert|3912
100000|Pulseway API|0

#!/usr/bin/env python3
# webhook_receiver.py：接收 UrBackup 告警 GET 并落盘
import http.server, urllib.parse, datetime, json

LOG = '/opt/data/quzuo/urbackup-2-5-38/webhook_received.log'

class H(http.server.BaseHTTPRequestHandler):
    def do_GET(self):
        u = urllib.parse.urlparse(self.path)
        q = urllib.parse.parse_qs(u.query)
        rec = {'time': datetime.datetime.now().isoformat(), 'path': u.path,
               'params': {k: v[0] for k, v in q.items()}, 'ua': self.headers.get('User-Agent', '')}
        with open(LOG, 'a') as f:
            f.write(json.dumps(rec, ensure_ascii=False) + '\n')
        self.send_response(200)
        self.end_headers()
        self.wfile.write(b'{"errcode":0,"errmsg":"ok"}')
    def log_message(self, *a):
        pass

http.server.HTTPServer(('0.0.0.0', 9999), H).serve_fore()

UPDATE clients SET alerts_next_check=NULL, lastbackup=datetime('now','-6 hours'), file_ok=1 WHERE id=1;

{"time": "2026-10-19T20:53:43.502172", "path": "/alert",
 "params": {"event": "backup_overdue", "type": "file", "client": "backup-client1",
            "lastbackup": "Last_file_backup_was_4h_21min_ago", "threshold": "15min"}, "ua": ""}

{"time": "2026-10-19T20:44:43.498221", "path": "/alert",
 "params": {"event": "backup_ok", "type": "file", "client": "backup-client1",
            "lastbackup": "Last_file_backup_was_2min_ago", "threshold": "15min"}, "ua": ""}