Derby数据库服务器IP是什么，在哪查看？

Derby数据库没有固定的服务器IP，它的IP地址由运行Derby的JVM进程所在的主机决定，在嵌入式模式下IP就是本机（localhost），在网络服务器模式下IP则是你启动服务时绑定的那个网卡地址。

很多初次接触Derby的朋友都会在配置文件里找“IP地址”这个字段，结果翻半天找不到，心里直犯嘀咕，别着急，这个问题其实恰恰说明了Derby与传统数据库（如MySQL、Oracle）在架构上的根本不同。

Derby数据库的IP到底藏在哪里

Derby是纯Java编写的嵌入式数据库，它的核心设计理念是“随应用启动，随应用停止”，它本身不作为一个独立的常驻服务存在,而是像一个零件一样嵌入你的Java应用程序中。

它的IP地址和端口号并不是写在Derby自己的配置文件里，而是取决于你用什么方式启动它。

嵌入式模式下的IP：永远是localhost

这是Derby最常用的工作模式，你的Java程序通过JDBC驱动直接加载Derby引擎,数据和日志文件就写在本地磁盘目录中。

这种模式下，其他机器上的应用根本无法通过网络访问这个数据库，所谓“IP”，实际上就是运行当前Java程序的那台机器的回环地址，也就是0.0.1或者localhost。

• 连接URL示例：jdbc:derby:/data/mydb（不需要IP和端口）
• 适用场景：单机桌面软件、内嵌在Web应用内部作为缓存库

网络服务器模式下的IP：绑定的是本机网卡

如果你想让其他电脑或进程通过网络访问Derby，就需要启动它的网络服务器（Network Server），这时,Derby会像其他数据库一样监听一个TCP端口。

但这个IP地址不是Derby“自带”的，而是由你启动命令中的参数决定的。

• 如果你指定 -h 0.0.0.0，表示监听本机所有网卡IP，局域网内其他机器可以通过你的机器实际局域网IP（如192.168.1.100）访问。
• 如果你指定 -h 127.0.0.1,那么只有本机自己能访问。

关键点来了，很多人在这个环节踩坑： 你明明启动了Derby网络服务，但同事在另一台电脑上却连不上，这是为什么？因为你启动时用的是默认host参数，而Derby网络服务器的默认host是localhost，也就是说，默认情况下它只监听回环地址,根本不允许外部IP连接。

如何查看并指定Derby网络服务器的IP：实操命令

知道了原理，操作起来就简单了，我整理了三种最常用的办法，帮你弄清楚当前Derby的IP情况,或者按照你的需求去主动指定它。

通过启动命令指定监听IP

如果你想让Derby服务于整个局域网，启动时必须显式指定-h参数。

# 监听所有网卡，允许任何IP连接（生产环境慎用）
java -jar derbyrun.jar server start -h 0.0.0.0
# 监听指定IP，比如你机器的内网IP是192.168.31.88
java -jar derbyrun.jar server start -h 192.168.31.88
# 只允许本机连接（默认也是这个，但写明更清晰）
java -jar derbyrun.jar server start -h localhost

特别提醒： 如果你修改了PC的IP地址，比如今天在公司连的是192.168.31.88，明天换了Wi-Fi变成192.168.31.105，那么之前指定的那个IP监听就会失效，你需要重新绑定新IP并重启Derby服务，这个细节在排查Derby数据库连接失败的原因时经常被忽略。

用系统命令查看Derby当前占用的IP

如果已经有人启动了Derby网络服务,你只需要查看本机端口监听状态就能知道它绑定的IP。

在Windows命令行或Linux终端执行：

# Windows
netstat -ano | findstr 1527
# Linux
netstat -anp | grep 1527

看到输出结果中监听地址那一列：

• 显示 0.0.1:1527，说明服务只对本机开放,外部无法连接。
• 显示 0.0.0:1527，说明监听所有网卡,此时你可以通过本机任何一个有效IP访问。
• 显示 168.x.x:1527,说明只监听该网卡IP。

在Java配置文件中动态获取IP

在实际开发中，如果你的应用部署在云服务器上，IP可能是动态分配的，更聪明的做法是在Java代码中动态获取本机IP并拼接JDBC URL,而不是硬编码。

// 获取服务器实际IP（示例逻辑，生产环境需处理多网卡场景）
InetAddress addr = InetAddress.getLocalHost();
String serverIP = addr.getHostAddress();
// 拼接连接串给客户端
String jdbcUrl = "jdbc:derby://" + serverIP + ":1527/mydb;create=true";

搞懂Derby的默认端口与防火墙设置

说完IP，必须提一下它的搭档端口。

Derby网络服务器默认监听1527端口，这个端口和IP是绑定的关系，客户端连接时两者缺一不可，很多用户遇到的Derby数据库连接失败原因，往往不是IP配置错,而是防火墙拦截了1527端口。

配置防火墙放行1527端口

即使Derby的IP监听设置正确,Windows或Linux防火墙也会阻止外部机器访问。

• Windows系统： 控制面板 -> Windows Defender防火墙 -> 高级设置 -> 入站规则 -> 新建规则 -> 选择“端口” -> 输入1527 -> 允许连接。
• Linux系统（CentOS为例）：

  firewall-cmd --zone=public --add-port=1527/tcp --permanent
  firewall-cmd --reload

如果你是在云服务器上部署（比如简米云或酷番云），还需要在云控制台的安全组里，添加一条入方向规则，放行TCP 1527端口,并在来源里填上允许访问的IP网段。

为什么你连不上Derby：场景化排查清单

我见过不少朋友发出灵魂拷问：“明明我IP写对了，端口也放行了，为什么还是连接超时？”下面这张排查清单或许能帮上忙。

特别提醒： 如果你用了Spring Boot等框架，连接Derby时的driverClassName要填对，对于网络服务器模式，通常是org.apache.derby.jdbc.ClientDriver，而嵌入式模式则是org.apache.derby.jdbc.EmbeddedDriver，驱动选错,也会导致连接串无法解析。

Derby数据库服务器IP在不同使用场景下的思考

了解IP的绑定逻辑,最终是为了选对架构。

项目开发环境：用localhost就好

如果你只是在个人电脑上做Java开发测试，或者写个小工具，强烈建议使用嵌入式模式，根本不用关心IP和端口，省去配置防火墙的麻烦，数据文件跟随项目走，迁移复制非常方便。

小型局域网应用：指定网卡IP更安全

如果要在团队成员之间共享数据，需要启动网络服务器，与其用0.0.0裸奔，不如绑定具体的网卡IP，比如-h 10.23.45.67，这样即使服务器有多个网卡（比如一个连着内网，一个连着外网），也只有指定网卡上的流量能访问数据库,降低了被外部攻击的风险。

云端部署：IP自然绑定到公网或私有IP

在云服务器上，Derby的IP自然就是云主机分配到的私有IP，但在云环境里，内网IP和公网IP是隔离的，客户端在公网访问时，需要做端口映射或使用云平台的NAT网关,将公网IP的1527端口转发到服务器私有IP的1527端口上。

关于Derby数据库连接配置的常见疑问

为什么网上的教程让我用`jdbc:derby://localhost:1527/`连接，但我改了IP反而连不上了？

因为Derby服务器默认绑定的是localhost，你改了客户端IP地址，但服务端还在只监听本机，请先确认服务端启动时是否加了-h参数，并且这个参数允许你客户端IP所在的网段访问，服务端绑定-h 0.0.0.0，客户端填168.x.x才能通。

我在URL中写`jdbc:derby://192.168.1.5:1527/mydb`，提示“拒绝连接”，如何判断是IP问题还是端口问题？

最简单的验证方法：在数据库服务器本机，执行telnet 192.168.1.5 1527（Windows需在控制面板开启Telnet客户端功能），如果提示“无法打开到主机的连接”，说明服务端未监听该IP或端口；如果能连接，说明网络通，问题出在客户端连接参数或防火墙过滤规则上，在云服务器上,别忘记检查安全组。

Derby数据库没有约定俗成的固定IP，它像一面镜子，你启动它时绑定的IP，就是它对外展现的IP，搞清楚网络服务器模式下的-h参数含义，以及防火墙对1527端口的放行规则，你就解决了90%的连接困惑，下一次再遇到连接问题，先别急着改代码，用netstat查一下监听地址,答案往往一目了然。