Ubuntu 22.04 安装 UrBackup 2.5.38 指南

在 Ubuntu 22.04 上从零安装 UrBackup 服务端（2.5.38）与 Linux 客户端（2.5.31）：官方 deb 包安装与 systemd 服务管理、备份存储目录规划、Web 管理端初始化与管理员密码设置、客户端官方自更新脚本安装、备份目录添加与客户端接入验证，附完整端口清单与官方 Docker 镜像部署方式。全部命令实测验证。

UrBackup备份恢复Ubuntu 22.04安装2026/10/19

Ubuntu 22.04 安装 UrBackup 2.5.38 指南

一、安装前准备

1.1 版本确认

本文写作时（2026-10-19）从 GitHub Releases（uroni/urbackup_backend）实查的最新稳定版本为：服务端 2.5.38（2026-08-30 发布）、Linux 客户端 2.5.31（2026-06-17 发布，Windows 专用版为 2.5.32）。UrBackup 服务端与客户端独立发版，Linux 客户端没有 2.5.32 这个版本号，下载时认准 Client/2.5.31 路径。

1.2 环境与角色规划

本文实测环境为一台 Ubuntu 22.04（Jammy）服务器运行服务端、一台 Ubuntu 22.04 机器运行客户端，两机网络互通：

角色主机名操作系统IP（示例环境）
服务端urbackup-serverUbuntu 22.04.5 LTS10.89.49.10
客户端urbackup-clientUbuntu 22.04.5 LTS10.89.49.11

1.3 端口规划

UrBackup 需要用到的端口（安装防火墙前先放行）：

端口协议用途
55414TCPWeb 管理端（默认）
55415TCP客户端备份/互联网模式数据传输
55413TCPFastCGI / 本地管理接口
35623UDP局域网客户端广播自动发现
55416TCP客户端本地 REST/控制接口（本机 urbackupclientctl 使用）

服务端所有运行参数集中在 /etc/default/urbackupsrv，实测该文件内容如下（安装后默认值，注释行已省略）：

FASTCGI_PORT=55413
HTTP_SERVER="true"
HTTP_PORT=55414
HTTP_LOCALHOST_ONLY=false
INTERNET_LOCALHOST_ONLY=false
LOGFILE="/var/log/urbackup.log"
LOGLEVEL="warn"
DAEMON_TMPDIR="/tmp"
SQLITE_TMPDIR=""
BROADCAST_INTERFACES=""
ALLOW_USER_ENUMERATION="true"
USER="urbackup"

如需修改 Web 端口，改 HTTP_PORT 后重启 urbackupsrv 服务即可。

二、服务端安装（官方 deb 包）

Ubuntu 上的官方安装方式是 deb 包。官方文档（urbackup.org/debianserverinstall.html）给出的标准步骤为：下载 → dpkg -i → apt install -f 修复依赖。实测服务端安装的 2.5.38.0 包正是这一形态：

# 1. 下载官方 deb 包（amd64）
wget https://hndl.urbackup.org/Server/2.5.38/urbackup-server_2.5.38_amd64.deb

# 2. 安装（过程中会询问备份存储目录）
sudo dpkg -i urbackup-server_2.5.38_amd64.deb

# 3. 修复依赖（若上一步有依赖缺失）
sudo apt install -f

三个关键点（来自官方安装提示页，均在本机安装结果中得到验证）：

  1. 安装过程会询问备份存储目录，后续可用 sudo dpkg-reconfigure urbackup-server 修改（改前必须先把旧目录文件全部复制到新目录）。本实测环境中配置的存储路径为 /media/BACKUP/urbackup，该值同时写入服务端设置库（backupfolder=/media/BACKUP/urbackup）。
  2. deb 包以 systemd 服务交付，服务名 urbackupsrv。安装后确认运行状态：
systemctl status urbackupsrv

实测输出：

● urbackupsrv.service - LSB: Server for doing backups
     Loaded: loaded (/etc/init.d/urbackupsrv; generated)
     Active: active (running) since Mon 2026-10-19 09:17:42 UTC; 3h 40min ago
       Docs: man:systemd-sysv-generator(8)
    Process: 3871 ExecStart=/etc/init.d/urbackupsrv start (code=exited, status=0/SUCCESS)
      Tasks: 23 (limit: 38359)
  1. deb 包还提供 dpkg -l 可查的包记录与一组服务器端工具：
dpkg -l | grep -i urbackup

实测输出：

ii  urbackup-server             2.5.38.0                                amd64        Server for doing backups of clients

服务端核心文件布局（dpkg -L urbackup-server 摘录）：

/etc/default/urbackupsrv          # 服务端配置文件（端口/日志等）
/etc/init.d/urbackupsrv           # init 脚本
/etc/logrotate.d/urbackupsrv      # 日志轮转配置
/usr/bin/urbackupsrv              # 主程序
/usr/bin/urbackup_mount_helper    # 镜像挂载辅助
/usr/bin/urbackup_snapshot_helper # 快照辅助

版本自检：

urbackupsrv version

实测输出（末行）：

UrBackup Server v2.5.38.0
Copyright (C) 2011-2019 Martin Raiber

2.1 替代方式：Ubuntu PPA 仓库安装

官方还提供 Launchpad PPA（适合希望随 apt upgrade 升级的场景，来自官网下载页）：

sudo add-apt-repository ppa:uroni/urbackup
sudo apt update
sudo apt install urbackup-server

2.2 替代方式：官方 Docker 镜像

官方容器镜像为 uroni/urbackup-server（多架构 x86/ARM 32/64 位），官网下载页给出的部署命令：

docker run -d --name urbackup-server-1 \
  -v /media/backups:/backups \
  -v /media/database:/var/urbackup \
  -p 55413-55415:55413-55415 \
  -p 35623:35623/udp \
  uroni/urbackup-server

两个卷分别承载备份存储（/backups）与数据库/配置（/var/urbackup），务必都持久化挂载；升级流程为 docker rm -f 后 docker pull 再用原命令重建。本文后续步骤以 deb 包形态为主线，Docker 形态下命令路径略有差异（如服务管理换成 docker 命令），其余 Web 界面操作完全一致。

三、服务端初始化

3.1 首次登录与创建管理员

安装完成后，浏览器访问 http://<服务端IP>:55414 进入 Web 管理端。官方安装页特别强调：必须在 Settings → Users 中创建管理员账号，否则任何人都可以通过 Web 界面访问所有备份。

管理员密码也可以（或找回密码时）在服务器上用内置命令直接重置，实测：

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 / 密码 q1w2e3r4（仅作演示，生产环境请使用强密码）。

3.2 验证备份存储路径

登录 Web 端进入 Settings → General，确认 Backup storage path 指向 1.2 节规划的目录。实测环境中为：

backupfolder = /media/BACKUP/urbackup

服务端会在该目录下按 客户端名/日期-时间 组织备份（如 backup-client1/261019-0844），并自动创建 clients、urbackup_tmp_files 等工作目录。

四、客户端安装（官方 Linux 安装脚本）

4.1 一键安装

Linux 客户端官方推荐用自更新安装脚本（含 x86/x86_64/ARMv6+/ARM64 构建，会自动选择匹配架构）。官网下载页给出的 2.5.31 安装命令：

TF=$(mktemp) && wget "https://hndl.urbackup.org/Client/2.5.31/UrBackup%20Client%20Linux%202.5.31.sh" -O $TF && sudo sh $TF; rm -f $TF

脚本会把客户端安装到 /usr/local 前缀并注册 systemd 服务。安装完成后确认版本与进程：

/usr/local/sbin/urbackupclientbackend --version

实测输出：

UrBackup Client Backend v2.5.31.0
Copyright (C) 2011-2019 Martin Raiber

systemctl status urbackupclientbackend

实测输出：

● urbackupclientbackend.service - UrBackup Client backend
     Loaded: loaded (/lib/systemd/system/urbackupclientbackend.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2026-10-19 12:52:33 UTC; 6min ago
   Main PID: 3538 (urbackupclientb)
      Tasks: 14 (limit: 38359)

客户端配置文件为 /etc/default/urbackupclient，关键字段（实测内容节选）：

LOGFILE="/var/log/urbackupclient.log"
LOGLEVEL=warn
LOG_ROTATE_FILESIZE=20971520
LOG_ROTATE_NUM=10
DAEMON_TMPDIR="/tmp"
RESTORE=server-confirms
INTERNET_ONLY=false

其中 RESTORE 控制是否允许从服务端 Web 界面发起恢复到本机，默认值 disabled 表示禁用 Web 恢复（命令行恢复仍可用）；要启用本文《UrBackup 快速入门与实战示例》中的 Web 恢复功能，需改为 server-confirms（服务端发起、无需本机确认）或 client-confirms（本机有 GUI 用户确认），修改后重启服务：

sudo systemctl restart urbackupclientbackend

4.2 指定备份目录

把需要备份的目录加入备份集（-n 为该目录在服务端显示的名称）：

sudo urbackupclientctl add-backupdir -d /home/ubdata -n ubdata

查看当前备份集：

urbackupclientctl list-backupdirs

实测输出：

PATH         NAME   FLAGS
------------ ------ ----------------------------------------------
/home/ubdata ubdata follow_symlinks,symlinks_optional,share_hashes

4.3 客户端接入服务端

同网段时客户端会通过 UDP 广播（35623）自动发现服务端；若网络不支持广播，编辑 /etc/default/urbackupclient 中的服务端地址配置或用 urbackupclientctl set-settings 指定服务端 IP 后重启服务。随后在服务端 Web 端的 Status 页面即可看到客户端上线（实测客户端接入后状态）：

{
 "name": "backup-client1",
 "online": true,
 "os_simple": "linux",
 "os_version_string": "Ubuntu 22.04.5 LTS (Jammy Jellyfish); Kernel 6.8.0-138-generic x86_64",
 "client_version_string": "2.5.31",
 "ip": "10.89.49.11"
}

客户端本机也可确认与服务端的连接：

urbackupclientctl status

实测输出（节选）：

{
"last_backup_time": 1792413893,
"running_processes": [],
"servers": [{
"internet_connection": false,
"name": "10.89.49.10"
}]
}

五、防火墙与连通性验证

服务端放行端口（ufw 示例）：

sudo ufw allow 55413:55415/tcp
sudo ufw allow 35623/udp

客户端到服务端的连通性验证：

# 在客户端上测试 Web 端口
curl -s -o /dev/null -w '%{http_code}\n' http://10.89.49.10:55414/

实测输出：

200

六、安装后自检清单

  • 服务端 systemctl status urbackupsrv 为 active (running)，日志 /var/log/urbackup.log 无异常；
  • Web 端 55414 可访问，且已创建管理员账号；
  • 备份存储路径磁盘空间充足、属主为 urbackup 用户；
  • 客户端 urbackupclientctl status 中 servers 列表出现服务端 IP；
  • Web 端 Status 页客户端 online: true，手动触发一次文件备份（见《UrBackup 快速入门与实战示例》）验证全链路。

七、参考链接

  1. UrBackup 下载页（deb 包/PPA/Docker/客户端脚本官方地址）：https://www.urbackup.org/download.html
  2. Debian/Ubuntu 服务端安装官方提示：https://www.urbackup.org/debianserverinstall.html
  3. GitHub Releases（版本实查）：https://github.com/uroni/urbackup_backend/releases
  4. 服务器管理手册：https://www.urbackup.org/ServerAdminGuide-v2.4.x.pdf
  5. Linux 客户端源码安装说明：https://www.urbackup.org/client_debian_ubuntu_install.html