root
110 lines
1.9 KiB
Markdown
110 lines
1.9 KiB
Markdown
# 🚀 快速启动指南
|
||
|
||
## 方式一：一键安装（推荐）
|
||
|
||
```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
|
||
```
|
||
|
||
---
|
||
|
||
有问题随时找小弟！👋
|