# @anubus298/medusa-backup 中文文档

规范地址：https://npmcn.com/package/%40anubus298/medusa-backup/

版本：1\.6\.6
npm 元数据更新时间：2025-11-15T00:27:31.075Z
中文译文更新时间：2026-11-06T07:25:57.820Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40anubus298/medusa-backup
原文对照：https://npmcn.com/package/%40anubus298/medusa-backup/?lang=original
项目主页：https://github.com/anubus298/medusa-backup#readme
源码仓库：https://github.com/anubus298/medusa-backup

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：103 kB，14 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2025-09-12T02:45:57.941Z
- 最新版本发布：2025-11-15T00:27:30.889Z
- 近 30 天下载量：22210（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 2 个）

## 中文简介

用于 Medusa.js 的 DB 备份和还原, 叉, 优化并兼容 medusa v2. 10+

## 安装

```sh
npm install @anubus298/medusa-backup
```

也可以使用：`pnpm add @anubus298/medusa-backup`、`yarn add @anubus298/medusa-backup`、`bun add @anubus298/medusa-backup`

## README

# Medusa 备份( 伪造并增强)

![Medusa backup logo](https://raw.githubusercontent.com/anubus298/medusa-backup/main/metadata/icon_medusa_backup.svg)

# 美杜莎备份(强化分叉)

Medusa v2.10+ 数据库备份插件,可靠性得到提高

* * *

## 这叉子有什么新鲜事

这个项目是一个叉子 [AmeerRizvi/medusa 备份](https://github.com/AmeerRizvi/medusa-backup),经过更新和优化,并作出以下改进:

-   ✅与完全相容 **美杜莎 v2.10+ (英语)**
-   ✅ **自动回滚** 如果备份在中途失败,数据库将安全恢复到先前状态

* * *

## \* 安装

如果在 npm 范围内发布(例如: `@anubus298/medusa-backup`:

```bash
npm i @anubus298/medusa-backup
```

或直接从 GitHub 安装:

```bash
npm install github:anubus298/medusa-backup
```

* * *

## QQ 配置

### `medusa.config.ts`

```ts
module.exports = defineConfig({
  ...,
  plugins: [
    {
      resolve: "@anubus298/medusa-backup",
      options: {},
    },
  ],
})
```

运行数据库迁移 :

```bash
npx medusa db:migrate
```

* * *

## 环境变量

默认设置 :

```dotenv
DATABASE_URL=postgres://[USERNAME]:[PASSWORD]@[HOST]/[DB]
```

如果将 DB 基础和名称分开:

```dotenv
DB_BASE=postgres://[USERNAME]:[PASSWORD]@[HOST]
DB_NAME=[DB]
```

* * *

## 所需经费

-   **PostgreSQL 客户端 (pg dump)** 必须安装 :
    
    ```bash
    pg_dump --version
    ```
    
-   **S3 配置** 必须按 [美杜莎文件](https://docs.medusajs.com/resources/architectural-modules/file/s3#content)。 。 。 .
    

示例 S3 配置在 `medusa.config.ts`数字 :

```ts
module.exports = defineConfig({
  modules: [
    {
      resolve: "@medusajs/medusa/file",
      options: {
        providers: [
          {
            resolve: "@medusajs/medusa/file-s3",
            id: "s3",
            options: {
              file_url: process.env.S3_FILE_URL,
              access_key_id: process.env.S3_ACCESS_KEY_ID,
              secret_access_key: process.env.S3_SECRET_ACCESS_KEY,
              region: process.env.S3_REGION,
              bucket: process.env.S3_BUCKET,
              endpoint: process.env.S3_ENDPOINT,
              prefix: "resources/",
            },
          },
        ],
      },
    },
  ],
})
```

* * *

## 自动备份

启用自动备份 `.env`数字 :

```dotenv
DB_BACKUP_AUTO=true
```

默认时间表 : **每日凌晨1点**。 。 。 . 定制 CRON :

```dotenv
DB_BACKUP_SCHEDULE="0 1 * * *"
```

详情见 [古鲁语](https://crontab.guru/)。 。 。 . QQ 自动备份运行 **仅生产**。 。 。 .

## 页:1

-   备份被压缩(~70%较小).
-   后援失败现在通过回滚支持得到优雅的处理.
-   PostgreSQL 版本应匹配已安装的 `pg_dump` 财务报告和审定财务报表 `psql` 工具.
-   安全地将生产备份恢复到本地环境进行测试.

* * *

## QQ 更改日志

### v2.10.x+ (韩语)

-   添加与美杜莎 v2.10+的相容性
-   为失败的备份引入回滚机制
-   备份创建的优化性能

* * *

## • 信贷

从 [AmeerRizvi/medusa 备份](https://github.com/AmeerRizvi/medusa-backup)。 。 。 . 非常感谢原作者为这个插件打下基础.

* * *

## 常见问题

### @anubus298/medusa-backup 是什么？

用于 Medusa\.js 的 DB 备份和还原, 叉, 优化并兼容 medusa v2\. 10\+

### 如何安装 @anubus298/medusa-backup？

在项目目录运行 npm install @anubus298/medusa-backup，或使用 pnpm add / yarn add / bun add。

### @anubus298/medusa-backup 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/anubus298\_\_medusa-backup 是否存在。

### @anubus298/medusa-backup 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @anubus298/medusa-backup 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @anubus298/medusa-backup 可以商用吗？

@anubus298/medusa-backup 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @anubus298/medusa-backup 的下载量有多少？

根据 npm 官方下载统计，@anubus298/medusa-backup 在 2026/10/06 – 2026/11/04 这 30 天内被下载 22,210 次，日均约 740 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @anubus298/medusa-backup 还在维护吗？

最新版本 1\.6\.6 发布于 2025/11/15（11 个月前）；至今共发布 7 个版本，其中过去 12 个月发布了 2 个；首次发布于 2025/09/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。