# 🚀 快速启动指南

## 方式一：一键安装（推荐）

```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
```

---

有问题随时找小弟！👋