# singbox-cert-update

**Repository Path**: rymaker/singbox-cert-update

## Basic Information

- **Project Name**: singbox-cert-update
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AFL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-11
- **Last Updated**: 2026-07-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sing-box Cert Manager

一个基于 Electron、TypeScript 和 Vite 的 sing-box 固定证书更新工具。

## 功能

- 扫描 `outbounds[].tls.certificate` 内嵌证书
- 展示 SHA-256 指纹和证书到期时间
- TCP TLS 使用 Node.js 原生 TLS 获取证书链
- TUIC、Hysteria 等 QUIC 出站通过支持 QUIC 的 OpenSSL 获取证书链
- 更新前预览，单节点失败不影响其他节点
- 文件锁、临时文件刷盘、备份轮转和原子替换
- 可选运行 `sing-box check`，可选 reload/restart Systemd 服务
- 高级设置里一键检查/下载最新版 sing-box（从 GitHub Release 拉取，自动安装到用户数据目录）
- 支持把当前配置文件导出（另存为）到任意位置，方便部署到远程服务器或留存快照

## 开发

```powershell
npm install
npm run dev
```

构建和测试：

```powershell
npm test
npm run package
```

## QUIC 前置条件

QUIC 节点需要一个支持 `s_client -quic` 的 OpenSSL 可执行文件。Windows x64 已内置一份（见 `resources/openssl/`），首次启动会自动填入「高级设置 → OpenSSL 路径」，无需额外安装；其他平台请自行安装支持 QUIC 的 OpenSSL 并填写路径。普通系统 OpenSSL 如果未编译 QUIC 支持，会在对应节点上显示检查失败，但不会中断其他节点。

`sing-box` 路径留空时会跳过配置预检。生产环境建议明确配置路径，确保临时配置通过 `sing-box check -c` 后再替换正式文件——可在「高级设置」里点击下载图标一键获取最新版 sing-box。

## 安全说明

抓取时刻意跳过远端证书验证，因为工具需要取得尚未被本地信任的新证书。应用更新前应核对界面显示的新 SHA-256 指纹。工具会在提交时重新读取并核对原配置，防止预览后文件变化造成误写。