uroni/urbackup-server

UrBackup服务器多架构Docker镜像

镜像概述

本镜像为UrBackup服务器提供多架构支持，涵盖amd64、i386、armhf及arm64(aarch64)架构。拉取:latest标签时会自动获取对应架构的镜像，基于https://github.com/Whatang/docker_urbackup%E7%9A%84%E5%8E%9F%E5%A7%8B%E4%BB%A3%E7%A0%81%E6%9E%84%E5%BB%BA%E3%80%82

核心功能与特性

• 多架构适配：自动匹配amd64/i386/armhf/arm64架构，无需手动指定
• 灵活权限控制：通过PUID/PGID环境变量配置文件所有者的UID/GID
• 文件系统支持：兼容BTRFS（需添加系统权限）和ZFS（需挂载设备及配置数据集）
• 数据持久化：支持挂载备份目录、数据库目录及www目录到宿主机
• 时区配置：通过TZ环境变量自定义时区

使用场景与适用范围

适用于需要在不同架构设备（如x86服务器、ARM开发板）上部署UrBackup备份服务的场景，支持个人或企业级文件备份需求，尤其适合需要BTRFS/ZFS高级文件系统特性的用户。

使用方法与配置说明

通过docker run命令运行

需指定文件所有者UID/GID、挂载目录及网络模式，基础命令如下：

bash
docker run -d \
    --name urbackup \
    --restart unless-stopped \
    -e PUID=1000 \  # 文件所有者UID
    -e PGID=100 \   # 文件所有者GID
    -e TZ=Europe/Berlin \  # 时区设置
    -v /path/to/backup:/backups \  # 备份文件存储目录
    -v /path/to/database:/var/urbackup \  # 数据库存储目录
    --network host \
    uroni/urbackup-server:latest

特殊配置补充：

• BTRFS支持：添加--cap-add SYS_ADMIN参数
• ZFS支持：添加--device /dev/zfs参数；如需通过环境变量设置数据集，增加-e ZFS_IMAGE=tank/images和-e ZFS_FILES=tank/files
• 外部挂载www目录：添加-v /path/to/www:/usr/share/urbackup

通过docker-compose运行（兼容Portainer堆栈）

创建docker-compose.yml文件：

yaml
version: '2'

services:
  urbackup:
    image: docker.xuanyuan.run/uroni/urbackup-server:latest
    container_name: urbackup
    restart: unless-stopped
    environment:
      - PUID=1000  # 文件所有者UID
      - PGID=100   # 文件所有者GID
      - TZ=Europe/Berlin  # 时区
      # 如需环境变量配置ZFS数据集，取消以下注释
      #- ZFS_IMAGE=tank/images
      #- ZFS_FILES=tank/files
    volumes:
      - /path/to/database:/var/urbackup  # 数据库目录
      - /path/to/backup:/backups  # 备份目录
      # 如需外部挂载www目录，取消以下注释
      #- /path/to/www:/usr/share/urbackup
    network_mode: "host"
    # BTRFS支持取消以下注释
    #cap_add:
    #  - SYS_ADMIN
    # ZFS支持取消以下注释
    #devices:
    #  - /dev/zfs:/dev/zfs

容器启动后，Web管理界面可通过55414端口访问。

本地构建

使用提供的build.sh脚本构建镜像：

bash
./build.sh

默认构建amd64架构的最新稳定版。如需指定架构和版本，使用以下格式：

bash
./build.sh [ARCH] [VERSION]

• [ARCH]：可选值为amd64/i386/armhf/arm64
• [VERSION]：UrBackup服务器的有效版本号

示例：构建armhf架构、版本2.4.10的镜像

bash
./build.sh armhf 2.4.10