故障排查

常见问题

面板无法访问

检查面板服务是否运行
Terminal window
```
sudo systemctl status llstack-panel
```
检查端口是否监听
Terminal window
```
ss -tlnp | grep 30333
```

检查防火墙

sudo firewall-cmd --list-ports
# 确认包含 30333/tcp

检查 SELinux

sudo setsebool -P httpd_can_network_connect 1

站点显示 403 Forbidden

可能的原因：

文件权限不正确 — 确保站点目录所有者是对应的系统用户
文档根目录不存在 — 检查 vhost 配置中的 docRoot 路径
缺少 index 文件 — 确保目录下有 index.html 或 index.php

# 检查文件权限
ls -la /home/user/public_html/example.com/

# 修复权限
sudo chown -R user:user /home/user/public_html/example.com/
sudo chmod -R 755 /home/user/public_html/example.com/

PHP 页面显示空白或 500

检查 PHP 错误日志

tail -f /opt/remi/php83/root/var/log/php-fpm/error.log

检查 LiteHttpd 错误日志
Terminal window
```
tail -f /usr/local/lsws/logs/error.log
```
确认 PHP 版本正确安装
Terminal window
```
/opt/remi/php83/root/usr/bin/php -v
```

SSL 证书签发失败

域名未解析 — 确认域名 A 记录指向服务器 IP
80 端口不通 — Let’s Encrypt 需要通过 80 端口验证
防火墙限制 — 确保 80 端口在安全组中已开放

# 手动测试 acme.sh
/root/.acme.sh/acme.sh --issue -d example.com -w /home/user/public_html/example.com --debug

MariaDB 连接失败

ERROR 1698 (Access denied) — MariaDB 10.11+ 默认使用 unix_socket 认证

ALTER USER 'username'@'localhost' IDENTIFIED VIA mysql_native_password USING PASSWORD('password');

服务未启动

sudo systemctl start mariadb
sudo systemctl status mariadb

WordPress 安装后无法访问

检查 .htaccess 权限

ls -la /home/user/public_html/example.com/.htaccess

确认 PHP handler 映射正确

grep scripthandler /usr/local/lsws/conf/vhosts/example.com/vhconf.conf

重载 LiteHttpd

sudo /usr/local/lsws/bin/lswsctrl reload

日志位置

日志	路径
LiteHttpd 错误日志	`/usr/local/lsws/logs/error.log`
LiteHttpd 访问日志	`/usr/local/lsws/logs/access.log`
面板应用日志	`/opt/llstack/logs/panel.log`
面板审计日志	面板数据库 `audit_logs` 表
PHP 错误日志	`/opt/remi/php{VER}/root/var/log/php-fpm/error.log`
MariaDB 日志	`/var/log/mariadb/mariadb.log`
acme.sh 日志	`/root/.acme.sh/acme.sh.log`

服务重启

# 重启面板
sudo systemctl restart llstack-panel

# 重载 LiteHttpd (不中断连接)
sudo /usr/local/lsws/bin/lswsctrl reload

# 重启 LiteHttpd
sudo /usr/local/lsws/bin/lswsctrl restart

# 重启 MariaDB
sudo systemctl restart mariadb

# 重启 Redis
sudo systemctl restart redis