# certflow

**Repository Path**: dtapps/certflow

## Basic Information

- **Project Name**: certflow
- **Description**: SSL 证书管理工具，支持证书申请、续期、过期监控等功能。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: wails3, wails

## README

# CertFlow

[English](README_EN.md) | 中文

SSL 证书管理工具，支持证书申请、续期、过期监控等功能。

采用 Go + Vue 3 跨平台桌面应用架构，基于 Wails v3 框架。

<div align="center">

[![Latest Release](https://img.shields.io/github/v/release/dtapps/certflow?style=flat-square)](https://github.com/dtapps/certflow/releases) [![Downloads](https://img.shields.io/github/downloads/dtapps/certflow/total?style=flat-square)](https://github.com/dtapps/certflow/releases) [![Stars](https://img.shields.io/github/stars/dtapps/certflow?style=flat-square)](https://github.com/dtapps/certflow/stargazers) [![Forks](https://img.shields.io/github/forks/dtapps/certflow?style=flat-square)](https://github.com/dtapps/certflow/network/members) [![License](https://img.shields.io/github/license/dtapps/certflow?style=flat-square)](LICENSE) [![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-007EC6?style=flat-square)](https://github.com/dtapps/certflow) [![Build](https://img.shields.io/github/actions/workflow/status/dtapps/certflow/push.yml?style=flat-square)](https://github.com/dtapps/certflow/actions/workflows/push.yml) [![Codecov](https://img.shields.io/codecov/c/github/dtapps/certflow?style=flat-square&label=Codecov&logo=codecov)](https://codecov.io/gh/dtapps/certflow) [![Coveralls](https://img.shields.io/coveralls/github/dtapps/certflow?style=flat-square&label=Coveralls&logo=coveralls)](https://coveralls.io/github/dtapps/certflow) ![下载请求数](https://img.shields.io/endpoint?label=下载请求数&url=https%3A%2F%2Fdl-stats.dtapp.top%2Fshields.json%3Fplatform%3Dgithub.com%26repository%3D%2Fdtapps%2Fcertflow)

[![CNB Release](https://cnb.cool/dtapp/certflow/-/badge/release)](https://cnb.cool/dtapp/certflow/-/badge/release.link) [![CNB Stars](https://cnb.cool/dtapp/certflow/-/badge/star)](https://cnb.cool/dtapp/certflow) [![CNB Forks](https://cnb.cool/dtapp/certflow/-/badge/fork)](https://cnb.cool/dtapp/certflow) [![CNB Build](https://cnb.cool/dtapp/certflow/-/badge/git/latest/ci/status/push)](https://cnb.cool/dtapp/certflow) [![CNB Coverage](https://cnb.cool/dtapp/certflow/-/badge/git/latest/testing/unit/coverage)](https://cnb.cool/dtapp/certflow/-/insights/unit-test) [![CNB PR Coverage](https://cnb.cool/dtapp/certflow/-/badge/git/latest/testing/unit/coverage-pr)](https://cnb.cool/dtapp/certflow/-/insights/unit-test) ![下载请求数](https://img.shields.io/endpoint?label=下载请求数&url=https%3A%2F%2Fdl-stats.dtapp.net%2Fshields.json%3Fplatform%3Dcnb.cool%26repository%3D%2Fdtapp%2Fcertflow)

[![CNB Vulnerability](https://cnb.cool/dtapp/certflow/-/badge/security/vulnerability/full/latest)](https://cnb.cool/dtapp/certflow/-/badge/security/vulnerability/full/latest.link) [![CNB Vulnerability Diff](https://cnb.cool/dtapp/certflow/-/badge/security/vulnerability/diff/latest)](https://cnb.cool/dtapp/certflow/-/badge/security/vulnerability/diff/latest.link) [![CNB License](https://cnb.cool/dtapp/certflow/-/badge/security/license/full/latest)](https://cnb.cool/dtapp/certflow/-/badge/security/license/full/latest.link) [![CNB License Diff](https://cnb.cool/dtapp/certflow/-/badge/security/license/diff/latest)](https://cnb.cool/dtapp/certflow/-/badge/security/license/diff/latest.link) [![CNB SBOM](https://cnb.cool/dtapp/certflow/-/badge/security/sbom/full/latest)](https://cnb.cool/dtapp/certflow/-/badge/security/sbom/full/latest.link) [![CNB SBOM Diff](https://cnb.cool/dtapp/certflow/-/badge/security/sbom/diff/latest)](https://cnb.cool/dtapp/certflow/-/badge/security/sbom/diff/latest.link)

</div>

## 功能特性

- **证书管理** — 申请、续期、撤销 SSL 证书，支持 30+ DNS 提供商自动验证
- **证书部署** — 一键将证书部署到云厂商 CDN / WAF / 负载均衡 / 边缘加速等，支持阿里云、腾讯云、华为云、百度云、天翼云、火山引擎，以及宝塔 / 1Panel / aaPanel / AcePanel / 雷池等面板与 WAF
- **域名监控** — HTTPS/HTTP 健康检查，证书过期预警
- **自动续期** — 定时任务自动续期即将过期的证书
- **证书扫描** — 扫描并归集证书，统一查看有效期与到期预警
- **账户与安全** — 登录认证、TOTP 双因素（2FA）、Passkey / 生物识别（Touch ID、Windows Hello）
- **应用内更新** — 启动后自动检查并安装新版本（基于 GitHub Release 校验和）
- **系统托盘** — 后台常驻，菜单快速操作（检查更新、申请证书、退出）
- **多平台** — 支持 macOS、Windows、Linux

## 截图

<div align="center">
  <img src="image/dashboard.jpg" width="80%" alt="仪表盘">
  <br>
  <img src="image/settings.jpg" width="80%" alt="设置" style="margin-top: 16px;">
  <br>
  <img src="image/login.jpg" width="80%" alt="登录" style="margin-top: 16px;">
  <br>
  <img src="image/personal_center.jpg" width="80%" alt="个人中心" style="margin-top: 16px;">
</div>

## 快速开始

```bash
# 安装依赖
make deps

# 启动开发模式
make dev

# 构建生产包（带版本号）
make build VERSION=1.0.0

# 打包 macOS 应用
make package VERSION=1.0.0
```

## 开发命令

```bash
make help              # 查看所有命令
make lint-go           # Go 代码检查（golangci-lint）
make lint-go-fix       # Go 代码检查（自动修复）
make check             # 检查 + 单测 + 模糊测试 + 漏洞检查
make test-go           # Go 后端测试（go test -vet=off ./internal/...）
make bindings          # 生成 Wails TypeScript 绑定
make ent               # 生成 Ent ORM 代码
make sqlc              # 生成 sqlc 代码（internal/httplog）
make format            # 格式化所有代码（Go + Vue/TS + JSON/YAML/Markdown）
make format-go-fmt     # 格式化 Go 代码（gofmt）
make format-frontend-write # 格式化前端代码（Prettier）
```

## 技术栈

- **后端**：Go 1.27 + Wails v3 + Ent ORM + lego v5（ACME）+ SQLite；认证使用 go-webauthn + pquerna/otp（2FA）；证书部署对接阿里云 / 腾讯云 / 华为云 / 百度云 / 天翼云 / 火山引擎云 SDK
- **前端**：Vue 3 + TypeScript + Vite 8 + Tailwind CSS v4 + Naive UI v2 + Pinia

## 仓库

| 平台    | 地址                               |
|---------|------------------------------------|
| CNB     | https://cnb.cool/dtapp/certflow    |
| GitHub  | https://github.com/dtapps/certflow |
| Gitea   | https://gitea.com/dtapps/certflow  |
| GitLab  | https://gitlab.com/dtapps/certflow |
| Gitee   | https://gitee.com/dtapps/certflow  |
| GitCode | https://gitcode.com/dtapp/certflow |

## 发布

- **正式发布**：在 GitHub Actions 的 Release 工作流中手动输入版本号，六个平台并行构建并发布 GitHub Release
- **预发布**：同一工作流勾选 `prerelease`（CNB 侧传 `pre_release=true`）即发布为预发布版本，不再单独跑每日构建
- **发布平台**：只有 GitHub / CNB / GitLab / Gitee 四个平台发布版本，其他平台不发布
- **镜像同步**：发布成功后自动同步到 CNB / GitLab；Gitee 通过 webhook 触发 `.workflow/release.yml`（需配置 `GITEE_WEBHOOK_URL` / `GITEE_TOKEN`，未配置时手动执行）

## 开发文档

详见 [DEVELOPMENT.md](DEVELOPMENT.md)；CI / 覆盖率 / 发布同步 / 交接记录等专题见 [`docs/`](docs/)；参与开发见 [CONTRIBUTING.md](CONTRIBUTING.md)，安全报告见 [SECURITY.md](SECURITY.md)，版本变更见 [CHANGELOG.md](CHANGELOG.md)。

## 许可

详见仓库 `LICENSE` 文件。

## 致谢

<a href="https://wails.io">
  <img src="https://wails.io/img/wails-button-light.svg" width="90" height="24" alt="Built with Wails">
</a>