Spark与Apache协同配置及VPS上Spark Web API绑定失败求助

一、解决"failed to bind address"绑定失败问题 #

1. 检查端口占用情况 #

用以下命令查看目标端口是否被其他进程占用：

ss -tulpn | grep <你的API端口>

如果输出有结果，说明端口被占用，要么更换端口，要么停止占用该端口的进程。

2. 修改Spark监听地址 #

不要直接绑定VPS的公网IP，改为监听所有网络接口：
在你的代码中添加一行：

Spark.ipAddress("0.0.0.0"); // 监听所有可用网卡地址
Spark.port(Config.getInt("api_port")); // 原端口配置

直接绑定公网IP可能受系统网络配置限制失败，0.0.0.0会让Spark监听服务器上的所有IP，包括公网IP和本地回环地址。

3. 开放防火墙与安全组 #

• OVH后台安全组：登录OVH管理面板，找到你的VPS，在"安全组"或"防火墙"设置中，添加允许入站的规则，开放你的API端口（TCP协议，端口号填你的api_port）。
• VPS内部防火墙：如果使用ufw，执行以下命令开放端口：

ufw allow <你的API端口>/tcp
ufw reload

4. 检查Pterodactyl端口权限 #

在Pterodactyl面板中，找到你的Minecraft服务器，进入"设置"->"端口配置"，确认你的API端口已添加到允许的端口列表中，否则面板会阻止进程绑定该端口。

二、Spark与Apache协同工作（反向代理方案） #

通过Apache反向代理，让Apache处理外部请求并转发到Spark服务，可使用默认的80/443端口，同时利用Apache的SSL、静态资源托管等功能。

1. 启用Apache必要模块 #

执行命令启用反向代理相关模块：

a2enmod proxy proxy_http
systemctl restart apache2

2. 配置Apache反向代理规则 #

创建或修改Apache站点配置文件（比如/etc/apache2/sites-available/api-proxy.conf）：

<VirtualHost *:80>
    # 填写你的域名或VPS公网IP
    ServerName 151.80.XXX.XXX

    # 将/api路径的请求转发到Spark服务
    ProxyPass /api http://localhost:<你的Spark端口>
    ProxyPassReverse /api http://localhost:<你的Spark端口>

    # 可选：若Spark未配置CORS，可在此补充（已配置则无需重复）
    Header set Access-Control-Allow-Origin "*"
    Header set Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS"
</VirtualHost>

3. 启用配置并重启Apache #

a2ensite api-proxy.conf
systemctl restart apache2

之后你就可以通过http://151.80.XXX.XXX/api/infos访问你的Spark API接口了。

内容的提问来源于stack exchange，提问作者Kenda