ssl-manager/SERVICE.md

🔧 SSL Manager 服务管理指南

📋 启动方式

方式一：systemd 服务（推荐，开机自启）

# 启动服务
sudo systemctl start ssl-manager

# 停止服务
sudo systemctl stop ssl-manager

# 重启服务
sudo systemctl restart ssl-manager

# 查看状态
sudo systemctl status ssl-manager

# 开机自启
sudo systemctl enable ssl-manager

# 取消开机自启
sudo systemctl disable ssl-manager

# 查看日志
sudo journalctl -u ssl-manager -f

方式二：启动脚本

cd /root/.openclaw/workspace/ssl-manager

# 启动
./scripts/start-ssl-manager.sh start

# 停止
./scripts/start-ssl-manager.sh stop

# 重启
./scripts/start-ssl-manager.sh restart

# 查看状态
./scripts/start-ssl-manager.sh status

# 查看日志（实时）
./scripts/start-ssl-manager.sh logs

方式三：手动启动（开发调试用）

cd /root/.openclaw/workspace/ssl-manager/backend
node src/index.js

🌐 访问地址

服务启动后访问：http://localhost:3000

📝 日志位置

• systemd 日志: journalctl -u ssl-manager -f
• 应用日志: /var/log/ssl-manager/backend.log

🔍 故障排查

服务启动失败

# 查看 systemd 日志
sudo journalctl -u ssl-manager --since "10 minutes ago"

# 查看应用日志
tail -100 /var/log/ssl-manager/backend.log

# 检查端口占用
netstat -tlnp | grep 3000

# 检查 Node.js
node --version

证书申请失败

# 查看 acme.sh 日志
tail -50 /root/.acme.sh/acme.sh.log

# 手动测试 acme.sh
/root/.acme.sh/acme.sh --issue --dns tencent -d "example.com" --server letsencrypt

重启服务

# 方式 1
sudo systemctl restart ssl-manager

# 方式 2
./scripts/start-ssl-manager.sh restart

📊 服务状态检查清单

• 服务运行中：systemctl status ssl-manager
• 端口监听：netstat -tlnp | grep 3000
• 健康检查：curl http://localhost:3000/api/health
• 日志正常：tail -20 /var/log/ssl-manager/backend.log

🔐 安全建议

1. 防火墙配置

   # 仅允许本地访问（如果需要外网访问，开放 3000 端口）
   sudo ufw allow 3000/tcp
   

2. HTTPS 配置

   • 生产环境建议在前端加一层 nginx 反向代理并配置 HTTPS
   • 使用本工具申请的证书来加密管理界面

3. 定期更新

   # 更新 acme.sh
   /root/.acme.sh/acme.sh --upgrade
   
   # 更新项目代码
   cd /root/.openclaw/workspace/ssl-manager
   git pull  # 如果有版本控制
   

📞 常用命令速查

# 一键重启
sudo systemctl restart ssl-manager

# 查看实时日志
sudo journalctl -u ssl-manager -f

# 检查服务是否正常
curl http://localhost:3000/api/health

# 停止服务
sudo systemctl stop ssl-manager

# 启动服务
sudo systemctl start ssl-manager

---

提示: 推荐使用 systemd 方式，可以开机自启、自动重启、日志统一管理。