遇到问题如何排查？

当 SSLcat 出现问题时，可以通过以下步骤进行系统性的故障排除。

1. 检查服务状态

首先确认 SSLcat 服务是否正常运行：

# 检查进程状态
ps aux | grep sslcat

# 检查端口监听
netstat -tlnp | grep :443
netstat -tlnp | grep :80

# 检查服务状态 (systemd)
systemctl status sslcat

# 检查服务日志
journalctl -u sslcat -f

2. 检查配置文件

验证配置文件是否正确：

# 检查配置文件语法
sslcat --config sslcat.conf --check

# 测试配置文件
sslcat --config sslcat.conf --test

# 查看配置详情
sslcat --config sslcat.conf --show-config

3. 检查网络连接

确认网络连接正常：

# 检查域名解析
nslookup your-domain.com
dig your-domain.com

# 检查端口连通性
telnet your-domain.com 443
telnet your-domain.com 80

# 检查防火墙
iptables -L
ufw status

4. 检查 SSL 证书

验证 SSL 证书状态：

# 检查证书文件
ls -la /var/lib/sslcat/certs/

# 验证证书内容
openssl x509 -in /var/lib/sslcat/certs/your-domain.com.crt -text -noout

# 检查证书到期时间
openssl x509 -in /var/lib/sslcat/certs/your-domain.com.crt -dates -noout

# 测试 SSL 连接
openssl s_client -connect your-domain.com:443 -servername your-domain.com

5. 检查日志文件

分析日志文件找出问题：

# 查看应用日志
tail -f /var/log/sslcat/sslcat.log

# 查看访问日志
tail -f /var/log/sslcat/access.log

# 查看错误日志
tail -f /var/log/sslcat/error.log

# 搜索特定错误
grep -i "error" /var/log/sslcat/sslcat.log
grep -i "failed" /var/log/sslcat/sslcat.log

6. 常见问题诊断

常见问题及解决方案：

服务无法启动

• 端口被占用 - 检查端口是否被其他程序占用
• 权限问题 - 检查文件权限和用户权限
• 配置文件错误 - 验证配置文件语法
• 依赖缺失 - 检查系统依赖是否安装

证书申请失败

• 域名解析问题 - 检查域名是否正确解析
• 端口访问问题 - 确保端口 80 和 443 可访问
• Let's Encrypt 限制 - 检查是否达到速率限制
• 网络连接问题 - 检查服务器网络连接

代理不工作

• 后端服务问题 - 检查后端服务是否正常运行
• 配置错误 - 验证转发配置是否正确
• 网络连接 - 检查到后端的网络连接
• 负载均衡问题 - 检查负载均衡配置

7. 性能问题排查

性能问题的诊断方法：

# 检查系统资源
top
htop
free -h
df -h

# 检查网络连接数
ss -tuln | grep :443
netstat -an | grep :443 | wc -l

# 检查内存使用
cat /proc/meminfo
ps aux --sort=-%mem | head

# 检查磁盘 I/O
iostat -x 1
iotop

8. 安全问题排查

安全相关问题的检查：

# 检查防火墙规则
iptables -L -n
ufw status verbose

# 检查访问日志
grep -i "blocked" /var/log/sslcat/access.log
grep -i "banned" /var/log/sslcat/access.log

# 检查安全事件
grep -i "security" /var/log/sslcat/sslcat.log
grep -i "attack" /var/log/sslcat/sslcat.log

9. 调试模式

启用调试模式获取详细信息：

# 启用调试模式
sslcat --config sslcat.conf --debug

# 设置日志级别
sslcat --config sslcat.conf --log-level debug

# 启用详细输出
sslcat --config sslcat.conf --verbose

10. 获取帮助

如果问题仍然无法解决：

• 查看文档 - 阅读官方文档和 FAQ
• 社区支持 - 在 GitHub Issues 中搜索类似问题
• 提交问题 - 在 GitHub 上提交详细的问题报告
• 日志收集 - 收集相关日志信息

问题报告模板

提交问题时请包含以下信息：

• 系统信息 - 操作系统版本、架构
• SSLcat 版本 - 使用的 SSLcat 版本
• 配置文件 - 相关的配置文件内容
• 错误日志 - 完整的错误日志
• 复现步骤 - 详细的问题复现步骤

通过系统性的故障排除，大多数问题都能得到有效解决。