1password/connect-api1Password Connect是一个提供REST API的服务器,用于安全访问1Password账户中的敏感数据(如密码、密钥、证书等)。它支持构建Secrets Automation Workflow,使应用程序、服务或自动化流程能够通过API安全地管理和获取敏感信息,避免硬编码或不安全存储敏感数据。
connect-sync容器实时同步服务器数据与1Password.com,确保数据一致性适用于需在系统或应用中安全集成敏感信息的场景,包括但不限于:
使用1Password命令行工具(op)设置Connect服务器并生成访问令牌,用于服务器部署和API认证。
创建Connect服务器
shop create connect server <服务器名称> --vaults <vault>[,<vault>]
执行后将生成1password-credentials.json文件(包含服务器凭证),需妥善保存用于后续部署。
生成访问令牌
shop create connect token <服务器名称> <令牌名称> --vault <vault_uuid>[,(r|w|rw)] [--vault <vault_uuid>[,(r|w|rw)]]
<vault_uuid>:指定授权访问的Vault UUIDr(只读)、w(只写)、rw(读写),可通过多个--vault参数配置多个Vault权限部署1Password Connect需同时运行两个容器,二者协同工作:
1password/connect-sync:负责同步1Password.com数据至本地服务器1password/connect-api:提供REST API服务,响应客户端请求以下环境变量可用于配置容器行为:
通用配置(connect-sync和connect-api均适用)
OP_SESSION:1password-credentials.json文件路径,默认值为~/.op/1password-credentials.jsonOP_HTTP_PORT:HTTP服务器监听端口,默认值为8080OP_LOG_LEVEL:日志级别,默认值为info(可选值:debug、info、warn、error)仅connect-api适用配置
OP_HTTPS_PORT:TLS启用时的HTTPS服务器端口,默认值为8443OP_SYNC_TIMEOUT:初始数据同步超时时间,默认值为10s为增强API通信安全性,可启用TLS加密,支持以下两种方式:
使用自有证书
为connect-api容器设置以下环境变量,指定PEM编码的证书和私钥:
OP_TLS_KEY_FILE:私钥文件路径(PEM格式)OP_TLS_CERT_FILE:证书文件路径(需包含完整证书链,PEM格式)使用Let's Encrypt自动获取证书
为connect-api容器设置以下环境变量,从Let's Encrypt CA自动申请和续期证书:
OP_TLS_USE_LETSENCRYPT:设置为任意值以启用该功能OP_TLS_DOMAIN:目标域名(需确保DNS记录指向Connect服务器)注意:Let's Encrypt证书续期需Connect的HTTPS监听器通过公网IP的443端口访问,可通过设置OP_HTTPS_PORT=443或端口转发实现。

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务