跳到主要内容

🚨 启动失败/无法访问怎么办?

故障诊断与解决

当 AikanPro 启动失败或无法通过浏览器访问时,按照以下步骤进行排查和解决

🔍

快速诊断

使用命令行工具快速检测服务状态和网络连通性

🛡️

防火墙检查

确认防火墙和安全组设置是否正确开放端口

⚙️

环境检查

验证 Java 环境和端口配置是否正确

🔍 快速诊断

🩺 服务状态检测

💻 本地连接测试

在服务器上执行以下命令,检查 AikanPro 是否正常启动:

服务器本地测试
curl http://127.0.0.1:8080

启动失败

返回信息:curl: (7) Failed connect to 127.0.0.1:8080; Connection refused

解决方案: 服务未启动成功,需要检查启动日志和配置文件

启动成功

返回信息:<!DOCTYPE html> <html lang="zh-CN">……

说明: 服务正常运行,如果外网无法访问,则是防火墙/安全组问题

🌐 外网访问测试

如果本地测试正常,但外网无法访问 http://your-server-ip:8080,则需要检查网络配置。

⚠️ 常见原因:防火墙未开放端口、云服务器安全组未配置、端口被占用

端口被占用

请自行检查 AikanPro 启动端口是否被占用,如您没修改过端口,则 AikanPro 默认占用 8080 端口,所以检查 8080 端口是否被占用即可。

jdk 版本错误

如您安装的是捐赠版,可跳过此步骤排查,因为捐赠版内置了 Java 环境,社区版/开源版的话需要检查 JDK 是否安装正确,AikanPro 仅支持运行在 jdk 1.8 版本下,请执行命令 java -version 命令,查看 jdk 版本,包含类似以下字样才是 jdk 安装正确.

openjdk version "1.8.0_292"
OpenJDK Runtime Environment (build 1.8.0_292-b10)
OpenJDK 64-Bit Server VM (build 25.292-b10, mixed mode)

防火墙未开启

可能是防火墙没开启,下面介绍如何防火墙开启端口,对于阿里云、腾讯云、谷歌云等厂商, 可能还需要额外去后台开启防火墙/安全组

CentOS 7.x

firewall-cmd --zone=public --add-port=8080/tcp --permanent # 开放 8080 端口
firewall-cmd --reload # 重启firewall

Ubuntu 16.x / Debian 9.x

iptables -I INPUT -p tcp --dport 8080 -j ACCEPT
iptables-save
sudo apt-get install iptables-persistent
sudo netfilter-persistent save
sudo netfilter-persistent reload

宝塔面板

宝塔面板可以去后台开放端口: