Genyleap/Docs
OpenProof / 安装

从全新服务器到可运行的身份服务。

打包的 installer 会处理 release package、PostgreSQL、加密材料、首个 owner、邮件投递、provider、Nginx、TLS 与最终健康检查。

快速安装

shell推荐
curl -fsSL https://genyleap.com/install/openproof | sudo sh

bootstrap endpoint 会检测支持的操作系统与 CPU 架构，下载匹配的预构建 OpenProof bundle，并根据已发布的 SHA-256 manifest 进行校验。production installer 绝不会安装 compiler，也不会静默回退到 source build；如果没有匹配且已验证的 bundle，安装会明确失败。

Ubuntu 24.04+Debian 13+AMD64ARM64systemd

wizard 会配置什么

01

Identity origin

选择公开 domain、组织 identity 与初始 owner account。

02

PostgreSQL 与 secrets

安装本地数据库或连接已有数据库。OpenProof 会以受限 filesystem permission 生成 signing、encryption、pepper 与 audit secret。

03

邮件投递

使用已认证的 SMTP relay、直接 Postfix、已有 HTTPS delivery webhook，或者稍后配置投递。

04

认证提供商

只选择需要的 provider。随后 wizard 会要求对应的 Client ID、Client Secret、API key 或 RPC 配置。

05

TLS 与 ingress

使用 Let’s Encrypt 配置 Nginx、使用已有证书，或者将 OpenProof 放在外部 HTTPS ingress 后面。

06

验证

setup 完成前会检查 configuration、systemd、local readiness 与 public identity origin。

Provider credential

每个 redirect provider 都使用从 identity domain 推导出的 callback：

callback在上游注册
https://identity.example.com/auth/federated/callback
提供商setup 需要
GoogleClient ID + Client Secret
GitHubClient ID + Client Secret
MicrosoftTenant ID + Client ID + Client Secret
AppleServices ID + client-secret JWT
LinkedInClient ID + Client Secret
TelegramClient ID + Client Secret
XAPI Key + API Secret
Ethereum可选 smart-wallet RPC mapping
FarcasterOptimism RPC endpoint

credential 会存放在公开 configuration 与 repository 之外。未选择的 provider 保持未配置状态。

邮件投递

OpenProof 会创建并验证 verification challenge，但消息投递仍位于独立的已认证边界之后。

流程投递边界
OpenProof
    ↓
authenticated delivery adapter
    ↓
SMTP / Postfix / your HTTPS webhook
    ↓
user inbox
直接邮件投递需要在 installer 之外完成 DNS 配置。

如果选择直接 Postfix 投递，请为发件 domain 配置 PTR/rDNS、SPF、DKIM 与 DMARC。installer 可以配置本地服务，但公开 DNS 与 provider 控制仍由 operator 负责。

安装选项

shell仅 package
curl -fsSL https://genyleap.com/install/openproof | \
  sudo sh -s -- --no-setup

sudo openproof setup
shell指定版本
curl -fsSL https://genyleap.com/install/openproof | \
  sudo sh -s -- --version 1.1.0
shellrelease candidate
curl -fsSL https://genyleap.com/install/openproof | \
  sudo sh -s -- --channel rc

安装后

shell管理
sudo openproof status
sudo openproof doctor
sudo openproof config
sudo openproof config providers
sudo openproof update
sudo openproof backup /var/backups/openproof.dump
更改后请运行 doctor。

openproof doctor 会检查 binary、configuration、service state、PostgreSQL、Nginx、local/public readiness 与 OIDC discovery。