Skip to content

常见问题

1. GLIBC 版本问题

bash
# 错误信息
./auto-upnp: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found

# 解决方案:使用静态编译
make build-static

2. 无法发现 UPnP 设备

  • 确保路由器支持 UPnP 功能
  • 检查路由器 UPnP 设置是否启用
  • 确认防火墙允许 UPnP 通信
  • 检查网络连接状态

3. 端口映射失败

  • 检查路由器 UPnP 设置
  • 确认端口未被其他服务占用
  • 查看日志获取详细错误信息
  • 检查端口范围配置

4. 服务无法启动

  • 检查配置文件格式是否正确
  • 确认端口范围设置合理
  • 查看系统权限和网络访问权限
  • 检查日志文件获取错误信息

5. Web 界面无法访问

  • 确认管理服务已启用
  • 检查防火墙设置
  • 验证访问地址和端口
  • 确认认证信息正确

6. Web 界面的端口

  • 为了提供对外可访问的端口, 管理端的端口不是显式配置
  • 从 PortRange 中第一个端口开始获取, 如 18000-19000 ,如果18000 可用,管理端口就是18000
  • 可以从日志中获取端口
bash
cat /var/log/auto-upnp.log | grep "启动HTTP管理服务"

基于 MIT 许可证发布