跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

故障排除

最后更新 查看 MarkdownAgent 设置

检查日志

要检查日志,使用类似以下的命令。

  • systemd:sudo journalctl -f -u gokeyless
  • upstart/sysvinit:sudo tail -f /var/log/gokeyless.log

启用调试日志

要启用调试日志,使用类似以下的命令。

cd /etc/keyless
sudo -u keyless gokeyless --loglevel 0

在容器中运行时,gokeyless 是容器的主进程(PID 1),因此上述主机/systemd 命令不适用。请改为在启动容器时设置日志级别,并从容器运行时读取日志:

# Set verbosity via environment variable
docker run ... -e KEYLESS_LOGLEVEL=0 ghcr.io/cloudflare/gokeyless:latest

# Read logs
docker logs -f <CONTAINER>   # or: kubectl logs -f <POD>

浏览器在尝试连接后看到 TLS 连接失败

  1. 确保您的密钥服务器可从网络外部访问(tcp/2407)。
  2. 提供数据包捕获: sudo tcpdump -nni <interface> -s 0 -w keyless-$(date +%s).pcap port 2407

客户端正在连接,但立即中止

如果您在启用调试日志的情况下运行 gokeyless,并看到如下日志:

[DEBUG] connection 162.158.57.220:37490: reading half closed by client
[DEBUG] connection 162.158.57.220:37490: server closing connection
[DEBUG] connection 162.158.57.220:37490 removed
[DEBUG] spawning new connection: 162.158.57.220:37862
[DEBUG] connection 162.158.57.220:37862: reading half closed by client
[DEBUG] connection 162.158.57.220:37862: server closing connection
[DEBUG] connection 162.158.57.220:37862 removed

这些日志通常表示密钥服务器未使用合适的服务器文件或 .PEM 文件,导致客户端在证书交换后中止连接。证书必须由 keyless CA 签署,而且 SAN 必须包含密钥服务器的主机名。以下是位于 11aa40b4a5db06d4889e48e2f.example.com 的密钥服务器的有效示例(注意使用者备用名称和授权密钥标识符):

openssl x509 -in server.pem -noout -text -certopt no_subject,no_header,no_version,no_serial,no_signame,no_validity,no_subject,no_issuer,no_pubkey,no_sigdump,no_aux | sed -e 's/^        //'
X509v3 extensions:
    X509v3 Key Usage: critical
        Digital Signature, Key Encipherment
    X509v3 Extended Key Usage:
        TLS Web Server Authentication
    X509v3 Basic Constraints: critical
        CA:FALSE
    X509v3 Subject Key Identifier:
        DD:24:97:F1:A9:F1:4C:73:D9:1B:44:EC:A1:C3:10:E9:F0:41:98:BB
    X509v3 Authority Key Identifier:
        keyid:29:CE:8F:F1:9D:4C:BA:DE:55:78:D7:A6:29:E9:C5:FD:1D:9D:21:48

    X509v3 Subject Alternative Name:
        DNS:11aa40b4a5db06d4889e48e2f.example.com
    X509v3 CRL Distribution Points:

        Full Name:
          URI:http://ca.cfdata.org/api/v1/crl/key_server

gokeyless 二进制文件无法加载 CA 文件

确保服务器上安装的所有密钥和证书的权限正确。

Keyless 影响意外主机

您需要仅为这些主机提供证书,或在 Cloudflare 仪表板的 SSL/TLS 应用中更改证书的优先级。

Windows 上的密钥服务器

Cloudflare 目前仅为 Cloudflare 软件包仓库 ↗中支持的分发版提供软件包。

但是,密钥服务器是开源的,因此您可以尝试构建和部署二进制文件,但在 Windows 上运行不是受支持的配置,您可能会遇到 Cloudflare 无法帮助解决的问题。

密钥服务器多域名支持

单个密钥服务器可以为多个域名提供服务。请将每个证书的私钥添加到 gokeyless.yaml 中的 private_key_stores 块,或通过 --private-key-dirs / --private-key-files 传入。详情参见提供多个私钥。

hostname 和 zone_id 字段都是单个字符串值,仅用于注册。添加其他域名时无须更新。

其他问题

联系您的账户团队或 Cloudflare 支持团队。

这篇文档对您有帮助吗?