# 使用 Homebrew 安装 imap-backup

查看 imap-backup 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:imap-backup
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install imap-backup
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:imap-backup
- **软件包管理器:** Homebrew
- **版本:** 16.6.0
- **来源摘要:** Backup GMail (or other IMAP) accounts to disk
- **主页:** <https://github.com/joeyates/imap-backup>
- **仓库:** <https://github.com/joeyates/imap-backup>
- **最后更新:** 2026-06-06T17:04:39Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- imap-backup (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 16.6.0
## 项目历史与用法

imap-backup is a Ruby command-line tool for backing up and migrating IMAP email accounts to local disk. It targets Gmail and other IMAP services, storing messages in mboxrd files with companion metadata.

### 项目历史

The RubyGems version history shows `imap-backup` beginning with 0.0.1 in 2012 and reaching 1.0.0 in early 2013. The project's developer documentation states design goals of secure local configuration, restartable operation, and independence from a mail client or MTA.

The tool has grown from basic account backup into a broader IMAP maintenance utility. Recent changelog entries document download strategies, Thunderbird export improvements, configuration-free single-account backups, container images, a consolidated `copy` command replacing older migration and mirror flows, account locking, metadata migrations, and internationalization.

### 采用历史

imap-backup is distributed as a RubyGem and as a Homebrew formula. RubyGems download counts are much higher than Homebrew installs, which fits a Ruby CLI whose main package channel is the gem ecosystem, while Homebrew gives Mac and Linux users a convenient binary-package entry point.

The package's adoption comes from a durable personal-infrastructure problem: IMAP accounts need local, restartable, scriptable backups without coupling the archive to a desktop mail client. Its docs also cover migration and restore operations, so the tool is used for both preservation and moving mail between providers.

### 使用方式

`imap-backup setup` creates configuration, and `imap-backup backup` copies messages for configured accounts to disk. The backup command is incremental and interruptible, and stores email in mboxrd files with IMAP metadata containing offsets and message lengths.

The config documentation records the default path as `~/.imap-backup/config.json` and warns that usernames and passwords are stored in plain text there, with permissions set on Unix-like systems. Other commands include restore, copy, and single-account backup flows, with performance settings for delayed metadata writes and multi-fetch size.

### 为什么软件包爱好者会关心

imap-backup is package-nerd significant because it turns email portability into a boring CLI workflow. It also demonstrates the tradeoffs of local-first backup tools: plain JSON configuration, mboxrd serialization, metadata version migrations, locking, and careful restart behavior matter more than a large service backend.

### 时间线

- 2012: imap-backup 0.0.1 was published to RubyGems.
- 2013: imap-backup 1.0.0 was published to RubyGems.
- 2022: The changelog records backup flags, mirror mode, stats, and provider-specific backup fixes in the 6.x and 7.x lines.
- 2023: Version 14.0.0 added configuration-free single-account backups, and 14.3.0 added container images.
- 2024: Version 16.0.0 added the `copy` command and deprecated older migrate/mirror commands.
- 2026: The 16.x and 17.0.0.rc0 lines added localization, account locking, metadata migration, and mboxrd serialization fixes.

### Related projects

- imap-backup is related to IMAP synchronization and archival tools such as isync/mbsync and offline mail workflows, but its docs emphasize local mboxrd backups plus restore/copy operations rather than maintaining a live Maildir mirror.

### 来源

- <https://formulae.brew.sh/api/formula/imap-backup.json>
- <https://github.com/joeyates/imap-backup>
- <https://raw.githubusercontent.com/joeyates/imap-backup/main/CHANGELOG.md>
- <https://raw.githubusercontent.com/joeyates/imap-backup/main/docs/commands/backup.md>
- <https://raw.githubusercontent.com/joeyates/imap-backup/main/docs/files/config.md>
- <https://rubygems.org/api/v1/gems/imap-backup.json>
- <https://rubygems.org/api/v1/versions/imap-backup.json>


## 安全说明

broad file, network, media, or database tool signal.

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.imap-backup/config.json

## Credential files

- Unix: ~/.imap-backup/config.json

## Combined YAML source

View the package source record on GitHub. [combined/imap-backup.yml](https://github.com/mxcl/pkgdb/blob/main/combined/imap-backup.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
