mirror of
https://github.com/Awuqing/BackupX.git
synced 2026-05-31 16:59:40 +08:00
66373fa8e4
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 元素。
84 lines
2.3 KiB
Markdown
84 lines
2.3 KiB
Markdown
---
|
||
sidebar_position: 1
|
||
title: 开发环境
|
||
description: 搭建 BackupX 本地开发环境 — 后端、前端、测试。
|
||
---
|
||
|
||
# 开发环境
|
||
|
||
**环境要求：** Go ≥ 1.25，Node.js ≥ 20，npm。
|
||
|
||
## 克隆与依赖
|
||
|
||
```bash
|
||
git clone https://github.com/Awuqing/BackupX.git && cd BackupX
|
||
cd web && npm install && cd ..
|
||
```
|
||
|
||
## 开发服务
|
||
|
||
开两个终端分别跑后端和前端：
|
||
|
||
```bash
|
||
# 终端 1：后端，监听 :8340
|
||
make dev-server
|
||
|
||
# 终端 2：Vite HMR，监听 :5173
|
||
make dev-web
|
||
```
|
||
|
||
Vite 配置了 `/api` 代理到 `http://127.0.0.1:8340`，浏览器直接访问 `http://localhost:5173`。
|
||
|
||
## 测试
|
||
|
||
```bash
|
||
make test # 运行 Go + Web 全部测试
|
||
make test-server # 仅 Go
|
||
make test-web # 仅 Vitest
|
||
```
|
||
|
||
## 生产构建
|
||
|
||
```bash
|
||
make build # server/bin/backupx + web/dist
|
||
make docker # Docker 镜像
|
||
make docker-cn # 国内镜像加速构建
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
| 组件 | 技术 |
|
||
|------|------|
|
||
| **后端** | Go · Gin · GORM · SQLite · robfig/cron · rclone |
|
||
| **前端** | React 18 · TypeScript · ArcoDesign · Vite · Zustand · ECharts |
|
||
| **存储** | rclone（70+ 后端）· AWS SDK v2 · Google Drive API v3 |
|
||
| **安全** | JWT · bcrypt · AES-256-GCM |
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
BackupX/
|
||
├── server/ # Go 后端
|
||
│ ├── cmd/backupx/ # 入口 + 子命令（agent / backint / reset-password）
|
||
│ ├── internal/
|
||
│ │ ├── agent/ # Agent CLI 逻辑
|
||
│ │ ├── app/ # 装配（repo → service → handler）
|
||
│ │ ├── backup/ # 备份 runner（file / mysql / postgres / sqlite / saphana）
|
||
│ │ ├── backint/ # SAP HANA Backint 协议
|
||
│ │ ├── http/ # HTTP handler + router
|
||
│ │ ├── model/ # GORM 模型
|
||
│ │ ├── repository/ # 数据访问
|
||
│ │ ├── service/ # 业务逻辑
|
||
│ │ └── storage/ # 存储 provider（rclone + 直接 SDK）
|
||
│ └── pkg/ # 通用工具
|
||
├── web/ # React 前端（Vite）
|
||
│ └── src/
|
||
│ ├── components/
|
||
│ ├── pages/
|
||
│ ├── services/
|
||
│ └── types/
|
||
├── docs-site/ # 文档站（Docusaurus）
|
||
├── deploy/ # install.sh / systemd unit / nginx config
|
||
└── Makefile
|
||
```
|