gopass 技能

gopass 是一款面向团队的命令行密码管理器，基于 GPG 和 Git 构建。

前提条件

• 已安装 gopass 二进制程序
• 已配置可用的 GPG 密钥（gopass 使用 GPG 进行加密）
• 密码库已初始化（执行 gopass init 或 gopass setup）

常用操作

列出密钥项

gopass ls
gopass ls -f          # 平铺列表模式

查看密钥项

gopass show path/to/secret           # 显示完整条目（密码 + 元数据）
gopass show -o path/to/secret        # 仅显示密码
gopass show -c path/to/secret        # 复制到剪贴板
gopass show path/to/secret key       # 显示指定字段

创建 / 更新密钥项

gopass insert path/to/secret         # 交互式输入
gopass edit path/to/secret           # 在 $EDITOR 中打开编辑
echo "mypassword" | gopass insert -f path/to/secret   # 非交互式插入

在首行（密码）下方添加键值对形式的元数据：

mysecretpassword
username: erdGecrawl
url: https://github.com
notes: Created 2026-01-31

生成密码

gopass generate path/to/secret 24           # 生成 24 位密码
gopass generate -s path/to/secret 32        # 含符号的 32 位密码
gopass generate --xkcd path/to/secret 4     # 生成口令短语（4 个单词）

删除

gopass rm path/to/secret
gopass rm -r path/to/folder          # 递归删除目录

移动 / 复制

gopass mv old/path new/path
gopass cp source/path dest/path

搜索

gopass find github                   # 按条目名称搜索
gopass grep "username"               # 按条目内容搜索

密码库管理

初始化

gopass setup                         # 引导式首次配置
gopass init                  # 使用指定 GPG 密钥初始化

挂载子密码库

gopass mounts add work /path/to/work-store
gopass mounts remove work
gopass mounts                        # 列出所有挂载点

同步（git push/pull）

gopass sync

接收者（团队访问权限）

gopass recipients                    # 列出当前接收者
gopass recipients add 
gopass recipients remove 

TOTP

gopass otp path/to/secret            # 显示当前 TOTP 动态码

在条目正文中以 totp: otpauth://totp/... 格式存储 TOTP URI。

非交互式使用提示

• 使用 echo "pw" | gopass insert -f path 实现脚本化插入
• 使用 gopass show -o path 获取仅含密码、适合机器解析的输出
• 使用 gopass show -f path 抑制警告信息
• 设置环境变量 GOPASS_NO_NOTIFY=true 以禁用桌面通知
• 使用 gopass --yes 自动确认所有交互提示