first commit

QUICKSTART.md

@@ -0,0 +1,109 @@
+# 🚀 快速启动指南
+
+## 方式一：一键安装（推荐）
+
+```bash
+cd /root/.openclaw/workspace/ssl-manager
+./install.sh
+```
+
+## 方式二：手动安装
+
+### 1. 安装后端
+
+```bash
+cd backend
+
+# 配置淘宝 npm 镜像（可选，加速下载）
+npm config set registry https://registry.npmmirror.com
+
+npm install
+cp .env.example .env
+# 编辑 .env 配置你的邮箱
+vim .env
+npm start
+```
+
+### 2. 安装前端（开发模式）
+
+```bash
+cd frontend
+
+# 配置淘宝 npm 镜像（可选，加速下载）
+npm config set registry https://registry.npmmirror.com
+
+npm install
+npm run dev
+# 访问 http://localhost:5173
+```
+
+### 3. 生产部署
+
+```bash
+# 构建前端
+cd frontend
+
+# 配置淘宝 npm 镜像（可选，加速下载）
+npm config set registry https://registry.npmmirror.com
+
+npm install
+npm run build
+
+# 后端会静态文件，直接访问 http://localhost:3000
+```
+
+## 📋 首次使用
+
+1. **访问管理界面** - http://localhost:3000
+2. **配置 DNS 凭证**（如使用 DNS-01）- 设置 → DNS API 凭证管理
+3. **申请证书** - 申请证书 → 填写域名 → 选择验证方式 → 提交
+4. **配置自动续期** - 执行以下命令：
+
+```bash
+chmod +x scripts/auto-renew.sh
+crontab -e
+# 添加：0 0 * * * /root/.openclaw/workspace/ssl-manager/scripts/auto-renew.sh
+```
+
+## 🔍 验证安装
+
+```bash
+# 检查后端服务
+curl http://localhost:3000/api/health
+
+# 检查 acme.sh
+~/.acme.sh/acme.sh --version
+
+# 查看证书列表
+~/.acme.sh/acme.sh --list
+```
+
+## 🆘 故障排查
+
+### 后端启动失败
+```bash
+cd backend
+npm install  # 确保依赖已安装
+node src/index.js  # 查看详细错误
+```
+
+### 前端构建失败
+```bash
+cd frontend
+rm -rf node_modules package-lock.json
+npm install
+npm run build
+```
+
+### acme.sh 安装失败
+```bash
+# 使用 Gitee 镜像手动安装
+git clone https://gitee.com/Neilpang/acme.sh.git ~/.acme.sh
+cd ~/.acme.sh
+./acme.sh --install
+source ~/.bashrc
+```
+
+---
+
+有问题随时找小弟！👋