Files
2026-07-13 10:17:31 +00:00

7.7 KiB
Raw Permalink Blame History

Note

本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

gopass Gopher by Vincent Leinweber, remixed from the Renée French original Gopher

概述

OpenSSF Scorecard Build Status Go Report Card Packaging status MIT License Github All Releases Gopass Slack

面向团队的、稍胜一筹的标准 UNIX 密码管理器。

轻松管理你的凭据。适用于全球分布式团队、多台设备,或在完全离线的气隙(air-gapped)机器上。

  • 随处可用 - 在 Linux、MacOS、*BSD 或 Windows 上提供一致的用户体验
  • 为团队而生 - 基于我们在分布式开发团队中的实践经验构建
  • 完全自主 - 无需网络连接,除非你主动需要

工作原理?

Gopass 是 pass(标准 UNIX 密码管理器)的直接替代品(drop-in replacement)。 默认情况下,你的凭据使用 GPG 加密并通过 git 进行版本管理。这可以轻松自定义。 也提供其他加密后端(例如 age)和存储后端(例如 fossil)。 主要界面是命令行,因此非常适合 CLI 爱好者、CI/CD 系统, 或任何你能接入它的场景。Gopass 也可与浏览器集成,这样你基本可以 避免使用命令行——如果你愿意的话。

安装

运行 gopass 的必要前提条件

gopass 可在无任何依赖的情况下运行,但大多数用户会配合 gpggit 使用。 使用 gopass edit 需要外部编辑器。

通过包管理器安装

Homebrew (Linux/MacOS)

homebrew version

brew install gopass

MacPorts (macOS)

macports version

sudo port install gopass

DebianUbuntu、Debian、Raspbian 等)

警告:请勿从官方软件源安装 gopass 软件包。那是与我们毫无关系的完全不同的项目。

curl https://packages.gopass.pw/repos/gopass/gopass-archive-keyring.gpg | sudo tee /usr/share/keyrings/gopass-archive-keyring.gpg >/dev/null
cat << EOF | sudo tee /etc/apt/sources.list.d/gopass.sources
Types: deb
URIs: https://packages.gopass.pw/repos/gopass
Suites: stable
Architectures: all amd64 arm64 armhf
Components: main
Signed-By: /usr/share/keyrings/gopass-archive-keyring.gpg
EOF
sudo apt update
sudo apt install gopass gopass-archive-keyring

Fedora / RedHat / CentOS

Fedora version

dnf install gopass

注意:你可能需要先运行 dnf copr enable daftaupe/gopass

Arch Linux

Arch version

pacman -S gopass

Windows

Scoop version

# WinGet
winget install Git.Git
winget install GnuPG.Gpg4win
winget install gopass.gopass
# Chocolatey
choco install gpg4win
choco install gopass
# Alternatively
scoop install gopass

FreeBSD / OpenBSD

cd /usr/ports/security/gopass
make install

Alpine Linux

apk add gopass

其他安装方式

请参阅 docs/setup.md 了解其他选项。

从源码安装

go install github.com/gopasspw/gopass@latest

注意:latest 不是稳定版本。我们建议仅使用已发布的版本。

手动下载

下载最新版本,并将二进制文件添加到你的 PATH。

快速入门指南

初始化新的 gopass 配置:

gopass setup

   __     _    _ _      _ _   ___   ___
 /'_ '\ /'_'\ ( '_'\  /'_' )/',__)/',__)
( (_) |( (_) )| (_) )( (_| |\__, \\__, \
'\__  |'\___/'| ,__/''\__,_)(____/(____/
( )_) |       | |
 \___/'       (_)

🌟 Welcome to gopass!
🌟 Initializing a new password store ...
🌟 Configuring your password store ...
🎮 Please select a private key for encrypting secrets:
[0] gpg - 0xFEEDBEEF - John Doe <john.doe@example.org>
Please enter the number of a key (0-12, [q]uit) (q to abort) [0]: 0
❓ Do you want to add a git remote? [y/N/q]: y
Configuring the git remote ...
Please enter the git remote for your shared store []: git@gitlab.example.org:john/passwords.git
✅ Configured

默认情况下,gopass setup 将使用 gpg 加密和 git 存储。这会在 $HOME/.local/share/gopass/stores/root 中创建新的密码库,并在 $HOME/.config/gopass/config 中创建配置,使用 gpg 加密和 git 进行版本化存储。用户可通过例如 --crypto=age 覆盖这些设置,改用 age 加密,或使用 --storage=fs 选择不使用版本化存储。

可使用例如 gopass clone git@gitlab.example.org:john/passwords.git 克隆现有存储库。

创建新密钥:

gopass create

列出所有现有密钥:

gopass ls

将现有密码复制到剪贴板:

gopass show -c foo

删除现有密钥:

gopass rm foo

其他示例:

# Command structure
gopass [<command>] [options] [args]
# Shortcut for gopass show [<key>]
gopass [<key>]

# Enter the gopass REPL
gopass

# Find all entries matching the search string
gopass find github

# List your store
gopass ls

# List all mounts
gopass mounts

# List all recipients
gopass recipients

# Sync with all remotes
gopass sync

# Setup a new store
gopass setup

截图

screenshot

支持

请在 Slack. 上提问。

贡献

我们欢迎任何贡献。请参阅 CONTRIBUTING.md 了解更多信息。

致谢与许可证

gopass 根据 MIT 许可证条款授权。完整文本见 LICENSE.

请参阅我们的贡献者 页面,查看完整的贡献者列表。