chore: docs

docs/guide/contact/index.md

@@ -0,0 +1,20 @@
+# 联系我们
+
+## 1. 交流群
+如有疑问，欢迎加入群聊（请备注certd）
+###  QQ群：141236433    
+<p align="center">
+<img height="230" src="./images/qq.png">
+</p>
+
+
+### 微信群： 
+<p align="center">
+<img height="230" src="./images/wx.png">
+</p>
+
+
+## 2. 加作者好友
+<p align="center">
+<img height="230" src="./images/me.png">
+</p>

docs/guide/development/index.md

@@ -0,0 +1,96 @@
+# 本地开发
+欢迎贡献插件
+
+## 1.本地调试运行
+
+### 克隆代码
+```shell
+
+# 克隆代码
+git clone https://github.com/certd/certd
+
+#进入项目目录
+cd certd
+
+# 切换到最新版本代码
+git checkout v1.26.7  # 这里换成最新版本号
+
+```
+
+### 修改pnpm-workspace.yaml文件
+重要：否则无法正确加载专业版的access和plugin
+```yaml
+# pnpm-workspace.yaml
+packages:
+   - 'packages/**'  # <--------------注释掉这一行，PR时不要提交此修改
+   - 'packages/ui/**'
+```
+
+### 安装依赖和初始化:
+```shell
+# 安装pnpm，如果提示npm命令不存在，就需要先安装nodejs
+npm install -g pnpm@8.15.7 --registry=https://registry.npmmirror.com
+
+# 使用国内镜像源，如果有代理，就不需要
+pnpm config set registry https://registry.npmmirror.com
+# 安装依赖
+pnpm install
+
+# 初始化构建
+npm run init
+```
+
+### 启动 server:
+```shell
+cd packages/ui/certd-server
+npm run dev
+```
+
+### 启动 client:
+```shell
+cd packages/ui/certd-client
+npm run dev
+
+# 会自动打开浏览器，确认正常运行
+
+```
+
+## 开发插件
+进入 `packages/ui/certd-server/src/plugins`
+
+### 1.复制`plugin-demo`目录作为你的插件目录
+比如你想做`cloudflare`的插件，那么你可以复制`plugin-demo`目录，将其命名成`plugin-cloudflare`。   
+以下均以`plugin-cloudflare`为例进行说明，你需要将其替换成你的插件名称
+
+### 2. access授权
+如果这是一个新的平台，它应该有授权方式，比如accessKey accessSecret之类的     
+参考`plugin-cloudflare/access.ts` 修改为你要做的平台的`access`
+这样用户就可以在`certd`后台中创建这种授权凭证了
+
+### 3. dns-provider
+如果域名是这个平台进行解析的，那么你需要实现dns-provider，（申请证书需要）    
+参考`plugin-cloudflare/dns-provider.ts` 修改为你要做的平台的`dns-provider`
+
+### 4. plugin-deploy
+如果这个平台有需要部署证书的地方     
+参考`plugin-cloudflare/plugins/plugin-deploy-to-xx.ts` 修改为你要做的平台的`plugin-deploy-to-xx`
+
+### 5. 增加导入
+在`plugin-cloudflare/index.ts`中增加你的插件的`import`
+```ts
+export * from './dns-provider'
+export * from './access'
+export * from './plugins/plugin-deploy-to-xx'
+````
+
+在`./src/plugins/index.ts`中增加`import`
+
+```ts
+export * from "./plugin-cloudflare.js"
+```
+
+## 重启服务进行调试
+刷新浏览器，检查你的插件是否工作正常， 确保能够正常进行证书申请和部署
+
+## 提交PR
+我们将尽快审核PR

docs/guide/donate/index.md

@@ -0,0 +1,22 @@
+# 捐赠
+************************
+支持开源，为爱发电，我已入驻爱发电   
+https://afdian.com/a/greper
+
+## 发电权益：
+1. 可加入发电专属群，可以获得作者一对一技术支持
+2. 您的需求我们将优先实现，并且将作为专业版功能提供
+3. 一年期专业版激活码
+4. 赠送国外免费服务器部署方案（0成本使用Certd，可能需要翻墙，不过现在性能越来越差了）
+
+
+## 专业版特权对比
+
+| 功能      | 免费版                    | 专业版                   |
+|---------|------------------------|-----------------------|
+| 免费证书申请  | 免费无限制                  | 免费无限制                 |
+| 自动部署插件  | 阿里云CDN、腾讯云、七牛CDN、主机部署等 | 支持群晖、宝塔、1Panel等，持续开发中 |
+| 发邮件功能   | 需要配置                   | 免配置                   |
+| 证书流水线条数 | 10条                    | 无限制                   |
+
+************************

docs/guide/index.md

@@ -1,6 +1,6 @@
 # Certd
 
-Certd 是一个免费全自动申请和自动部署更新SSL证书的工具。       
+Certd 是一款开源、免费、全自动申请和部署更新SSL证书的工具。       
 后缀d取自linux守护进程的命名风格，意为证书守护进程。
 
 关键字：证书自动申请、证书自动更新、证书自动续期、证书自动续签、证书管理工具
@@ -17,4 +17,14 @@ Certd 是一个免费全自动申请和自动部署更新SSL证书的工具。
 * 支持sqlite，postgresql数据库
 
 
+## 二、一些说明
+* 本项目申请证书过程遵循acme协议
+* 需要验证域名所有权，一般有两种方式
+    * http-01： 在网站根目录下放置一份txt文件
+    * dns-01： 需要给域名添加txt解析记录，通配符域名只能用这种方式（本项目仅支持dns-01）
+* 证书续期：
+    * 实际上没有办法不改变证书文件本身情况下直接续期或者续签。
+    * 我们所说的续期，其实就是按照全套流程重新申请一份新证书，然后重新部署上去。
+* 免费证书过期时间90天，以后可能还会缩短，所以自动化部署必不可少
+* 设置每天自动运行，当证书过期前20天，会自动重新申请证书并部署
 

docs/guide/license/index.md

@@ -0,0 +1,6 @@
+# 开源协议
+
+* 本项目遵循 GNU Affero General Public License（AGPL）开源协议。
+* 允许个人和公司使用、复制、修改和分发本项目，禁止任何形式的商业用途
+* 未获得商业授权情况下，禁止任何对logo、版权信息及授权许可相关代码的修改。
+* 如需商业授权，请联系作者。

docs/guide/link/index.md

@@ -0,0 +1,7 @@
+# 我的其他项目
+
+| 项目名称                                                    | stars                                                                                                 | 项目描述                              | 
+|---------------------------------------------------------|-------------------------------------------------------------------------------------------------------|-----------------------------------|
+| [袖手AI](https://ai.handsfree.work/)                    |                                                                                                       | 袖手GPT，国内可用，无需FQ，每日免费额度            | 
+| [fast-crud](https://gitee.com/fast-crud/fast-crud/)     | <img alt="GitHub stars" src="https://img.shields.io/github/stars/fast-crud/fast-crud?logo=github"/>   | 基于vue3的crud快速开发框架                 |  
+| [dev-sidecar](https://github.com/docmirror/dev-sidecar/) | <img alt="GitHub stars" src="https://img.shields.io/github/stars/docmirror/dev-sidecar?logo=github"/> | 直连访问github工具，无需FQ，解决github无法访问的问题 |                       

docs/guide/use/host/windows.md

@@ -3,22 +3,22 @@
 远程主机基于ssh协议，通过ssh连接远程主机，执行命令。
 
 ## windows开启OpenSSH Server
-1. 安装OpenSSH Server
-请前往Microsoft官方文档查看如何开启openSSH
+### 1. 安装OpenSSH Server    
+请前往Microsoft官方文档查看如何开启openSSH    
 https://learn.microsoft.com/zh-cn/windows-server/administration/openssh/openssh_install_firstuse?tabs=gui#install-openssh-for-windows
 
-2. 启动OpenSSH Server服务
+### 2. 启动OpenSSH Server服务
 ```
 win+R  弹出运行对话框，输入 services.msc 打开服务管理器
 找到 OpenSSH SSH Server 
 启动ssh server服务，并且设置为自动启动
 ```
 
-3. 测试ssh登录
+### 3. 测试ssh登录
 使用你常用的ssh客户端，连接你的windows主机，进行测试 
 
 ```cmd
 # 如何确定你用户名
-C:\Users\xiaoj>
+C:\Users\xxxxx>
           ↑↑↑↑---------这个就是windows ssh的登录用户名
 ```