mirror of
https://github.com/Awuqing/BackupX.git
synced 2026-06-05 09:49:37 +08:00
bc3d03de7e
- 新建 docs-site/ Docusaurus 项目，支持 en + zh-Hans 双语 - 从 README 迁移内容为独立文档页面： - Getting Started（安装、快速开始） - Deployment（Docker、裸机、Nginx、配置参考） - Features（备份类型、存储后端、SAP HANA、多节点集群、通知） - Reference（API、CLI） - Development（开发、贡献） - 自定义 BackupX 主题色、logo、落地页组件 - 新增 .github/workflows/docs.yml，Actions 自动构建并发布到 GitHub Pages - README.md 切换为英文，中文版挪到 README.zh-CN.md，两者均精简为导航型 - 配置站点 URL：https://awuqing.github.io/BackupX/
69 lines
1.6 KiB
Markdown
69 lines
1.6 KiB
Markdown
---
|
||
sidebar_position: 1
|
||
title: Docker 部署
|
||
description: 生产级 Docker 部署方案，含 compose 配置、宿主目录挂载、环境变量覆盖。
|
||
---
|
||
|
||
# Docker 部署
|
||
|
||
BackupX 官方 Docker 镜像 [`awuqing/backupx`](https://hub.docker.com/r/awuqing/backupx) 支持多架构（linux/amd64 + linux/arm64）。
|
||
|
||
## Compose 文件
|
||
|
||
```yaml title="docker-compose.yml"
|
||
services:
|
||
backupx:
|
||
image: awuqing/backupx:latest
|
||
container_name: backupx
|
||
restart: unless-stopped
|
||
ports:
|
||
- "8340:8340"
|
||
volumes:
|
||
- backupx-data:/app/data
|
||
# 挂载需要备份的宿主机目录：
|
||
- /var/www:/mnt/www:ro
|
||
- /etc/nginx:/mnt/nginx-conf:ro
|
||
environment:
|
||
- TZ=Asia/Shanghai
|
||
- BACKUPX_LOG_LEVEL=info
|
||
- BACKUPX_BACKUP_MAX_CONCURRENT=2
|
||
|
||
volumes:
|
||
backupx-data:
|
||
```
|
||
|
||
启动：
|
||
|
||
```bash
|
||
docker compose up -d
|
||
```
|
||
|
||
## 备份宿主机目录
|
||
|
||
想备份宿主机上的文件，需要将对应路径挂载进容器。在 Web UI 创建文件类型任务时，把源路径指向挂载后的容器内路径（如 `/mnt/www`）。
|
||
|
||
## 环境变量
|
||
|
||
所有配置项都可以通过 `BACKUPX_` 前缀环境变量覆盖：
|
||
|
||
```yaml
|
||
environment:
|
||
- TZ=Asia/Shanghai
|
||
- BACKUPX_SERVER_PORT=8340
|
||
- BACKUPX_LOG_LEVEL=debug
|
||
- BACKUPX_BACKUP_MAX_CONCURRENT=4
|
||
- BACKUPX_BACKUP_TEMP_DIR=/tmp/backupx
|
||
```
|
||
|
||
完整列表见 [配置参考](./configuration)。
|
||
|
||
## 升级
|
||
|
||
在 UI **系统设置 → 检查更新** 页面查看是否有新版，然后在宿主机上：
|
||
|
||
```bash
|
||
docker compose pull && docker compose up -d
|
||
```
|
||
|
||
无需手工迁移：BackupX 启动时自动迁移 SQLite schema。
|