基岩版服务器的IPv6端口修改，核心操作是编辑服务端配置文件中的端口参数，并确保防火墙与路由器正确放行；如果找不到IPv6专属端口项，通常需要单独配置或使用插件实现。很多玩家开服时只关注IPv4端口，遇到IPv6设备连接不上就以为是版本问题，其实问题往往就出在端口设置上,下面我直接按步骤讲清楚。
修改端口前先确认你的服务端类型
官方BDS服务端与第三方服务端区别
官方基岩版专用服务端（BDS） 的配置文件是 server.properties，默认情况下它只有一个 server-port 参数，同时监听IPv4和IPv6，你直接修改这个值，理论上IPv6端口也会跟着变，但注意，部分BDS版本中IPv6连接使用的端口与IPv4是同一个,没有单独的IPv6端口字段。
第三方服务端 如Nukkit、PocketMine-MP、PowerNukkitX等，配置文件通常也是 server.properties，但部分服务端会分离出 server-ipv6-port 或 ipv6-port 参数，比如PowerNukkitX的配置里就有独立的IPv6监听端口选项，所以第一步，打开你的服务端根目录，找到 server.properties 文件，用记事本或Visual Studio Code打开，先搜索关键词port，看看有没有类似 ipv6 字样。
如何准确判断当前监听状态
如果你不确定改哪个参数，可以先不改，直接启动服务端，观察启动日志，在启动信息中会显示类似 IPv6 server listening on [0:0:0:0:0:0:0:0]:19132 的提示，冒号后面的数字就是当前IPv6端口，如果日志里没有出现IPv6监听行，说明你的服务端可能默认不启用IPv6,这时需要额外在配置文件中添加一行：
ipv6-port=19133
不同服务端的参数名略有差异，但规律是包含 ipv6 和 port，添加后重启,再看日志确认。
基岩版IPv6端口修改实操步骤
直接编辑server.properties文件
这是最通用的方法，适合所有能访问服务器文件系统的场景，包括本地开服、VPS和独立服务器。
- 停止正在运行的服务器进程,避免配置被覆盖。
- 定位到服务端安装目录下的
server.properties。 - 使用支持UTF-8编码的编辑器打开（不要用系统自带记事本改，容易乱码）。
- 找到
server-port=行，把后面的数字改成你想用的IPv4端口（如果不想改IPv4，就保持原样）。 - 如果配置里有
ipv6-port=或server-portv6=，直接修改这个值，没有的话，手动新增一行，格式参考：server-portv6=25565注意：端口范围通常是 1-65535，但建议使用1024以上的高端口,避免和系统服务冲突。
- 保存文件,重启服务端。
通过面板或命令行修改
如果你用的是云服务器面板（如宝塔、MCSManager），可以在面板的文件管理里直接编辑 server.properties，路径和服务端目录一致，如果你用命令行,可以执行：
nano /home/minecraft/server.properties或者用vi,修改后记得重启对应服务，
systemctl restart minecraft如果你用的是Docker部署的基岩版服务器,还需要检查端口映射参数，
docker run -p 19132:19132/udp -p 19132:19132/tcpIPv6地址的端口映射通常通过 -p [::]:19132:19132 实现,具体取决于你的Docker网络模式。
修改后必须做的三件事
- 检查服务端日志：确认启动时显示的新端口，是否绑定到地址（IPv6通配地址）而不是仅绑定到
0.0.1。 - 测试本机回环连接：在服务器本机运行基岩版客户端，地址输入
:1加端口号，:1:19133，如果能进,说明服务端监听正常。 - 外网测试IPv6连接：用你的公网IPv6地址加上端口号连接，国内很多家庭宽带已分配IPv6地址，但服务器不一定有公网IPv4,IPv6反而是最稳定的方案。
IPv6端口和IPv4端口到底有什么不同
端口号相同，协议栈不同
很多新手误以为IPv4端口和IPv6端口是俩完全不同的东西，端口号本身就是一个0到65535的数字，无论在IPv4还是IPv6中，19132就是19132,区别在于：
- IPv4使用32位地址,端口映射需要在路由器上设置NAT转发。
- IPv6地址足够充裕，公网IP可以直接访问，理论上不需要端口转发，但防火墙必须放行。
基岩版端口协议默认UDP为主
基岩版联机底层使用的是UDP协议，和Java版的TCP不同，所以你修改端口后，不仅要在服务端配置里改，还要在服务器安全组和系统防火墙中放行对应的UDP端口，如果你改了端口后，玩家显示”无法连接世界”,先检查UDP是否放行。
| 项目 | IPv4 | IPv6 |
|---|---|---|
| 端口格式 | 168.1.2:19132 |
[240e:...]:19132 |
| 是否需要端口转发 | 多数情况下需要 | 多数情况下不需要，但防火墙要放行 |
| 运营商支持 | 普及 | 国内大部分家庭宽带已支持 |
| 基岩版兼容性 | 官方服务端完美支持 | 部分旧版服务端需手动启用 |
国内基岩版服务器IPv6场景细节
在国内开基岩版服务器，如果你用的是简米云、酷番云等云服务器，购买时可能只分配了IPv4公网，这时IPv6端口修改得再多也无效，因为机器根本没有公网IPv6地址，你需要在云控制台申请IPv6地址,并在安全组中单独添加IPv6规则的UDP端口放行。
如果你用的是家庭主机做服务器，且光猫拨号，那可能需要超级管理员账号才能开启IPv6防火墙例外，这种情况建议直接把IPv6端口设置为 19132 以外的常见端口，25565，并使用路由器自带的IPv6防火墙功能放行，临床上没有绝对通用的配置,但大多数OpenWrt和Padavan固件支持单独设置IPv6入站规则。
基岩版服务器端口修改后无法连接怎么办
检查绑定地址和监听范围
服务端配置文件里有 server-ip= 或 bind-ip= 参数，如果这个值填了IPv4地址，那么即使你改了IPv6端口，服务端也不会监听IPv6，正确做法是留空或者填写 （表示监听所有IPv6地址），部分服务端支持 0.0.0 表示所有IPv4地址,但IPv6需要单独写。
使用netstat命令验证端口状态
在服务器上执行：
netstat -ulnp | grep 你的端口输出结果中，如果地址列是 [::]:19132，说明IPv6 UDP监听成功，如果是 0.0.0:19132，说明只监听了IPv4，需要检查配置中的绑定地址,Windows系统可以用：
netstat -an | findstr 19132查看是否有 UDP [::]:19132 类似记录。
客户端侧IPv6地址输入格式
基岩版客户端（手机版、Win10版）在服务器地址栏输入时，IPv6地址需要加方括号再写端口,正确格式：
[2408:8207:xxxx:xxxx::1]:19132不要写成 2408::1:19132，否则会报”无法解析”错误，这是基岩版IPv6端口连不上的常见原因，你可以在手机上关闭WiFi用蜂窝数据测试IPv6通不通,排除局域网问题。
基岩版服务器ipv6端口修改常见问题解答
修改IPv6端口会影响原有IPv4玩家吗
不会，IPv4和IPv6独立监听，除非你把IPv4端口改到被占用的值，如果你只想改动IPv6端口而保留IPv4端口，直接在配置里单独修改 ipv6-port 参数即可，如果服务端不支持独立IPv6端口，可以启动两个实例，分别绑定不同端口，但这样会占用双倍内存,不推荐小服使用。
为什么我的server.properties里没有ipv6端口选项
部分官方BDS版本简化了配置，不单独暴露IPv6端口，而是复用 server-port，这时你只能修改 server-port 来同时改变IPv4和IPv6端口，如果你需要IPv4和IPv6使用不同端口，可以改用支持独立IPv6监听的第三方服务端，如PowerNukkitX，在配置文件中手动添加 ipv6-port 字段。
云服务器安全组如何放行IPv6 UDP端口
登录云厂商控制台，找到实例安全组或防火墙规则，添加一条入方向规则，协议选择UDP，端口填写你修改后的值，源地址填 :/0（表示允许所有IPv6地址访问），注意，简米云、酷番云的安全组有IPv4和IPv6独立规则列表，不要只加了IPv4，IPv6规则需要再添加一次，这是国内基岩版服务器IPv6端口修改中最后一步,也是最容易漏掉的一步。
改端口的本质是让基岩版服务器在正确的IPv6地址上提供游戏服务，确认服务端类型、找到配置参数、改对监听地址、放行防火墙，这四步走完，IPv6端口就能正常对外提供服务，多数场景下，问题不在端口数字本身，而是监听范围和协议放行，对照本文逐项排查,你就能彻底掌握基岩版服务器IPv6端口的修改逻辑。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/723940.html
