gandalf/secubox-deb

Fork 0

mirror of https://github.com/CyberMind-FR/secubox-deb.git synced 2026-06-29 10:08:36 +00:00

Table of Contents

SecuBox 故障排除

快速诊断
常见问题

无法访问 Web UI
SSH 连接被拒绝
LAN 客户端无法上网
CrowdSec 未阻止攻击
WireGuard 无法连接
CPU/内存占用过高

日志位置
恢复模式

通过串口控制台 (ARM)
通过 GRUB (x86)
恢复出厂设置

网络调试

抓包
检查路由
DNS 问题

获取帮助
另请参阅

SecuBox 故障排除

English | Français

快速诊断

# 系统状态
secubox-status

# 检查所有服务
systemctl status secubox-* --no-pager

# 查看日志
journalctl -u secubox-* -f

# 网络诊断
secubox-netdiag

常见问题

无法访问 Web UI

症状: 浏览器显示连接被拒绝或超时

解决方案:

检查 nginx 是否运行:

systemctl status nginx
systemctl restart nginx

检查防火墙:
```
nft list ruleset | grep 443
```
验证 IP 地址:
```
ip addr show br-lan
```

检查证书:

openssl x509 -in /etc/secubox/tls/cert.pem -text -noout

SSH 连接被拒绝

解决方案:

检查 SSH 服务:
```
systemctl status sshd
```
检查防火墙是否允许 SSH:
```
nft list ruleset | grep 22
```
验证监听端口:
```
ss -tlnp | grep ssh
```

LAN 客户端无法上网

解决方案:

检查 NAT 是否已启用:
```
nft list table inet nat
```
检查 IP 转发:
```
sysctl net.ipv4.ip_forward
```
检查 DHCP 服务器:
```
systemctl status dnsmasq
```
检查 WAN 接口是否有 IP:
```
ip addr show eth0
```

CrowdSec 未阻止攻击

解决方案:

检查 CrowdSec 是否运行:

systemctl status crowdsec
cscli metrics

检查 bouncer:
```
cscli bouncers list
```
检查决策:
```
cscli decisions list
```

WireGuard 无法连接

解决方案:

检查接口是否启用:
```
wg show
```

检查端口是否开放:

ss -ulnp | grep 51820
nft list ruleset | grep 51820

检查密钥是否已配置:
```
cat /etc/wireguard/wg0.conf
```

CPU/内存占用过高

解决方案:

检查资源使用情况:
```
htop
# 或
secubox-glances
```
检查卡死的进程:
```
ps aux --sort=-%cpu | head -10
```

在 ESPRESSObin (低内存设备) 上:

# 如果尚未启用交换分区，请启用
swapon --show
free -h

日志位置

服务	日志位置
系统	`journalctl`
Nginx	`/var/log/nginx/`
HAProxy	`/var/log/haproxy.log`
CrowdSec	`cscli metrics` / `journalctl -u crowdsec`
SecuBox 模块	`journalctl -u secubox-*`
审计	`/var/log/secubox/audit.log`

恢复模式

通过串口控制台 (ARM)

连接串口控制台 (115200 8N1)
启动并中断 U-Boot

启动到单用户模式:

=> setenv bootargs "root=LABEL=rootfs single"
=> boot

通过 GRUB (x86)

在 GRUB 菜单中按 e
在内核行添加 single
按 F10 启动

恢复出厂设置

# 警告: 这将重置所有配置!
secubox-factory-reset

# 或手动执行:
rm -rf /etc/secubox/modules/*
cp /usr/share/secubox/defaults/* /etc/secubox/
systemctl restart secubox-*

网络调试

抓包

# 在 WAN 接口
tcpdump -i eth0 -w /tmp/wan.pcap

# 在 LAN 网桥
tcpdump -i br-lan -w /tmp/lan.pcap

检查路由

ip route show
ip rule show

DNS 问题

# 检查 DNS 解析
dig @127.0.0.1 google.com

# 检查 dnsmasq
systemctl status dnsmasq
cat /etc/resolv.conf

获取帮助

检查日志: journalctl -xe
查看 wiki: Modules 获取模块相关帮助
GitHub Issues: 报告 bug

另请参阅

Configuration — 配置参考
Installation — 安装指南
ARM-Installation — ARM 相关问题
ESPRESSObin — ESPRESSObin 专用指南

SecuBox | FR | DE | 中文 | v2.2.4-pre1

Projet

Soutenir

🔴 BOOT — Démarrer

Multiboot ⭐
Live-USB-VirtualBox run-vbox.sh
Live-USB-QEMU run-qemu.sh
Live-USB | FR | DE | 中文
Installation | FR | DE | 中文
ARM-Installation | FR | DE | 中文
ESPRESSObin | FR | DE | 中文
Eye-Remote 📡
Android-ToolBox 📱 one-tap R3
Browser-Extension 🧩 cartographie
QEMU-ARM64 🖥️

🟢 ROOT — Configuration

Configuration | FR | DE | 中文
Troubleshooting | FR | DE | 中文

🟣 MIND — Modules

Anti-Track 🛡️ bloque · empoisonne · anonymise
ThreatMesh 🛰️ blocklist souveraine (feeds + mesh, sans CAPI) | FR
MODULES-EN 🇬🇧
MODULES-FR 🇫🇷
MODULES-DE 🇩🇪
MODULES-ZH 🇨🇳

🔵 MESH — Référence

API-Reference | FR | DE | 中文
UI-COMPARISON

🟠 WALL — Matériel

🤖 Workflow Agents

Multi-Agent-Worktree — un agent · une issue · une branche

Liens

SecuBox-Deb · Licence : CMSD-1.0 (Source-Disclosed) Contact : CyberMind · Gérald Kerma · Notre-Dame-du-Cruet, Savoie Hardware-Matrix · Acknowledgments · Wiki v2.5.0