Documentation
¶
Overview ¶
Package certs 处理主控 push_cert 下发的 TLS 证书落盘。
约定(05 号文档 §4):落盘 `/etc/xray/certs/<domain>/{fullchain.pem,key.pem}`, fullchain 0644、key 0600,原子写;xray 默认每小时热重载证书文件,换证不重启。 证书/私钥校验与解析在共享包 pkg/tlscert(主控 certs API 同源)。
Index ¶
- func CAPath(dir string, id uint64) string
- func SanitizeDomain(domain string) string
- func SyncManaged(dir string, domains []string) ([]string, error)
- func ValidatePair(certPEM, keyPEM string) error
- func Write(dir, domain, certPEM, keyPEM string) error
- func WriteCA(dir string, id uint64, certPEM string) (string, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CAPath ¶ added in v0.2.0
CAPath CA 根证书的固定落盘路径:<certs_dir>/ca/<id>.crt。 主控按同一约定生成出站配置的 certificateFile(见 contracts.CACertPath)。
func SyncManaged ¶ added in v0.2.0
SyncManaged 清理 <dir> 下不再被引用的托管证书目录,返回被删除的域名列表。
只处理同时满足以下条件的子目录,避免误删人工放置的东西:
- 目录名是合法域名(DomainRe);
- 不是 ca/(CA 公钥由 push_ca 管理,另有生命周期);
- 目录内存在 fullchain.pem(即 push_cert 写出的布局)。
domains 是主控当前仍引用的域名全集;缺省/空集合表示"没有任何证书被引用", 此时会清掉全部托管目录(解绑/删除后的正常 GC 行为)。
Types ¶
This section is empty.
Click to show internal directories.
Click to hide internal directories.