Files
BackupX/docs-site/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/installation.md
Wu Qing bc3d03de7e 文档: 新增 Docusaurus 官网与双语文档,README 切换为英文默认 (#39)
- 新建 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/
2026-04-17 13:19:41 +08:00

2.0 KiB
Raw Blame History

sidebar_position, title, description
sidebar_position title description
1 安装 通过 Docker、预编译包或源码安装 BackupX。

安装

BackupX 以单个静态二进制发布。三种安装方式,按实际环境选一种。

Docker推荐

无需克隆仓库:

docker run -d --name backupx \
  -p 8340:8340 \
  -v backupx-data:/app/data \
  awuqing/backupx:latest

或使用 docker compose

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

volumes:
  backupx-data:

Docker Hubawuqing/backupx,支持 linux/amd64 和 linux/arm64。

预编译包(裸机)

Releases 页面 下载对应平台的压缩包,执行安装脚本:

tar xzf backupx-v*-linux-amd64.tar.gz && cd backupx-*
sudo ./install.sh        # 创建系统用户、安装到 /opt/backupx、配置 systemd + Nginx

安装脚本会自动:

  1. 创建 backupx 系统用户
  2. 安装二进制到 /opt/backupx/backupx
  3. 生成 /opt/backupx/config.yaml(含安全默认值)
  4. 注册并启用 backupx.service systemd 单元
  5. (可选)配置 Nginx 反向代理

从源码构建

依赖Go ≥ 1.25Node.js ≥ 20。

git clone https://github.com/Awuqing/BackupX.git && cd BackupX
make build
# 或使用国内镜像加速构建 Docker
make docker-cn

make build 完成后,二进制位于 server/bin/backupx,构建好的 Web UI 位于 web/dist/

验证安装

backupx --version           # 输出如 v1.6.0

打开浏览器访问 http://your-server:8340,会进入初始化管理员账户页面。