1password/connect-api Docker Image Overview

1password/connect-api

1Password Connect服务器提供REST API，用于安全访问1Password账户数据，支持构建Secrets Automation Workflow，通过API安全管理和获取密码、密钥等敏感信息。

15 收藏0 次下载active1password镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

1Password Connect

镜像概述和主要用途

1Password Connect是一个提供REST API的服务器，用于安全访问1Password账户中的敏感数据（如密码、密钥、证书等）。它支持构建Secrets Automation Workflow，使应用程序、服务或自动化流程能够通过API安全地管理和获取敏感信息，避免硬编码或不安全存储敏感数据。

核心功能和特性

REST API服务：提供标准化API接口，支持安全查询、获取1Password账户中的敏感数据
数据同步机制：通过connect-sync容器实时同步服务器数据与1Password.com，确保数据一致性
细粒度权限控制：通过访问令牌实现Vault级别的权限管理（读/写/读写），限制API访问范围
TLS加密支持：可配置TLS保护API通信，支持自有证书或Let's Encrypt自动获取证书
多环境部署：支持Docker Compose、Kubernetes、Helm、AWS ECS等多种部署方式

使用场景和适用范围

适用于需在系统或应用中安全集成敏感信息的场景，包括但不限于：

CI/CD流水线：在自动化部署流程中动态获取API密钥、数据库密码等
应用配置：从1Password动态加载应用运行所需的敏感配置参数
服务集成：供内部服务通过API安全获取第三方服务凭证
多团队协作：统一管理团队敏感信息，通过权限控制实现安全共享

使用方法和配置说明

快速开始

创建服务器和访问令牌

使用1Password命令行工具（op）设置Connect服务器并生成访问令牌，用于服务器部署和API认证。

创建Connect服务器

sh
op create connect server <服务器名称> --vaults <vault>[,<vault>]

执行后将生成1password-credentials.json文件（包含服务器凭证），需妥善保存用于后续部署。

生成访问令牌

sh
op create connect token <服务器名称> <令牌名称> --vault <vault_uuid>[,(r|w|rw)] [--vault <vault_uuid>[,(r|w|rw)]]

参数说明：
- <vault_uuid>：指定授权访问的Vault UUID
- 权限标识：r（只读）、w（只写）、rw（读写），可通过多个--vault参数配置多个Vault权限

部署Connect服务器

部署1Password Connect需同时运行两个容器，二者协同工作：

1password/connect-sync：负责同步1Password.com数据至本地服务器
1password/connect-api：提供REST API服务，响应客户端请求

部署示例

Helm
Docker Compose
Kubernetes Manifest
AWS Elastic Container Service

服务器配置

环境变量配置

以下环境变量可用于配置容器行为：

通用配置（connect-sync和connect-api均适用）

OP_SESSION：1password-credentials.json文件路径，默认值为~/.op/1password-credentials.json
OP_HTTP_PORT：HTTP服务器监听端口，默认值为8080
OP_LOG_LEVEL：日志级别，默认值为info（可选值：debug、info、warn、error）

仅connect-api适用配置

OP_HTTPS_PORT：TLS启用时的HTTPS服务器端口，默认值为8443
OP_SYNC_TIMEOUT：初始数据同步超时时间，默认值为10s

TLS配置

为增强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或端口转发实现。

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录仓库拉取

通过 Docker 登录认证访问私有仓库

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

Docker Compose

Docker Compose 项目配置

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

宝塔面板

在宝塔面板一键配置镜像

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

极空间

极空间 NAS 系统配置服务

爱快路由

爱快 iKuai 路由系统配置

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

专属域名拉取

无需登录使用专属域名

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 访问，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像支持哪些镜像仓库？

专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等；免费版仅支持 docker.io。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"