Files
BackupX/docs-site/i18n/zh-CN/docusaurus-plugin-content-docs/current/getting-started/installation.md
Wu Qing 66373fa8e4 修复: 中文 i18n 目录名从 zh-Hans 改为 zh-CN,首页 SSR 翻译现已生效 (#42)
Docusaurus 3.10 会把 locale id 'zh-Hans' 规范化为 BCP 47 的 'zh-CN' 来
读取 i18n/ 目录。之前手工创建的 i18n/zh-Hans/ 目录 Docusaurus 识别不到,
导致中文版 SSR 输出仍是英文字符串,只有 URL 路由 /zh-Hans/ 生效。

同时修复 index.tsx 中 <Translate id={labelId}> 动态 id 问题:
write-translations 工具要求静态字符串,已拆分为三个独立的 Translate 元素。
2026-04-17 13:52:16 +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,会进入初始化管理员账户页面。